Skip to main content
POST
cURL
Совет: текст для замены должен частично пересекаться с исходным текстом, и в идеале тайминг тоже должен совпадать.infill_lyrics: новый фрагмент текста, который вы хотите вставить или заменить.промпт: контекст, то есть объедините исходный текст до и после нового фрагмента.Пример: исходный текст песни выглядит как [Куплет 1]AA [Припев]BB [Куплет 2]CC [Припев]DD [Финал]EE. Если вы хотите заменить CC на OO:
  • Установите infill_lyrics в OO (новый текст для вставки).
  • Установите промпт в BB [Куплет 2]OO[Припев]DD (включите часть исходного текста до и после OO, чтобы сформировать контекст).
Это позволяет модели сгенерировать наилучший результат на основе окружающего контекста в промпт и нового текста в infill_lyrics.

Авторизации

TT-API-KEY
string
header
обязательно

Вы можете получить API-ключ в панель управления TTAPI.

Тело

application/json
music_id
string
обязательно

Идентификатор аудио

infill_start_s
number
обязательно

Время начала замены в секундах

infill_end_s
number
обязательно

Время окончания замены в секундах

mv
enum<string>
по умолчанию:chirp-v5
обязательно

Модель для использования.

Доступные опции:
chirp-v5,
chirp-v4-5+,
chirp-v4-5,
chirp-v4-5-all,
chirp-v4,
chirp-v3-5,
chirp-v3-0
prompt
string

Контекстный текст песни

infill_lyrics
string

Новый текст песни

title
string

Название музыки.

Используется в пользовательском режиме (custom=true). Максимальная длина: 80 символов.

tags
string

Музыкальный стиль или жанр.

Используется в пользовательском режиме (custom=true). Максимальная длина: 1000 символов.

Пример:

"rock, blues, hip-hop, r&b"

negative_tags
string

Музыкальные стили или жанры, которые нужно исключить из генерации.

Используется в пользовательском режиме (custom=true).

isStorage
boolean
по умолчанию:true

Сохранять ли сгенерированный звук.

  • true: аудио будет сохранено и будет возвращено TTAPI CDN URL.
  • false: будет возвращен исходный источник URL.
hookUrl
string

URL обратного уведомления

Ответ

Запрос выполнен успешно

status
string
обязательно
Пример:

"SUCCESS"

message
string
обязательно
Пример:

"success"

data
object
обязательно
Пример:
Последнее изменение 12 июня 2026 г.