Skip to main content
POST
cURL
Create Model is an asynchronous task API.The request does not return model_id immediately. You can get the result in either of these ways:
  • Set hookUrl to receive a callback when the task finishes
  • Or call Fetch V2 to poll the task status and result
If you use hookUrl, make sure the URL is publicly reachable; otherwise the callback may fail.
Custom models are private resources bound to the underlying account used during training:
  • If that account runs out of quota or goes offline, the model becomes unavailable immediately
  • Use the model as soon as it is created. Availability is typically no more than 2 days, and it may expire earlier — a full 2-day window is not guaranteed
  • persona_id and chirp-custom cannot be used together
  • mv must include a full UUID, for example chirp-custom:a1b2c3d4-e5f6-7890-abcd-ef1234567890. Passing chirp-custom alone is invalid
Provide complete songs or clips that share a consistent style, vocal, and arrangement:
  • Recommended formats: MP3 / WAV / M4A
  • Each URL must be a publicly downloadable file, not a login wall, hotlink-protected page, or HTML/JSON error page
  • If any audio file cannot be downloaded or is not valid audio, the entire job fails
Typical training takes several minutes and can last up to about 20 minutes. Timed-out jobs fail with message = job timeout.
After creation, set mv to chirp-custom:{model_id} on generation endpoints to produce songs in that model’s style.
  • Supported: Music, Extend, Cover, Add Vocals / Instrumental / Stem, Replace Section, Mashup, Inspo, Sample
  • Not supported: Remaster, Stems, Lyrics, MIDI export

Authorizations

TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
audio_urls
string[]
required

Publicly accessible direct URLs of reference audio. Length must be 6–24. Each URL must be a downloadable file, not a login wall or HTML page. Recommended formats: MP3 / WAV / M4A.

Required array length: 6 - 24 elements
name
string
required

Model name. Cannot be empty.

hookUrl
string

Callback notification URL

Response

Request successful

status
string
required
Example:

"SUCCESS"

message
string
required
Example:

"success"

data
object
required
Example:
Last modified on September 7, 2026