Jingles

Create a jingle generation request

POST
https://api.tunio.ai/v1/jingles/requests

Queue a jingle for the generator the control panel uses: a voice over a generated music bed (full), music only (instrumental) or voice only (voice). Poll GET /v1/jingles/requests/{request_id} until the state is completed; the jingle is then a file of the caller's library (jingle_id, also listed by GET /v1/jingles) that can be added to bundles. Credits are charged once, only when generation succeeds (ledger type jingle_generation); a failed request costs nothing. Up to 20 requests may be pending or processing per account. Rate limited to 60 calls per minute per account across the jingle request endpoints.

Request body

Jingle parameters

NameTypeDescription
end_pause_secondsinteger
Silence added at the end in seconds, 0..5 (default 0).
generation_typestring
full (voice over a generated music bed, default), instrumental (music only) or voice (voice only).
model_idstring
Voice (model_id from GET /v1/tts/models, including the caller's cloned voices); required for full and voice.
music_durationinteger
Music length in seconds, 5..30; required for instrumental and ignored otherwise.
style_promptstring
Description of the music bed, up to 800 characters; required for full and instrumental, ignored for voice.
textstring
What the voice says, up to 600 characters; required for full and voice, ignored for instrumental.
voice_effectstring
none (default) or telephone; ignored for instrumental.
Request example
01{
02 "end_pause_seconds": 0,
03 "generation_type": "full",
04 "model_id": "string",
05 "music_duration": 10,
06 "style_prompt": "Upbeat pop radio ident, bright synths, 120 BPM",
07 "text": "Tunio radio. Music for your business.",
08 "voice_effect": "none"
09}

Responses

NameTypeDescription
requestobject
The queued jingle request.
audio_urlstring
Always null on create.
completed_atstring
Always null on create.
costinteger
Estimated cost in credits; charged only when generation succeeds.
created_atstring
When the request was accepted.
durationinteger
Always null on create.
end_pause_secondsinteger
Silence added at the end in seconds.
errorstring
Always null on create.
generation_typestring
full, instrumental or voice.
jingle_idstring
Always null on create.
model_idstring
Voice the text is spoken with, null for instrumental.
music_durationinteger
Requested music length in seconds for instrumental jingles.
request_idstring
Request ID.
statestring
Always pending on create.
style_promptstring
Description of the music bed; empty for voice.
textstring
What the voice says; empty for instrumental.
titlestring
Always null on create.
voice_effectstring
none or telephone.
successboolean
Always true.
NameTypeDescription
max_lengthinteger
Maximum length in characters, set with text_too_long (600) and style_prompt_too_long (800).
messagestring
Error code.
successboolean
Always false.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
available_creditsstring
Credits available on the account, as a decimal string.
messagestring
Always insufficient_balance.
music_creditsstring
Credits for the music bed alone, as a decimal string.
music_seconds_billedinteger
Seconds of music bed billed (estimated from the text for full, music_duration for instrumental, 0 for voice).
required_creditsstring
Credits the jingle costs, as a decimal string.
successboolean
Always false.
tts_multiplier_appliedstring
TTS price multiplier applied to the voice part, as a decimal string.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.
NameTypeDescription
max_pendinginteger
Maximum number of pending or processing requests per account, set with too_many_pending_requests.
messagestring
too_many_pending_requests (the account already has max_pending requests pending or processing) or rate_limited (more than 60 calls a minute; see Retry-After).
successboolean
Always false.
NameTypeDescription
messagestring
Error code or human-readable error details.
successboolean
Always false for error payloads.