Skip to main content
POST
cURL
Create Model — асинхронный API.После отправки запроса model_id не возвращается сразу. Результат можно получить так:
  • Укажите hookUrl, чтобы получить уведомление после завершения задачи
  • Или вызовите Fetch V2 и опросите статус и результат
Если вы используете hookUrl, адрес должен быть доступен из публичной сети, иначе callback может не дойти.
Пользовательская модель — приватный ресурс, привязанный к аккаунту, на котором её обучали:
  • Если у этого аккаунта закончится quota или он уйдёт в офлайн, модель сразу станет недоступна
  • Используйте модель сразу после создания. Обычно она доступна не дольше 2 дней и может отключиться раньше — полный срок в 2 дня не гарантируется
  • persona_id и chirp-custom нельзя использовать вместе
  • В mv нужен полный UUID, например chirp-custom:a1b2c3d4-e5f6-7890-abcd-ef1234567890. Одно только значение chirp-custom недействительно
Подбирайте целые песни или фрагменты с близким стилем, вокалом и аранжировкой:
  • Рекомендуемые форматы: MP3 / WAV / M4A
  • Каждый URL должен быть прямой публичной ссылкой на файл, без авторизации, анти-хотлинка и HTML/JSON-страниц с ошибкой
  • Если хотя бы один файл нельзя скачать или это не валидное аудио, вся задача падает
Обучение обычно занимает несколько минут и может длиться до 20 минут. По таймауту задача завершается с message = job timeout.
После создания укажите mv = chirp-custom:{model_id} в генерационных эндпоинтах, чтобы получить песню в стиле этой модели.
  • Поддерживается: генерация музыки, продление, кавер, добавление вокала / инструментала / дорожки, замена фрагмента, мэшап, inspo, сэмпл
  • Не поддерживается: ремастеринг, разделение на дорожки, генерация текста, экспорт MIDI

Авторизации

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

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

Тело

application/json
audio_urls
string[]
обязательно

Публичные прямые URL референсного аудио. Количество должно быть 6–24. Каждый URL должен вести на скачиваемый файл, а не на страницу с авторизацией или HTML. Рекомендуемые форматы: MP3 / WAV / M4A.

Required array length: 6 - 24 elements
name
string
обязательно

Название модели. Не может быть пустым.

hookUrl
string

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

Ответ

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

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

"SUCCESS"

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

"success"

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