{
"error": {
"code": "unauthenticated",
"message": "This API key is not valid. Create a new one in Settings → Team.",
"trace_id": "c3746d5302dc4be6b2e8fa99fa762a8c"
}
}
{
"error": {
"code": "payment_required",
"message": "Insufficient credits: this generation needs 39.6 credits and 12.0 are available.",
"trace_id": "c3746d5302dc4be6b2e8fa99fa762a8c"
}
}
{
"error": {
"code": "forbidden",
"message": "API keys can only call the /v1 API.",
"trace_id": "c3746d5302dc4be6b2e8fa99fa762a8c"
}
}
{
"error": {
"code": "conflict",
"message": "This idempotency key was already used with a different request.",
"trace_id": "c3746d5302dc4be6b2e8fa99fa762a8c"
}
}
Submits a speech or music generation; the model decides which. Returns immediately with status: pending; credits are reserved now and settled when the job finishes. Poll GET /v1/generations/{id} until completed or failed.
POST
/
v1
/
audio
Generate speech or music
curl --request POST \ --url https://api.ekly.ai/v1/audio \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "model": "eleven_multilingual_v2", "text": "Welcome back. Your export is ready.", "voice_name": "Rachel"}'
{
"error": {
"code": "unauthenticated",
"message": "This API key is not valid. Create a new one in Settings → Team.",
"trace_id": "c3746d5302dc4be6b2e8fa99fa762a8c"
}
}
{
"error": {
"code": "payment_required",
"message": "Insufficient credits: this generation needs 39.6 credits and 12.0 are available.",
"trace_id": "c3746d5302dc4be6b2e8fa99fa762a8c"
}
}
{
"error": {
"code": "forbidden",
"message": "API keys can only call the /v1 API.",
"trace_id": "c3746d5302dc4be6b2e8fa99fa762a8c"
}
}
{
"error": {
"code": "conflict",
"message": "This idempotency key was already used with a different request.",
"trace_id": "c3746d5302dc4be6b2e8fa99fa762a8c"
}
}
An organization API key created in Settings → Team, sent as Authorization: Bearer <key>.
Headers
Idempotency-Key
string | null
Reuse the same value when retrying the same request; a repeat returns the original generation without charging again. Reusing it with a different body returns 409.
Maximum string length: 128
Body
application/json
Generate speech or music; the model decides which.
apply_text_normalization
string | null
Text normalization: on/off/auto
bpm
integer | null
Optional BPM override (60-200). If not provided, tempo is used to estimate. (music generation only)
Required range: 60 <= x <= 200
composition_plan
Composition Plan · object | null
ElevenLabs MusicPrompt composition plan. Mutually exclusive with prompt/prompt_tags; section durations control track length.
content_type
string | null
Content type preset name
delivery
string | null
Sustained delivery direction for models with a delivery parameter (Gemini 3.8 TTS): emotion, pace, pitch or tone in a few words, e.g. "whispered, nervous" or "speaking slowly". Applies to every line without its own delivery. Rejected on models that do not declare it.
Maximum string length: 500
duration
integer
default:30
Duration in seconds. Lyria allows 5-30 (validated per-model in the route); ElevenLabs Music allows up to 300. Not used for TTS.
Required range: 3 <= x <= 600
energy
string
default:medium
Energy level: 'low', 'medium', or 'high' (music generation only)
force_instrumental
boolean | null
default:false
Generate instrumental-only music (ElevenLabs Music, prompt mode only)
idempotency_key
string | null
Client-supplied key (≤128 chars); a repeat with the same key returns the original generation without re-charging
Maximum string length: 128
instrumental
boolean | null
Generate instrumental-only music with no vocals (Lyria 3 only). Mutually exclusive with lyrics.
language
string | null
Language for TTS synthesis: Qwen3 uses names such as 'Auto', 'English', 'Chinese'; Gemini uses BCP-47 codes. ElevenLabs auto-detects language and ignores this shared field.
lyrics
string | null
Custom lyrics for vocal generation (Lyria 3 only). Use [Verse], [Chorus], [Bridge] markers. Pro model also supports [MM:SS] timestamps.
What to avoid in the music (Lyria 2 only). Ignored by Lyria RealTime.
next_audio_gen_id
string | null
Generation ID for next audio context
next_context_mode
string | null
default:text
'text' or 'audio'
next_request_ids
string[] | null
ElevenLabs request IDs for next audio. Refused before charging on models that can't use context, such as ElevenLabs v3.
next_text
string | null
Next text context (not spoken). Refused before charging on models that can't use context, such as ElevenLabs v3.
output_format
string | null
ElevenLabs MP3 or WAV output format (e.g. mp3_44100_128, wav_24000)
previous_audio_gen_id
string | null
Generation ID for previous audio context
previous_context_mode
string | null
default:text
'text' or 'audio'
previous_request_ids
string[] | null
ElevenLabs request IDs for previous audio. Refused before charging on models that can't use context, such as ElevenLabs v3.
previous_text
string | null
Previous text context (not spoken). Refused before charging on models that can't use context, such as ElevenLabs v3.
project_id
string | null
Project scope for the generated asset (optional)
prompt
string | null
Free-text music prompt (ElevenLabs Music). Mutually exclusive with composition_plan.
prompt_tags
string[] | null
List of prompt tags describing the desired music (e.g. ['energetic', 'rock', 'guitar']). Required for music generation.
pronunciation_dictionary_ids
string[] | null
Dictionary entry IDs to apply
qwen3_embedding_id
string | null
Qwen3 voice embedding ID (from voice profile clone)
qwen3_model_size
string | null
Qwen3 model size
sample_count
integer | null
Number of variations per API call (Lyria 2 only, 1-4). Mutually exclusive with seed.
Required range: 1 <= x <= 4
seed
integer | null
Random seed for reproducible output (Lyria 2 only). Mutually exclusive with sample_count > 1.
segments
SpeechSegment · object[] | null
Multi-speaker script as an ordered list of {voice_name, text} lines. Mutually exclusive with top-level text. ElevenLabs v3 without stitching context and two-voice Gemini conversations use native dialogue; other requests synthesize turns independently. All return one audio file.
Show child attributes
similarity_boost
number | null
Voice clarity/similarity for ElevenLabs (0.0-1.0). Higher = closer to original voice.
Required range: 0 <= x <= 1
speed
number | null
Speech speed. Per-model range comes from the catalog.
Required range: 0.7 <= x <= 1.3
stability
number | null
Voice stability for ElevenLabs (0.0-1.0). Higher = more consistent, lower = more expressive.
Required range: 0 <= x <= 1
style
number | null
Style exaggeration (0.0-1.0)
Required range: 0 <= x <= 1
temperature
number | null
Optional creativity/randomness (0.0-2.0). Higher = more variation. (music generation only)
Required range: 0 <= x <= 2
tempo
string
default:medium
Tempo: 'slow', 'medium', or 'fast' (music generation only)
text
string | null
Text to convert to speech. Required for single-speaker TTS. Mutually exclusive with segments.
voice_display_name
string | null
Human-readable voice name for UI display (voice_name carries the voice_id for backend)
voice_name
string | null
Voice name for TTS. Gemini: one of the 30 prebuilt studio voices ('Zephyr', 'Kore', 'Puck', …); Gemini 3.8 also accepts any Extended Voice Library id. ElevenLabs: a current premade name such as 'Sarah', 'George' or 'Laura', or any library voice id.
voice_profile_id
string | null
Speak as one of this workspace's cloned voices (its voice profile id). Used when voice_name is not sent.
Response
Successful Response
One generation. Poll GET /v1/generations/{id} until status is completed or failed.
created_at
string<date-time>
required
id
string
required
Example:
"6f1c2d3e-9a0b-4c7d-8e1f-2a3b4c5d6e7f"
model
string
required
Example:
"seedance-2-5-fal"
prompt
string
required
status
enum<string>
required
Available options:
pending,
completed,
failed
type
enum<string>
required
Available options:
image,
video,
audio
completed_at
string<date-time> | null
credits_charged
number | null
Credits actually charged; null while pending.
error
GenerationError · object | null
Show child attributes
idempotency_key
string | null
outputs
GenerationOutput · object[]
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ekly API","description":"Generate images, video, music and speech from your own code, with the same models and credits as the Ekly app.","colors":{"primary":"#5B2A86","light":"#B48BDB","dark":"#3E1C5E"},"logo":{"light":"https://mintcdn.com/ekly-ai/FSt9JZoGe5_vT9mj/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=FSt9JZoGe5_vT9mj\u0026q=85\u0026s=688183ef86246a1918b4ec7156ce709b","dark":"https://mintcdn.com/ekly-ai/FSt9JZoGe5_vT9mj/logo/logo_dark.svg?fit=max\u0026auto=format\u0026n=FSt9JZoGe5_vT9mj\u0026q=85\u0026s=5d05eeea307b0b6a3ba92bee5d309f5e","href":"https://ekly.ai"},"favicon":"https://mintcdn.com/ekly-ai/FSt9JZoGe5_vT9mj/favicon.svg?fit=max\u0026auto=format\u0026n=FSt9JZoGe5_vT9mj\u0026q=85\u0026s=7a2033847e9a68b36977c111f721ddf9","navbar":{"links":[{"href":"https://app.ekly.ai","label":"Open the app"}],"primary":{"type":"button","label":"Get an API key","href":"https://app.ekly.ai/settings/team"}},"footer":{"socials":{"website":"https://ekly.ai"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ekly-ai","hasAudioNarration":false,"actualSubdomain":"ekly-ai","customDomains":["docs.ekly.ai"],"gitSource":{"type":"github","owner":"ekly-ai","repo":"mono","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6afd7181221c75a5e45aba90","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Guides","count":96},{"language":"default","tag":"Video models","count":44},{"language":"default","tag":"Image models","count":21},{"language":"default","tag":"Audio models","count":17},{"language":"default","tag":"API reference","count":10},{"language":"default","tag":"v1","count":10},{"language":"default","tag":"Using the API","count":7},{"language":"default","tag":"Start here","count":3},{"language":"default","tag":"Choosing a model","count":3},{"language":"default","tag":"Agents and MCP","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/v1/generate-speech-or-music","slug":"/api-reference/v1/generate-speech-or-music","pageMetadata":{"title":"Generate speech or music","description":"Submits a speech or music generation; the model decides which. Returns immediately with `status: pending`; credits are reserved now and settled when the job finishes. Poll `GET /v1/generations/{id}` until `completed` or `failed`.","deprecated":null,"version":null,"openapi":"/openapi.v1.json post /v1/audio","href":"/api-reference/v1/generate-speech-or-music","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Submits a speech or music generation; the model decides which. Returns immediately with \", _jsx(_components.code, {\n children: \"status: pending\"\n }), \"; credits are reserved now and settled when the job finishes. Poll \", _jsx(_components.code, {\n children: \"GET /v1/generations/{id}\"\n }), \" until \", _jsx(_components.code, {\n children: \"completed\"\n }), \" or \", _jsx(_components.code, {\n children: \"failed\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Generate speech or music","description":"Submits a speech or music generation; the model decides which. Returns immediately with `status: pending`; credits are reserved now and settled when the job finishes. Poll `GET /v1/generations/{id}` until `completed` or `failed`.","deprecated":null,"version":null,"openapi":"/openapi.v1.json post /v1/audio","href":"/api-reference/v1/generate-speech-or-music","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Submits a speech or music generation; the model decides which. Returns immediately with `status: pending`; credits are reserved now and settled when the job finishes. Poll `GET /v1/generations/{id}` until `completed` or `failed`.","operationId":"create_audio","parameters":["4a82418e-42ba-4264-9587-84102fa3dc30"],"requestBody":"0e97fa1b-7cdf-4b52-8832-d9c2c6d22b4b","responses":{"200":"55f56a73-b189-4f25-bfb5-0a4dfbdb9a71","401":"9d4fac74-bcc0-44b4-b25f-b18520a2eb48","402":"2f950e0c-be91-4332-9794-1048b9a9331f","403":"9005e36f-93cd-4732-9756-545e9c3b8343","409":"1cc20805-6f6c-49b0-ae7e-274264edb287","422":"33cf896f-06d6-4eb1-ab4c-71e358985c36","429":"83e1007b-a95b-48a3-92dd-15c918ab275b"},"security":["6db65825-4ca0-4d12-a081-be3caaef56d0"],"summary":"Generate speech or music","tags":["v1"],"method":"post","type":"path","servers":["5afb3711-516f-49b6-82ab-e91b4a96c2c3"],"path":"/v1/audio","baseUrlOptions":["https://api.ekly.ai"],"title":"Generate speech or music","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4a82418e-42ba-4264-9587-84102fa3dc30":{"description":"Reuse the same value when retrying the same request; a repeat returns the original generation without charging again. Reusing it with a different body returns 409.","in":"header","name":"Idempotency-Key","required":false,"schema":{"oneOf":[{"type":"string","title":"Idempotency-Key","description":"Reuse the same value when retrying the same request; a repeat returns the original generation without charging again. Reusing it with a different body returns 409.","maxLength":128,"uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Idempotency-Key","description":"Reuse the same value when retrying the same request; a repeat returns the original generation without charging again. Reusing it with a different body returns 409.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}}},"requestBody":{"content":{"application/json":{"example":{"model":"eleven_multilingual_v2","text":"Welcome back. Your export is ready.","voice_name":"Rachel"},"schema":{"additionalProperties":false,"description":"Generate speech or music; the model decides which.","properties":{"apply_text_normalization":{"oneOf":[{"type":"string","title":"Apply Text Normalization","description":"Text normalization: on/off/auto","uniqueKey":"apply_text_normalization.oneOf.0","typeLabel":"string"},{"type":"null","title":"Apply Text Normalization","description":"Text normalization: on/off/auto","uniqueKey":"apply_text_normalization.oneOf.1","typeLabel":"null"}],"uniqueKey":"apply_text_normalization","typeLabel":"string | null"},"bpm":{"oneOf":[{"type":"integer","title":"Bpm","description":"Optional BPM override (60-200). If not provided, tempo is used to estimate. (music generation only)","maximum":200,"minimum":60,"uniqueKey":"bpm.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Bpm","description":"Optional BPM override (60-200). If not provided, tempo is used to estimate. (music generation only)","uniqueKey":"bpm.oneOf.1","typeLabel":"null"}],"uniqueKey":"bpm","typeLabel":"integer | null"},"composition_plan":{"oneOf":[{"type":"object","title":"Composition Plan","description":"ElevenLabs MusicPrompt composition plan. Mutually exclusive with prompt/prompt_tags; section durations control track length.","additionalProperties":true,"uniqueKey":"composition_plan.oneOf.0","typeLabel":"Composition Plan · object"},{"type":"null","title":"Composition Plan","description":"ElevenLabs MusicPrompt composition plan. Mutually exclusive with prompt/prompt_tags; section durations control track length.","uniqueKey":"composition_plan.oneOf.1","typeLabel":"null"}],"uniqueKey":"composition_plan","typeLabel":"Composition Plan · object | null"},"content_type":{"oneOf":[{"type":"string","title":"Content Type","description":"Content type preset name","uniqueKey":"content_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Content Type","description":"Content type preset name","uniqueKey":"content_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"content_type","typeLabel":"string | null"},"delivery":{"oneOf":[{"type":"string","title":"Delivery","description":"Sustained delivery direction for models with a `delivery` parameter (Gemini 3.8 TTS): emotion, pace, pitch or tone in a few words, e.g. \"whispered, nervous\" or \"speaking slowly\". Applies to every line without its own `delivery`. Rejected on models that do not declare it.","maxLength":500,"uniqueKey":"delivery.oneOf.0","typeLabel":"string"},{"type":"null","title":"Delivery","description":"Sustained delivery direction for models with a `delivery` parameter (Gemini 3.8 TTS): emotion, pace, pitch or tone in a few words, e.g. \"whispered, nervous\" or \"speaking slowly\". Applies to every line without its own `delivery`. Rejected on models that do not declare it.","uniqueKey":"delivery.oneOf.1","typeLabel":"null"}],"uniqueKey":"delivery","typeLabel":"string | null"},"duration":{"default":30,"description":"Duration in seconds. Lyria allows 5-30 (validated per-model in the route); ElevenLabs Music allows up to 300. Not used for TTS.","maximum":600,"minimum":3,"title":"Duration","type":"integer","uniqueKey":"duration","typeLabel":"integer"},"energy":{"default":"medium","description":"Energy level: 'low', 'medium', or 'high' (music generation only)","title":"Energy","type":"string","uniqueKey":"energy","typeLabel":"string"},"force_instrumental":{"oneOf":[{"type":"boolean","title":"Force Instrumental","description":"Generate instrumental-only music (ElevenLabs Music, prompt mode only)","default":false,"uniqueKey":"force_instrumental.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Force Instrumental","description":"Generate instrumental-only music (ElevenLabs Music, prompt mode only)","default":false,"uniqueKey":"force_instrumental.oneOf.1","typeLabel":"null"}],"uniqueKey":"force_instrumental","typeLabel":"boolean | null"},"idempotency_key":{"oneOf":[{"type":"string","title":"Idempotency Key","description":"Client-supplied key (≤128 chars); a repeat with the same key returns the original generation without re-charging","maxLength":128,"uniqueKey":"idempotency_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Idempotency Key","description":"Client-supplied key (≤128 chars); a repeat with the same key returns the original generation without re-charging","uniqueKey":"idempotency_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"idempotency_key","typeLabel":"string | null"},"instrumental":{"oneOf":[{"type":"boolean","title":"Instrumental","description":"Generate instrumental-only music with no vocals (Lyria 3 only). Mutually exclusive with lyrics.","uniqueKey":"instrumental.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Instrumental","description":"Generate instrumental-only music with no vocals (Lyria 3 only). Mutually exclusive with lyrics.","uniqueKey":"instrumental.oneOf.1","typeLabel":"null"}],"uniqueKey":"instrumental","typeLabel":"boolean | null"},"language":{"oneOf":[{"type":"string","title":"Language","description":"Language for TTS synthesis: Qwen3 uses names such as 'Auto', 'English', 'Chinese'; Gemini uses BCP-47 codes. ElevenLabs auto-detects language and ignores this shared field.","uniqueKey":"language.oneOf.0","typeLabel":"string"},{"type":"null","title":"Language","description":"Language for TTS synthesis: Qwen3 uses names such as 'Auto', 'English', 'Chinese'; Gemini uses BCP-47 codes. ElevenLabs auto-detects language and ignores this shared field.","uniqueKey":"language.oneOf.1","typeLabel":"null"}],"uniqueKey":"language","typeLabel":"string | null"},"lyrics":{"oneOf":[{"type":"string","title":"Lyrics","description":"Custom lyrics for vocal generation (Lyria 3 only). Use [Verse], [Chorus], [Bridge] markers. Pro model also supports [MM:SS] timestamps.","uniqueKey":"lyrics.oneOf.0","typeLabel":"string"},{"type":"null","title":"Lyrics","description":"Custom lyrics for vocal generation (Lyria 3 only). Use [Verse], [Chorus], [Bridge] markers. Pro model also supports [MM:SS] timestamps.","uniqueKey":"lyrics.oneOf.1","typeLabel":"null"}],"uniqueKey":"lyrics","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","title":"Model","description":"Required. Audio model identifier. Music: 'models/lyria-realtime-exp'. TTS Gemini: 'gemini-3.1-flash-tts-preview'. TTS ElevenLabs: 'eleven_v4', 'eleven_v3', 'eleven_multilingual_v2', 'eleven_turbo_v2_5'","uniqueKey":"model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model","description":"Required. Audio model identifier. Music: 'models/lyria-realtime-exp'. TTS Gemini: 'gemini-3.1-flash-tts-preview'. TTS ElevenLabs: 'eleven_v4', 'eleven_v3', 'eleven_multilingual_v2', 'eleven_turbo_v2_5'","uniqueKey":"model.oneOf.1","typeLabel":"null"}],"uniqueKey":"model","typeLabel":"string | null"},"negative_prompt":{"oneOf":[{"type":"string","title":"Negative Prompt","description":"What to avoid in the music (Lyria 2 only). Ignored by Lyria RealTime.","uniqueKey":"negative_prompt.oneOf.0","typeLabel":"string"},{"type":"null","title":"Negative Prompt","description":"What to avoid in the music (Lyria 2 only). Ignored by Lyria RealTime.","uniqueKey":"negative_prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"negative_prompt","typeLabel":"string | null"},"next_audio_gen_id":{"oneOf":[{"type":"string","title":"Next Audio Gen Id","description":"Generation ID for next audio context","uniqueKey":"next_audio_gen_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Audio Gen Id","description":"Generation ID for next audio context","uniqueKey":"next_audio_gen_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_audio_gen_id","typeLabel":"string | null"},"next_context_mode":{"oneOf":[{"type":"string","title":"Next Context Mode","description":"'text' or 'audio'","default":"text","uniqueKey":"next_context_mode.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Context Mode","description":"'text' or 'audio'","default":"text","uniqueKey":"next_context_mode.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_context_mode","typeLabel":"string | null"},"next_request_ids":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"next_request_ids.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Next Request Ids","description":"ElevenLabs request IDs for next audio. Refused before charging on models that can't use context, such as ElevenLabs v3.","uniqueKey":"next_request_ids.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Next Request Ids","description":"ElevenLabs request IDs for next audio. Refused before charging on models that can't use context, such as ElevenLabs v3.","uniqueKey":"next_request_ids.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_request_ids","typeLabel":"string[] | null"},"next_text":{"oneOf":[{"type":"string","title":"Next Text","description":"Next text context (not spoken). Refused before charging on models that can't use context, such as ElevenLabs v3.","uniqueKey":"next_text.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Text","description":"Next text context (not spoken). Refused before charging on models that can't use context, such as ElevenLabs v3.","uniqueKey":"next_text.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_text","typeLabel":"string | null"},"output_format":{"oneOf":[{"type":"string","title":"Output Format","description":"ElevenLabs MP3 or WAV output format (e.g. mp3_44100_128, wav_24000)","uniqueKey":"output_format.oneOf.0","typeLabel":"string"},{"type":"null","title":"Output Format","description":"ElevenLabs MP3 or WAV output format (e.g. mp3_44100_128, wav_24000)","uniqueKey":"output_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"output_format","typeLabel":"string | null"},"previous_audio_gen_id":{"oneOf":[{"type":"string","title":"Previous Audio Gen Id","description":"Generation ID for previous audio context","uniqueKey":"previous_audio_gen_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Previous Audio Gen Id","description":"Generation ID for previous audio context","uniqueKey":"previous_audio_gen_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"previous_audio_gen_id","typeLabel":"string | null"},"previous_context_mode":{"oneOf":[{"type":"string","title":"Previous Context Mode","description":"'text' or 'audio'","default":"text","uniqueKey":"previous_context_mode.oneOf.0","typeLabel":"string"},{"type":"null","title":"Previous Context Mode","description":"'text' or 'audio'","default":"text","uniqueKey":"previous_context_mode.oneOf.1","typeLabel":"null"}],"uniqueKey":"previous_context_mode","typeLabel":"string | null"},"previous_request_ids":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"previous_request_ids.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Previous Request Ids","description":"ElevenLabs request IDs for previous audio. Refused before charging on models that can't use context, such as ElevenLabs v3.","uniqueKey":"previous_request_ids.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Previous Request Ids","description":"ElevenLabs request IDs for previous audio. Refused before charging on models that can't use context, such as ElevenLabs v3.","uniqueKey":"previous_request_ids.oneOf.1","typeLabel":"null"}],"uniqueKey":"previous_request_ids","typeLabel":"string[] | null"},"previous_text":{"oneOf":[{"type":"string","title":"Previous Text","description":"Previous text context (not spoken). Refused before charging on models that can't use context, such as ElevenLabs v3.","uniqueKey":"previous_text.oneOf.0","typeLabel":"string"},{"type":"null","title":"Previous Text","description":"Previous text context (not spoken). Refused before charging on models that can't use context, such as ElevenLabs v3.","uniqueKey":"previous_text.oneOf.1","typeLabel":"null"}],"uniqueKey":"previous_text","typeLabel":"string | null"},"project_id":{"oneOf":[{"type":"string","title":"Project Id","description":"Project scope for the generated asset (optional)","uniqueKey":"project_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Project Id","description":"Project scope for the generated asset (optional)","uniqueKey":"project_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"project_id","typeLabel":"string | null"},"prompt":{"oneOf":[{"type":"string","title":"Prompt","description":"Free-text music prompt (ElevenLabs Music). Mutually exclusive with composition_plan.","uniqueKey":"prompt.oneOf.0","typeLabel":"string"},{"type":"null","title":"Prompt","description":"Free-text music prompt (ElevenLabs Music). Mutually exclusive with composition_plan.","uniqueKey":"prompt.oneOf.1","typeLabel":"null"}],"uniqueKey":"prompt","typeLabel":"string | null"},"prompt_tags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"prompt_tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Prompt Tags","description":"List of prompt tags describing the desired music (e.g. ['energetic', 'rock', 'guitar']). Required for music generation.","uniqueKey":"prompt_tags.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Prompt Tags","description":"List of prompt tags describing the desired music (e.g. ['energetic', 'rock', 'guitar']). Required for music generation.","uniqueKey":"prompt_tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"prompt_tags","typeLabel":"string[] | null"},"pronunciation_dictionary_ids":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"pronunciation_dictionary_ids.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Pronunciation Dictionary Ids","description":"Dictionary entry IDs to apply","uniqueKey":"pronunciation_dictionary_ids.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Pronunciation Dictionary Ids","description":"Dictionary entry IDs to apply","uniqueKey":"pronunciation_dictionary_ids.oneOf.1","typeLabel":"null"}],"uniqueKey":"pronunciation_dictionary_ids","typeLabel":"string[] | null"},"qwen3_embedding_id":{"oneOf":[{"type":"string","title":"Qwen3 Embedding Id","description":"Qwen3 voice embedding ID (from voice profile clone)","uniqueKey":"qwen3_embedding_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Qwen3 Embedding Id","description":"Qwen3 voice embedding ID (from voice profile clone)","uniqueKey":"qwen3_embedding_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"qwen3_embedding_id","typeLabel":"string | null"},"qwen3_model_size":{"oneOf":[{"type":"string","title":"Qwen3 Model Size","description":"Qwen3 model size","uniqueKey":"qwen3_model_size.oneOf.0","typeLabel":"string"},{"type":"null","title":"Qwen3 Model Size","description":"Qwen3 model size","uniqueKey":"qwen3_model_size.oneOf.1","typeLabel":"null"}],"uniqueKey":"qwen3_model_size","typeLabel":"string | null"},"sample_count":{"oneOf":[{"type":"integer","title":"Sample Count","description":"Number of variations per API call (Lyria 2 only, 1-4). Mutually exclusive with seed.","maximum":4,"minimum":1,"uniqueKey":"sample_count.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Sample Count","description":"Number of variations per API call (Lyria 2 only, 1-4). Mutually exclusive with seed.","uniqueKey":"sample_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"sample_count","typeLabel":"integer | null"},"seed":{"oneOf":[{"type":"integer","title":"Seed","description":"Random seed for reproducible output (Lyria 2 only). Mutually exclusive with sample_count > 1.","uniqueKey":"seed.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Seed","description":"Random seed for reproducible output (Lyria 2 only). Mutually exclusive with sample_count > 1.","uniqueKey":"seed.oneOf.1","typeLabel":"null"}],"uniqueKey":"seed","typeLabel":"integer | null"},"segments":{"oneOf":[{"type":"array","items":{"description":"One speaker line in a multi-speaker TTS script.\n\nMutually exclusive with the top-level `text`/`voice_name` pair on\nAudioGenerateRequest — send either a single block or an ordered list of\nthese, not both. ElevenLabs models with `supports.native_dialogue` use native\ndialogue unless request-stitching context is supplied. Gemini uses native dialogue for two distinct voices and per-turn\nsynthesis for one distinct voice; other models synthesize independently.\nEvery path returns one audio file / one AIGeneration row.","properties":{"text":{"description":"Spoken text for this line; the model's max_text_length applies","maxLength":20000,"minLength":1,"title":"Text","type":"string","isRequired":true,"uniqueKey":"segments.oneOf.0.items.[INDEX].text","typeLabel":"string"},"voice_name":{"description":"Provider voice id or name (same as top-level voice_name)","minLength":1,"title":"Voice Name","type":"string","isRequired":true,"uniqueKey":"segments.oneOf.0.items.[INDEX].voice_name","typeLabel":"string"},"delivery":{"oneOf":[{"type":"string","title":"Delivery","description":"How this line is delivered on models with a `delivery` parameter (Gemini 3.8): emotion, pace, pitch or tone, e.g. \"whispered, nervous\". Overrides the request-level `delivery` for this line.","maxLength":500,"uniqueKey":"segments.oneOf.0.items.[INDEX].delivery.oneOf.0","typeLabel":"string"},{"type":"null","title":"Delivery","description":"How this line is delivered on models with a `delivery` parameter (Gemini 3.8): emotion, pace, pitch or tone, e.g. \"whispered, nervous\". Overrides the request-level `delivery` for this line.","uniqueKey":"segments.oneOf.0.items.[INDEX].delivery.oneOf.1","typeLabel":"null"}],"uniqueKey":"segments.oneOf.0.items.[INDEX].delivery","typeLabel":"string | null"},"similarity_boost":{"oneOf":[{"type":"number","title":"Similarity Boost","maximum":1,"minimum":0,"uniqueKey":"segments.oneOf.0.items.[INDEX].similarity_boost.oneOf.0","typeLabel":"number"},{"type":"null","title":"Similarity Boost","uniqueKey":"segments.oneOf.0.items.[INDEX].similarity_boost.oneOf.1","typeLabel":"null"}],"uniqueKey":"segments.oneOf.0.items.[INDEX].similarity_boost","typeLabel":"number | null"},"speed":{"oneOf":[{"type":"number","title":"Speed","maximum":1.2,"minimum":0.7,"uniqueKey":"segments.oneOf.0.items.[INDEX].speed.oneOf.0","typeLabel":"number"},{"type":"null","title":"Speed","uniqueKey":"segments.oneOf.0.items.[INDEX].speed.oneOf.1","typeLabel":"null"}],"uniqueKey":"segments.oneOf.0.items.[INDEX].speed","typeLabel":"number | null"},"stability":{"oneOf":[{"type":"number","title":"Stability","maximum":1,"minimum":0,"uniqueKey":"segments.oneOf.0.items.[INDEX].stability.oneOf.0","typeLabel":"number"},{"type":"null","title":"Stability","uniqueKey":"segments.oneOf.0.items.[INDEX].stability.oneOf.1","typeLabel":"null"}],"uniqueKey":"segments.oneOf.0.items.[INDEX].stability","typeLabel":"number | null"},"style":{"oneOf":[{"type":"number","title":"Style","maximum":1,"minimum":0,"uniqueKey":"segments.oneOf.0.items.[INDEX].style.oneOf.0","typeLabel":"number"},{"type":"null","title":"Style","uniqueKey":"segments.oneOf.0.items.[INDEX].style.oneOf.1","typeLabel":"null"}],"uniqueKey":"segments.oneOf.0.items.[INDEX].style","typeLabel":"number | null"},"voice_display_name":{"oneOf":[{"type":"string","title":"Voice Display Name","description":"Human-readable voice name for UI restore","uniqueKey":"segments.oneOf.0.items.[INDEX].voice_display_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Voice Display Name","description":"Human-readable voice name for UI restore","uniqueKey":"segments.oneOf.0.items.[INDEX].voice_display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"segments.oneOf.0.items.[INDEX].voice_display_name","typeLabel":"string | null"}},"required":["voice_name","text"],"title":"SpeechSegment","type":"object","uniqueKey":"segments.oneOf.0.items.[INDEX]","typeLabel":"SpeechSegment · object"},"title":"Segments","description":"Multi-speaker script as an ordered list of {voice_name, text} lines. Mutually exclusive with top-level text. ElevenLabs v3 without stitching context and two-voice Gemini conversations use native dialogue; other requests synthesize turns independently. All return one audio file.","uniqueKey":"segments.oneOf.0","typeLabel":"SpeechSegment · object[]"},{"type":"null","title":"Segments","description":"Multi-speaker script as an ordered list of {voice_name, text} lines. Mutually exclusive with top-level text. ElevenLabs v3 without stitching context and two-voice Gemini conversations use native dialogue; other requests synthesize turns independently. All return one audio file.","uniqueKey":"segments.oneOf.1","typeLabel":"null"}],"uniqueKey":"segments","typeLabel":"SpeechSegment · object[] | null"},"similarity_boost":{"oneOf":[{"type":"number","title":"Similarity Boost","description":"Voice clarity/similarity for ElevenLabs (0.0-1.0). Higher = closer to original voice.","maximum":1,"minimum":0,"uniqueKey":"similarity_boost.oneOf.0","typeLabel":"number"},{"type":"null","title":"Similarity Boost","description":"Voice clarity/similarity for ElevenLabs (0.0-1.0). Higher = closer to original voice.","uniqueKey":"similarity_boost.oneOf.1","typeLabel":"null"}],"uniqueKey":"similarity_boost","typeLabel":"number | null"},"speed":{"oneOf":[{"type":"number","title":"Speed","description":"Speech speed. Per-model range comes from the catalog.","maximum":1.3,"minimum":0.7,"uniqueKey":"speed.oneOf.0","typeLabel":"number"},{"type":"null","title":"Speed","description":"Speech speed. Per-model range comes from the catalog.","uniqueKey":"speed.oneOf.1","typeLabel":"null"}],"uniqueKey":"speed","typeLabel":"number | null"},"stability":{"oneOf":[{"type":"number","title":"Stability","description":"Voice stability for ElevenLabs (0.0-1.0). Higher = more consistent, lower = more expressive.","maximum":1,"minimum":0,"uniqueKey":"stability.oneOf.0","typeLabel":"number"},{"type":"null","title":"Stability","description":"Voice stability for ElevenLabs (0.0-1.0). Higher = more consistent, lower = more expressive.","uniqueKey":"stability.oneOf.1","typeLabel":"null"}],"uniqueKey":"stability","typeLabel":"number | null"},"style":{"oneOf":[{"type":"number","title":"Style","description":"Style exaggeration (0.0-1.0)","maximum":1,"minimum":0,"uniqueKey":"style.oneOf.0","typeLabel":"number"},{"type":"null","title":"Style","description":"Style exaggeration (0.0-1.0)","uniqueKey":"style.oneOf.1","typeLabel":"null"}],"uniqueKey":"style","typeLabel":"number | null"},"temperature":{"oneOf":[{"type":"number","title":"Temperature","description":"Optional creativity/randomness (0.0-2.0). Higher = more variation. (music generation only)","maximum":2,"minimum":0,"uniqueKey":"temperature.oneOf.0","typeLabel":"number"},{"type":"null","title":"Temperature","description":"Optional creativity/randomness (0.0-2.0). Higher = more variation. (music generation only)","uniqueKey":"temperature.oneOf.1","typeLabel":"null"}],"uniqueKey":"temperature","typeLabel":"number | null"},"tempo":{"default":"medium","description":"Tempo: 'slow', 'medium', or 'fast' (music generation only)","title":"Tempo","type":"string","uniqueKey":"tempo","typeLabel":"string"},"text":{"oneOf":[{"type":"string","title":"Text","description":"Text to convert to speech. Required for single-speaker TTS. Mutually exclusive with segments.","uniqueKey":"text.oneOf.0","typeLabel":"string"},{"type":"null","title":"Text","description":"Text to convert to speech. Required for single-speaker TTS. Mutually exclusive with segments.","uniqueKey":"text.oneOf.1","typeLabel":"null"}],"uniqueKey":"text","typeLabel":"string | null"},"voice_display_name":{"oneOf":[{"type":"string","title":"Voice Display Name","description":"Human-readable voice name for UI display (voice_name carries the voice_id for backend)","uniqueKey":"voice_display_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Voice Display Name","description":"Human-readable voice name for UI display (voice_name carries the voice_id for backend)","uniqueKey":"voice_display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"voice_display_name","typeLabel":"string | null"},"voice_name":{"oneOf":[{"type":"string","title":"Voice Name","description":"Voice name for TTS. Gemini: one of the 30 prebuilt studio voices ('Zephyr', 'Kore', 'Puck', …); Gemini 3.8 also accepts any Extended Voice Library id. ElevenLabs: a current premade name such as 'Sarah', 'George' or 'Laura', or any library voice id.","uniqueKey":"voice_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Voice Name","description":"Voice name for TTS. Gemini: one of the 30 prebuilt studio voices ('Zephyr', 'Kore', 'Puck', …); Gemini 3.8 also accepts any Extended Voice Library id. ElevenLabs: a current premade name such as 'Sarah', 'George' or 'Laura', or any library voice id.","uniqueKey":"voice_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"voice_name","typeLabel":"string | null"},"voice_profile_id":{"oneOf":[{"type":"string","title":"Voice Profile Id","description":"Speak as one of this workspace's cloned voices (its voice profile id). Used when voice_name is not sent.","uniqueKey":"voice_profile_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Voice Profile Id","description":"Speak as one of this workspace's cloned voices (its voice profile id). Used when voice_name is not sent.","uniqueKey":"voice_profile_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"voice_profile_id","typeLabel":"string | null"}},"title":"CreateAudioRequest","type":"object","uniqueKey":"","typeLabel":"CreateAudioRequest · object"},"examples":{"Example":{"title":"Example","value":{"model":"eleven_multilingual_v2","text":"Welcome back. Your export is ready.","voice_name":"Rachel"}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"55f56a73-b189-4f25-bfb5-0a4dfbdb9a71":{"content":{"application/json":{"schema":{"description":"One generation. Poll GET /v1/generations/{id} until status is completed or failed.","properties":{"created_at":{"format":"date-time","title":"Created At","type":"string","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"id":{"examples":["6f1c2d3e-9a0b-4c7d-8e1f-2a3b4c5d6e7f"],"title":"Id","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"model":{"examples":["seedance-2-5-fal"],"title":"Model","type":"string","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"prompt":{"title":"Prompt","type":"string","isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"status":{"enum":["pending","completed","failed"],"title":"Status","type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"type":{"enum":["image","video","audio"],"title":"Type","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"completed_at":{"oneOf":[{"type":"string","title":"Completed At","format":"date-time","uniqueKey":"completed_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Completed At","uniqueKey":"completed_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"completed_at","typeLabel":"string\u003cdate-time> | null"},"credits_charged":{"oneOf":[{"type":"number","title":"Credits Charged","description":"Credits actually charged; null while pending.","uniqueKey":"credits_charged.oneOf.0","typeLabel":"number"},{"type":"null","title":"Credits Charged","description":"Credits actually charged; null while pending.","uniqueKey":"credits_charged.oneOf.1","typeLabel":"null"}],"uniqueKey":"credits_charged","typeLabel":"number | null"},"error":{"oneOf":[{"type":"object","title":"GenerationError","required":["code","message"],"properties":{"code":{"description":"One of the public failure categories: rate_limited, timeout, safety, invalid_voice, invalid_request, billing_or_access, provider_auth, provider_unavailable, provider_error.","title":"Code","type":"string","isRequired":true,"uniqueKey":"error.oneOf.0.code","typeLabel":"string"},"message":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"error.oneOf.0.message","typeLabel":"string"}},"uniqueKey":"error.oneOf.0","typeLabel":"GenerationError · object"},{"type":"null","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"GenerationError · object | null"},"idempotency_key":{"oneOf":[{"type":"string","title":"Idempotency Key","uniqueKey":"idempotency_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Idempotency Key","uniqueKey":"idempotency_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"idempotency_key","typeLabel":"string | null"},"outputs":{"items":{"properties":{"url":{"description":"Download URL. Fetch promptly or store the file; URLs are not permanent.","title":"Url","type":"string","isRequired":true,"uniqueKey":"outputs.items.[INDEX].url","typeLabel":"string"},"asset_id":{"oneOf":[{"type":"string","title":"Asset Id","description":"Workspace asset id for this output. Pass it as a reference input to chain generations.","uniqueKey":"outputs.items.[INDEX].asset_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Asset Id","description":"Workspace asset id for this output. Pass it as a reference input to chain generations.","uniqueKey":"outputs.items.[INDEX].asset_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"outputs.items.[INDEX].asset_id","typeLabel":"string | null"},"content_type":{"oneOf":[{"type":"string","title":"Content Type","example":"video/mp4","uniqueKey":"outputs.items.[INDEX].content_type.oneOf.0","typeLabel":"string"},{"type":"null","title":"Content Type","example":"video/mp4","uniqueKey":"outputs.items.[INDEX].content_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"outputs.items.[INDEX].content_type","typeLabel":"string | null"},"duration_seconds":{"oneOf":[{"type":"number","title":"Duration Seconds","uniqueKey":"outputs.items.[INDEX].duration_seconds.oneOf.0","typeLabel":"number"},{"type":"null","title":"Duration Seconds","uniqueKey":"outputs.items.[INDEX].duration_seconds.oneOf.1","typeLabel":"null"}],"uniqueKey":"outputs.items.[INDEX].duration_seconds","typeLabel":"number | null"},"height":{"oneOf":[{"type":"integer","title":"Height","uniqueKey":"outputs.items.[INDEX].height.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Height","uniqueKey":"outputs.items.[INDEX].height.oneOf.1","typeLabel":"null"}],"uniqueKey":"outputs.items.[INDEX].height","typeLabel":"integer | null"},"width":{"oneOf":[{"type":"integer","title":"Width","uniqueKey":"outputs.items.[INDEX].width.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Width","uniqueKey":"outputs.items.[INDEX].width.oneOf.1","typeLabel":"null"}],"uniqueKey":"outputs.items.[INDEX].width","typeLabel":"integer | null"}},"required":["url"],"title":"GenerationOutput","type":"object","uniqueKey":"outputs.items.[INDEX]","typeLabel":"GenerationOutput · object"},"title":"Outputs","type":"array","uniqueKey":"outputs","typeLabel":"GenerationOutput · object[]"}},"required":["id","type","status","model","prompt","created_at"],"title":"GenerationResponse","type":"object","uniqueKey":"","typeLabel":"GenerationResponse · object"},"examples":{"Example":{"title":"Example","value":{"created_at":"2023-11-07T05:31:56Z","id":"6f1c2d3e-9a0b-4c7d-8e1f-2a3b4c5d6e7f","model":"seedance-2-5-fal","prompt":"\u003cstring>","status":"pending","type":"image","completed_at":"2023-11-07T05:31:56Z","credits_charged":123,"error":{"code":"\u003cstring>","message":"\u003cstring>"},"idempotency_key":"\u003cstring>","outputs":[{"url":"\u003cstring>","asset_id":"\u003cstring>","content_type":"video/mp4","duration_seconds":123,"height":123,"width":123}]}}},"exampleType":"generated"}},"description":"Successful Response","exampleType":"generated"},"9d4fac74-bcc0-44b4-b25f-b18520a2eb48":{"content":{"application/json":{"example":{"error":{"code":"unauthenticated","message":"This API key is not valid. Create a new one in Settings → Team.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}},"schema":{"description":"Every non-2xx /v1 response.","properties":{"error":{"properties":{"code":{"description":"Stable machine-readable code: unauthenticated, invalid_api_key, payment_required, forbidden, api_key_scope, not_found, conflict, validation_error, rate_limited, client_error, internal_error.","title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable explanation; safe to show to a developer, not meant for parsing.","title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.0","typeLabel":"Details · object[]"},{"type":"null","title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"Details · object[] | null"},"trace_id":{"oneOf":[{"type":"string","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.trace_id","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorBody","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorBody · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"unauthenticated","message":"This API key is not valid. Create a new one in Settings → Team.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}}}},"exampleType":"examples"}},"description":"API key missing, invalid, revoked or expired.","exampleType":"examples"},"2f950e0c-be91-4332-9794-1048b9a9331f":{"content":{"application/json":{"example":{"error":{"code":"payment_required","message":"Insufficient credits: this generation needs 39.6 credits and 12.0 are available.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}},"schema":{"description":"Every non-2xx /v1 response.","properties":{"error":{"properties":{"code":{"description":"Stable machine-readable code: unauthenticated, invalid_api_key, payment_required, forbidden, api_key_scope, not_found, conflict, validation_error, rate_limited, client_error, internal_error.","title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable explanation; safe to show to a developer, not meant for parsing.","title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.0","typeLabel":"Details · object[]"},{"type":"null","title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"Details · object[] | null"},"trace_id":{"oneOf":[{"type":"string","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.trace_id","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorBody","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorBody · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"payment_required","message":"Insufficient credits: this generation needs 39.6 credits and 12.0 are available.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}}}},"exampleType":"examples"}},"description":"Not enough credits.","exampleType":"examples"},"9005e36f-93cd-4732-9756-545e9c3b8343":{"content":{"application/json":{"example":{"error":{"code":"forbidden","message":"API keys can only call the /v1 API.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}},"schema":{"description":"Every non-2xx /v1 response.","properties":{"error":{"properties":{"code":{"description":"Stable machine-readable code: unauthenticated, invalid_api_key, payment_required, forbidden, api_key_scope, not_found, conflict, validation_error, rate_limited, client_error, internal_error.","title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable explanation; safe to show to a developer, not meant for parsing.","title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.0","typeLabel":"Details · object[]"},{"type":"null","title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"Details · object[] | null"},"trace_id":{"oneOf":[{"type":"string","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.trace_id","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorBody","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorBody · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"forbidden","message":"API keys can only call the /v1 API.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}}}},"exampleType":"examples"}},"description":"Not allowed for this key or organization.","exampleType":"examples"},"1cc20805-6f6c-49b0-ae7e-274264edb287":{"content":{"application/json":{"example":{"error":{"code":"conflict","message":"This idempotency key was already used with a different request.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}},"schema":{"description":"Every non-2xx /v1 response.","properties":{"error":{"properties":{"code":{"description":"Stable machine-readable code: unauthenticated, invalid_api_key, payment_required, forbidden, api_key_scope, not_found, conflict, validation_error, rate_limited, client_error, internal_error.","title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable explanation; safe to show to a developer, not meant for parsing.","title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.0","typeLabel":"Details · object[]"},{"type":"null","title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"Details · object[] | null"},"trace_id":{"oneOf":[{"type":"string","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.trace_id","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorBody","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorBody · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"conflict","message":"This idempotency key was already used with a different request.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}}}},"exampleType":"examples"}},"description":"Idempotency key reused with a different request.","exampleType":"examples"},"33cf896f-06d6-4eb1-ab4c-71e358985c36":{"content":{"application/json":{"example":{"error":{"code":"validation_error","details":[{"loc":["body","model"],"msg":"Field required","type":"missing"}],"message":"Request validation failed.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}},"schema":{"description":"Every non-2xx /v1 response.","properties":{"error":{"properties":{"code":{"description":"Stable machine-readable code: unauthenticated, invalid_api_key, payment_required, forbidden, api_key_scope, not_found, conflict, validation_error, rate_limited, client_error, internal_error.","title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable explanation; safe to show to a developer, not meant for parsing.","title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.0","typeLabel":"Details · object[]"},{"type":"null","title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"Details · object[] | null"},"trace_id":{"oneOf":[{"type":"string","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.trace_id","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorBody","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorBody · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"validation_error","details":[{"loc":["body","model"],"msg":"Field required","type":"missing"}],"message":"Request validation failed.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}}}},"exampleType":"examples"}},"description":"Request failed validation.","exampleType":"examples"},"83e1007b-a95b-48a3-92dd-15c918ab275b":{"content":{"application/json":{"example":{"error":{"code":"rate_limited","message":"Rate limit exceeded; retry after 12s.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}},"schema":{"description":"Every non-2xx /v1 response.","properties":{"error":{"properties":{"code":{"description":"Stable machine-readable code: unauthenticated, invalid_api_key, payment_required, forbidden, api_key_scope, not_found, conflict, validation_error, rate_limited, client_error, internal_error.","title":"Code","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable explanation; safe to show to a developer, not meant for parsing.","title":"Message","type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"error.details.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.0","typeLabel":"Details · object[]"},{"type":"null","title":"Details","description":"Only on 422: one entry per offending field, with `loc`, `msg` and `type`.","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"Details · object[] | null"},"trace_id":{"oneOf":[{"type":"string","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Trace Id","description":"Quote this when contacting support; it identifies the exact request.","uniqueKey":"error.trace_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.trace_id","typeLabel":"string | null"}},"required":["code","message"],"title":"ErrorBody","type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"ErrorBody · object"}},"required":["error"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"rate_limited","message":"Rate limit exceeded; retry after 12s.","trace_id":"c3746d5302dc4be6b2e8fa99fa762a8c"}}}},"exampleType":"examples"}},"description":"Rate limit exceeded; see Retry-After.","exampleType":"examples"}},"security":{"6db65825-4ca0-4d12-a081-be3caaef56d0":{"ApiKey":{"bearerFormat":"ek_live_…","description":"An organization API key created in Settings → Team, sent as `Authorization: Bearer \u003ckey>`.","scheme":"bearer","type":"http","scopes":[],"schemeName":"ApiKey"}}},"servers":{"5afb3711-516f-49b6-82ab-e91b4a96c2c3":{"description":"Production","url":"https://api.ekly.ai"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"ek_live_…","description":"An organization API key created in Settings → Team, sent as `Authorization: Bearer \u003ckey>`.","scheme":"bearer","type":"http","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An organization API key created in Settings → Team, sent as `Authorization: Bearer \u003ckey>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"}]},"originalFileLocation":"openapi.v1.json"},"subdomain":"ekly-ai","siteName":"Ekly API","title":"Generate speech or music - Ekly API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T09:36:09.657Z","originalFileLocation":"api-reference/v1/generate-speech-or-music.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Submits a speech or music generation; the model decides which. Returns immediately with status: pending; credits are reserved now and settled when the job finishes. Poll GET /v1/generations/{id} until completed or failed.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ekly API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ekly-ai/oylQ0lNxwgLuqOrO/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ekly-ai/oylQ0lNxwgLuqOrO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ekly-ai/oylQ0lNxwgLuqOrO/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ekly-ai/oylQ0lNxwgLuqOrO/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ekly-ai/oylQ0lNxwgLuqOrO/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ekly-ai/oylQ0lNxwgLuqOrO/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ekly-ai/oylQ0lNxwgLuqOrO/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ekly-ai/oylQ0lNxwgLuqOrO/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ekly-ai/oylQ0lNxwgLuqOrO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Generate speech or music - Ekly API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submits a speech or music generation; the model decides which. Returns immediately with status: pending; credits are reserved now and settled when the job finishes. Poll GET /v1/generations/{id} until completed or failed.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ekly API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ekly.ai/api-reference/v1/generate-speech-or-music\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ekly-ai.mintlify.site/_mintlify/api/og/v2?division=v1\u0026amp;title=Generate+speech+or+music\u0026amp;description=Submits+a+speech+or+music+generation%3B+the+model+decides+which.+Returns+immediately+with+%60status%3A+pending%60%3B+credits+are+reserved+now+and+settled+when+the+job+fin\u0026amp;theme=83657e8c5327b600c6bf9506\u0026amp;signature=67026ab805ac15bb1a0bac76b734dc6ba1ae320ea5427b126424684b7b4c00a2\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Generate speech or music - Ekly API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submits a speech or music generation; the model decides which. Returns immediately with status: pending; credits are reserved now and settled when the job finishes. Poll GET /v1/generations/{id} until completed or failed.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ekly-ai.mintlify.site/_mintlify/api/og/v2?division=v1\u0026amp;title=Generate+speech+or+music\u0026amp;description=Submits+a+speech+or+music+generation%3B+the+model+decides+which.+Returns+immediately+with+%60status%3A+pending%60%3B+credits+are+reserved+now+and+settled+when+the+job+fin\u0026amp;theme=83657e8c5327b600c6bf9506\u0026amp;signature=67026ab805ac15bb1a0bac76b734dc6ba1ae320ea5427b126424684b7b4c00a2\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ekly-ai/oylQ0lNxwgLuqOrO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ekly API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5B2A86\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ekly.ai/api-reference/v1/generate-speech-or-music\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v1/generate-speech-or-music.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ekly.ai/#organization\",\"name\":\"Ekly API\",\"url\":\"https://docs.ekly.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ekly-ai/FSt9JZoGe5_vT9mj/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=FSt9JZoGe5_vT9mj\u0026q=85\u0026s=688183ef86246a1918b4ec7156ce709b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ekly.ai#website\",\"name\":\"Ekly API\",\"url\":\"https://docs.ekly.ai\",\"publisher\":{\"@id\":\"https://docs.ekly.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ekly.ai/api-reference/v1/generate-speech-or-music#webpage\",\"url\":\"https://docs.ekly.ai/api-reference/v1/generate-speech-or-music\",\"name\":\"Generate speech or music\",\"description\":\"Submits a speech or music generation; the model decides which. Returns immediately with status: pending; credits are reserved now and settled when the job finishes. Poll GET /v1/generations/{id} until completed or failed.\",\"dateModified\":\"2026-11-18T09:36:09.657Z\",\"isPartOf\":{\"@id\":\"https://docs.ekly.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ekly.ai/api-reference/v1/generate-speech-or-music#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ekly.ai/api-reference/v1/generate-speech-or-music#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Ekly API\",\"item\":\"https://docs.ekly.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Generate speech or music\",\"item\":\"https://docs.ekly.ai/api-reference/v1/generate-speech-or-music\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ekly.ai/api-reference/v1/generate-speech-or-music#apireference\",\"headline\":\"Generate speech or music\",\"name\":\"Generate speech or music\",\"description\":\"Submits a speech or music generation; the model decides which. Returns immediately with status: pending; credits are reserved now and settled when the job finishes. Poll GET /v1/generations/{id} until completed or failed.\",\"url\":\"https://docs.ekly.ai/api-reference/v1/generate-speech-or-music\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ekly.ai/api-reference/v1/generate-speech-or-music#webpage\"},\"dateModified\":\"2026-11-18T09:36:09.657Z\",\"publisher\":{\"@id\":\"https://docs.ekly.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ekly.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ekly API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ekly API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v1/generate-speech-or-music.md","siteName":"Ekly API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API reference","groups":[{"group":"v1","pages":[{"title":"Generate speech or music","deprecated":null,"version":null,"openapi":"/openapi.v1.json post /v1/audio","href":"/api-reference/v1/generate-speech-or-music"},{"title":"Get credit balance","description":"Credits available to this key right now. Generations charge the organization's balance as the key's creator, so a per-member cap on that person applies here too.","deprecated":null,"version":null,"openapi":"/openapi.v1.json get /v1/credits","href":"/api-reference/v1/get-credit-balance"},{"title":"List generations","deprecated":null,"version":null,"openapi":"/openapi.v1.json get /v1/generations","href":"/api-reference/v1/list-generations"},{"title":"Get a generation","deprecated":null,"version":null,"openapi":"/openapi.v1.json get /v1/generations/{generation_id}","href":"/api-reference/v1/get-a-generation"},{"title":"Generate images","deprecated":null,"version":null,"openapi":"/openapi.v1.json post /v1/images","href":"/api-reference/v1/generate-images"},{"title":"List models","deprecated":null,"version":null,"openapi":"/openapi.v1.json get /v1/models","href":"/api-reference/v1/list-models"},{"title":"Get a model","deprecated":null,"version":null,"openapi":"/openapi.v1.json get /v1/models/{model_id}","href":"/api-reference/v1/get-a-model"},{"title":"Estimate cost","deprecated":null,"version":null,"openapi":"/openapi.v1.json get /v1/models/{model_id}/estimate","href":"/api-reference/v1/estimate-cost"},{"title":"Create an upload","deprecated":null,"version":null,"openapi":"/openapi.v1.json post /v1/uploads","href":"/api-reference/v1/create-an-upload"},{"title":"Generate a video","deprecated":null,"version":null,"openapi":"/openapi.v1.json post /v1/videos","href":"/api-reference/v1/generate-a-video"}]}]}]},"basePath":"","title":"Generate speech or music - Ekly API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}