elevenlabs/text-to-dialogue-v3
This page is generated from the upstream official OpenAPI documentation. Endpoints, parameters and examples match the official docs; brand and API domain are replaced with ModelFold.
Endpoint
POST /jobs/createTask
Full URL: https://ai.modelfold.online/v1/jobs/createTask
Authentication: every request must include the
Authorization: Bearer <API_KEY>header.
Dialogue text-to-speech generation using elevenlabs/text-to-dialogue-v3
Query Task Status
After submitting a task, use the unified query endpoint to check progress and retrieve results:
- Get Task Details — Learn how to query task status and retrieve generation results
TIP
For production use, we recommend using the callBackUrl parameter to receive automatic notifications when generation completes, rather than polling the status endpoint.
Related Resources
- Market Overview — Explore all available models
- File Upload API — Learn how to upload and manage files
- Common API — Check credits and account usage
Request Parameters
Body (application/json)
| Parameter | Type | Required | Description |
|---|---|---|---|
model | string | Yes | The model name to use for generation. Required field. - Must be elevenlabs/text-to-dialogue-v3 for this endpoint Default："elevenlabs/text-to-dialogue-v3"。 Allowed values：elevenlabs/text-to-dialogue-v3。 示例：elevenlabs/text-to-dialogue-v3。 |
callBackUrl | string | No | The URL to receive generation task completion updates. Optional but recommended for production use. - System will POST task status and results to this URL when generation completes - Callback includes generated content URLs and task information - Your callback endpoint should accept POST requests with JSON payload containing results - Alternatively, use the Get Task Details endpoint to poll task status - To ensure callback security, see Webhook Verification Guide for signature verification implementation 示例： https://your-domain.com/api/callback。 |
input | object | Yes | Input parameters for the generation task |
input.dialogue | array<object> | Yes | Array of dialogue items. Each item contains text and voice. The total character count of all text fields combined must not exceed 5000 characters. |
input.dialogue[].text | string | Yes | The dialogue text content. All text fields in the dialogue array combined must not exceed 5000 characters. 示例：I have a pen, I have an apple, ah, Apple pen~。 |
input.dialogue[].voice | string | Yes | The voice to use for speech generation. Can be a preset voice name (e.g. Rachel, Adam) or a voice ID. You can preview a voice by opening https://static.aiquickdraw.com/elevenlabs/voice/<voice_id>.mp3 in your browser (replace <voice_id> with the actual voice ID). For example: https://static.aiquickdraw.com/elevenlabs/voice/N2lVS1w4EtoT3dr4eOWO.mp3 Available voices: EkK5I93UQWFDigLMpZcX - James - Husky, Engaging and Bold Z3R5wn05IrDiVCyEkUrK - Arabella - Mysterious and Emotive NNl6r8mD7vthiJatiJt1 - Bradford - Expressive and Articulate YOq2y2Up4RgXP2HyXjE5 - Xavier - Dominating, Metallic Announcer B8gJV1IhpuegLxdpXFOE - Kuon - Cheerful, Clear and Steady 2zRM7PkgwBPiau2jvVXc - Monika Sogam - Deep and Natural 1SM7GgM6IMuvQlz2BwM3 - Mark - Casual, Relaxed and Light 5l5f8iK3YPeGga21rQIX - Adeline - Feminine and Conversational scOwDtmlUjD3prqpp97I - Sam - Support Agent NOpBlnGInO9m6vDvFkFC - Spuds Oxley - Wise and Approachable BZgkqPqms7Kj9ulSkVzn - Eve - Authentic, Energetic and Happy wo6udizrrtpIxWGp2qJk - Northern Terry gU0LNdkMOQCOrPrwtbee - British Football Announcer DGzg6RaUqxGRTHSBjfgF - Brock - Commanding and Loud Sergeant x70vRnQBMBu4FAYhjJbO - Nathan - Virtual Radio Host Sm1seazb4gs7RSlUVw7c - Anika - Animated, Friendly and Engaging P1bg08DkjqiVEzOn76yG - Viraj - Rich and Soft qDuRKMlYmrm8trt5QyBn - Taksh - Calm, Serious and Smooth qXpMhyvQqiRxWQs4qSSB - Horatius - Energetic Character Voice TX3LPaxmHKxFdv7VOQHJ - Liam - Energetic, Social Media Creator N2lVS1w4EtoT3dr4eOWO - Callum - Husky Trickster FGY2WhTYpPnrIDTdsKH5 - Laura - Enthusiast, Quirky Attitude kPzsL2i3teMYv0FxEYQ6 - Brittney - Social Media Voice - Fun, Youthful & Informative UgBBYS2sOqTuMpoF3BR0 - Mark - Natural Conversations hpp4J3VqNfWAUOO0d1Us - Bella - Professional, Bright, Warm nPczCjzI2devNBz1zQrb - Brian - Deep, Resonant and Comforting uYXf8XasLslADfZ2MB4u - Hope - Bubbly, Gossipy and Girly gs0tAILXbY5DNrJrsM6F - Jeff - Classy, Resonating and Strong DTKMou8ccj1ZaWGBiotd - Jamahal - Young, Vibrant, and Natural vBKc2FfBKJfcZNyEt1n6 - Finn - Youthful, Eager and Energetic DYkrAHD8iwork3YSUBbs - Tom - Conversations & Books 56AoDkrOh6qfVPDXZ7Pt - Cassidy - Crisp, Direct and Clear eR40ATw9ArzDf9h3v7t7 - Addison 2.0 - Australian Audiobook & Podcast g6xIsTj2HwM6VR4iXFCw - Jessica Anne Bogart - Chatty and Friendly lcMyyd2HUfFzxdCaC4Ta - Lucy - Fresh & Casual 6aDn1KB0hjpdcocrUkmq - Tiffany - Natural and Welcoming Sq93GQT4X1lKDXsQcixO - Felix - Warm, Positive & Contemporary RP flHkNRp1BlvT73UL6gyz - Jessica Anne Bogart - Eloquent Villain 9yzdeviXkFddZ4Oz8Mok - Lutz - Chuckling, Giggly and Cheerful pPdl9cQBQq4p6mRkZy2Z - Emma - Adorable and Upbeat zYcjlYFOd3taleS0gkk3 - Edward - Loud, Confident and Cocky nzeAacJi50IvxcyDnMXa - Marshal - Friendly, Funny Professor ruirxsoakN0GWmGNIo04 - John Morgan - Gritty, Rugged Cowboy TC0Zp7WVFzhA8zpTlRqV - Aria - Sultry Villain ljo9gAlSqKOvF6D8sOsX - Viking Bjorn - Epic Medieval Raider PPzYpIqttlTYA83688JI - Pirate Marshal 8JVbfL6oEdmuxKn5DK2C - Johnny Kid - Serious and Calm Narrator iCrDUkL56s3C8sCRl7wb - Hope - Poetic, Romantic and Captivating wJqPPQ618aTW29mptyoc - Ana Rita - Smooth, Expressive and Bright EiNlNiXeDU1pqqOPrYMO - John Doe - Deep 4YYIPFl9wE5c4L2eu2Gb - Burt Reynolds™ - Deep, Smooth and Clear 6F5Zhi321D3Oq7v1oNT4 - Hank - Deep and Engaging Narrator YXpFCvM1S3JbWEJhoskW - Wyatt - Wise Rustic Cowboy LG95yZDEHg6fCZdQjLqj - Phil - Explosive, Passionate Announcer CeNX9CMwmxDxUF5Q2Inm - Johnny Dynamite - Vintage Radio DJ aD6riP1btT197c6dACmy - Rachel M - Pro British Radio Presenter mtrellq69YZsNwzUSyXh - Rex Thunder - Deep N Tough dHd5gvgSOzSfduK4CvEg - Ed - Late Night Announcer eVItLK1UvXctxuaRV2Oq - Jean - Alluring and Playful Femme Fatale esy0r39YPLQjOczyOib8 - Britney - Calm and Calculative Villain Tsns2HvNFKfGiNjllgqo - Sven - Emotional and Nice 1U02n4nD6AdIZ9CjF053 - Viraj - Smooth and Gentle AeRdCCKzvd23BpJoofzx - Nathaniel - Engaging, British and Calm LruHrtVF6PSyGItzMNHS - Benjamin - Deep, Warm, Calming 1wGbFxmAM3Fgw63G1zZJ - Allison - Calm, Soothing and Meditative hqfrgApggtO1785R4Fsn - Theodore HQ - Serene and Grounded MJ0RnG71ty4LH3dvNfSd - Leon - Soothing and Grounded Default： "EkK5I93UQWFDigLMpZcX"。 Allowed values：EkK5I93UQWFDigLMpZcX / Z3R5wn05IrDiVCyEkUrK / NNl6r8mD7vthiJatiJt1 / YOq2y2Up4RgXP2HyXjE5 / B8gJV1IhpuegLxdpXFOE / 2zRM7PkgwBPiau2jvVXc / 1SM7GgM6IMuvQlz2BwM3 / 5l5f8iK3YPeGga21rQIX / scOwDtmlUjD3prqpp97I / NOpBlnGInO9m6vDvFkFC / BZgkqPqms7Kj9ulSkVzn / wo6udizrrtpIxWGp2qJk / gU0LNdkMOQCOrPrwtbee / DGzg6RaUqxGRTHSBjfgF / x70vRnQBMBu4FAYhjJbO / Sm1seazb4gs7RSlUVw7c / P1bg08DkjqiVEzOn76yG / qDuRKMlYmrm8trt5QyBn / qXpMhyvQqiRxWQs4qSSB / TX3LPaxmHKxFdv7VOQHJ / N2lVS1w4EtoT3dr4eOWO / FGY2WhTYpPnrIDTdsKH5 / kPzsL2i3teMYv0FxEYQ6 / UgBBYS2sOqTuMpoF3BR0 / hpp4J3VqNfWAUOO0d1Us / nPczCjzI2devNBz1zQrb / uYXf8XasLslADfZ2MB4u / gs0tAILXbY5DNrJrsM6F / DTKMou8ccj1ZaWGBiotd / vBKc2FfBKJfcZNyEt1n6 / DYkrAHD8iwork3YSUBbs / 56AoDkrOh6qfVPDXZ7Pt / eR40ATw9ArzDf9h3v7t7 / g6xIsTj2HwM6VR4iXFCw / lcMyyd2HUfFzxdCaC4Ta / 6aDn1KB0hjpdcocrUkmq / Sq93GQT4X1lKDXsQcixO / flHkNRp1BlvT73UL6gyz / 9yzdeviXkFddZ4Oz8Mok / pPdl9cQBQq4p6mRkZy2Z / zYcjlYFOd3taleS0gkk3 / nzeAacJi50IvxcyDnMXa / ruirxsoakN0GWmGNIo04 / TC0Zp7WVFzhA8zpTlRqV / ljo9gAlSqKOvF6D8sOsX / PPzYpIqttlTYA83688JI / 8JVbfL6oEdmuxKn5DK2C / iCrDUkL56s3C8sCRl7wb / wJqPPQ618aTW29mptyoc / EiNlNiXeDU1pqqOPrYMO / 4YYIPFl9wE5c4L2eu2Gb / 6F5Zhi321D3Oq7v1oNT4 / YXpFCvM1S3JbWEJhoskW / LG95yZDEHg6fCZdQjLqj / CeNX9CMwmxDxUF5Q2Inm / aD6riP1btT197c6dACmy / mtrellq69YZsNwzUSyXh / dHd5gvgSOzSfduK4CvEg / eVItLK1UvXctxuaRV2Oq / esy0r39YPLQjOczyOib8 / Tsns2HvNFKfGiNjllgqo / 1U02n4nD6AdIZ9CjF053 / AeRdCCKzvd23BpJoofzx / LruHrtVF6PSyGItzMNHS / 1wGbFxmAM3Fgw63G1zZJ / hqfrgApggtO1785R4Fsn / MJ0RnG71ty4LH3dvNfSd。 示例：EkK5I93UQWFDigLMpZcX。 |
input.stability | number | No | Voice stability parameter. Must be one of the following values: 0.0, 0.5, or 1.0 Default：0.5。 Allowed values：0 / 0.5 / 1。 示例：0.5。 |
input.language_code | string | No | Language code for the speech. Default is empty string or omit the parameter for automatic language detection. Allowed values：af / ar / hy / as / az / be / bn / bs / bg / ca / ceb / ny / hr / cs / da / nl / en / et / fil / fi / fr / gl / ka / de / el / gu / ha / he / hi / hu / is / id / ga / it / ja / jv / kn / kk / ky / ko / lv / ln / lt / lb / mk / ms / ml / zh / mr / ne / no / ps / fa / pl / pt / pa / ro / ru / sr / sd / sk / sl / so / es / sw / sv / ta / te / th / tr / uk / ur / vi / cy。 示例：af。 |
Request Example
bash
curl -X POST "https://ai.modelfold.online/v1/jobs/createTask" \
-H "Authorization: Bearer $MODELFOLD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "elevenlabs/text-to-dialogue-v3",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"dialogue": [
{
"text": "I have a pen, I have an apple, ah, Apple pen~",
"voice": "EkK5I93UQWFDigLMpZcX"
},
{
"text": "a happy dog",
"voice": "Z3R5wn05IrDiVCyEkUrK"
},
{
"text": "a happy cat",
"voice": "NNl6r8mD7vthiJatiJt1"
}
],
"stability": 0.5
}
}'json
{
"model": "elevenlabs/text-to-dialogue-v3",
"callBackUrl": "https://your-domain.com/api/callback",
"input": {
"dialogue": [
{
"text": "I have a pen, I have an apple, ah, Apple pen~",
"voice": "EkK5I93UQWFDigLMpZcX"
},
{
"text": "a happy dog",
"voice": "Z3R5wn05IrDiVCyEkUrK"
},
{
"text": "a happy cat",
"voice": "NNl6r8mD7vthiJatiJt1"
}
],
"stability": 0.5
}
}Response
200 — Request successful
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | integer | 否 | Status code of the request. The HTTP status is 200 even when the request fails, so always check this field: 200 means success; any other value means the request failed and msg describes the reason. Common values: 401 invalid or missing API key; 402 insufficient credits; 429 rate limit exceeded; 422 or 500 the request could not be processed (read msg and check your parameters before retrying). 可选值：200 / 401 / 402 / 404 / 422 / 429 / 455 / 500 / 501 / 505。 示例：200。 |
msg | string | 否 | Response message, error description when failed 示例：success。 |
data | object | 是 | — |
data.taskId | string | 否 | Task ID, can be used with Get Task Details endpoint to query task status |
data.recordId | string | 否 | Record ID, can be used to get the record details |
json
{
"code": 200,
"msg": "success",
"data": {
"taskId": "task_elevenlabs_1765185448724",
"recordId": "elevenlabs_1765185448724"
}
}500 — Server error.
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | integer | 是 | Response status code - 200: Success - Request has been processed successfully - 401: Unauthorized - Authentication credentials are missing or invalid - 402: Insufficient Credits - Account does not have enough credits to perform the operation - 404: Not Found - The requested resource or endpoint does not exist - 408: Timeout - No result has been returned for over 10 minutes. - 422: Validation Error - The request parameters failed validation checks - 429: Rate Limited - Request limit has been exceeded for this resource - 455: Service Unavailable - System is currently undergoing maintenance - 500: Server Error - An unexpected error occurred while processing the request - 501: Generation Failed - Content generation task failed - 505: Feature Disabled - The requested feature is currently disabled |
msg | string | 是 | Response message, error description when failed |
data | object | 是 | — |
json
{
"code": 500,
"msg": "Server Error - An unexpected error occurred while processing the request",
"data": null
}Callback
musicTaskCompleted
Callback URL: {request.body#/callBackUrl} (the callBackUrl in the request body).
The system sends this callback when the audio task succeeds or fails.
Callback body parameters
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | integer | 是 | Unified callback code: 200 for success, 501 for failure. Allowed values：200 / 501。 示例：200。 |
msg | string | 是 | Unified callback message. Allowed values：Playground task completed successfully. / Playground task failed.。 示例：Playground task completed successfully.。 |
data | object | 是 | — |
data.taskId | string | 是 | The unique task identifier. |
data.model | string | 是 | The model used for the task. Allowed values：elevenlabs/text-to-dialogue-v3。 示例：elevenlabs/text-to-dialogue-v3。 |
data.state | string | 是 | Terminal task state. Allowed values：success / fail。 示例：success。 |
data.param | string | 是 | JSON string containing the submitted task parameters. |
data.resultJson | string | 否 | JSON string containing resultUrls and resultObject when successful. Present only when state is success. |
data.failCode | string | 否 | Failure code, a numeric string such as "400" or "500". Present only when state is fail. |
data.failMsg | string | 否 | Failure reason. Present only when state is fail. |
data.costTime | integer | 否 | Processing time in seconds. Present on both success and failure callbacks. |
data.completeTime | integer | 否 | Task completion timestamp. |
data.createTime | integer | 否 | Task creation timestamp. |
data.updateTime | integer | 否 | Use completeTime as the completion time; updateTime may equal createTime. |
data.creditsConsumed | number | 否 | Credits consumed by the task; 0 for failed tasks. |
Task completed successfully
json
{
"code": 200,
"msg": "Playground task completed successfully.",
"data": {
"taskId": "task_example_music_webhook_001",
"model": "elevenlabs/text-to-dialogue-v3",
"state": "success",
"param": "{\"input\":\"{\\\"dialogue\\\":[{\\\"text\\\":\\\"I have a pen, I have an apple, ah, Apple pen~\\\",\\\"voice\\\":\\\"EkK5I93UQWFDigLMpZcX\\\"}],\\\"stability\\\":0.5}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"elevenlabs/text-to-dialogue-v3\"}",
"resultJson": "{\"resultUrls\":[\"https://example.com/generated-audio.mp3\"],\"resultObject\":null}",
"costTime": 12,
"completeTime": 1234567890,
"createTime": 1234560000,
"updateTime": 1234567890,
"creditsConsumed": 1.23
}
}Task failed
json
{
"code": 501,
"msg": "Playground task failed.",
"data": {
"taskId": "task_example_music_webhook_001",
"model": "elevenlabs/text-to-dialogue-v3",
"state": "fail",
"param": "{\"input\":\"{\\\"dialogue\\\":[{\\\"text\\\":\\\"I have a pen, I have an apple, ah, Apple pen~\\\",\\\"voice\\\":\\\"EkK5I93UQWFDigLMpZcX\\\"}],\\\"stability\\\":0.5}\",\"callBackUrl\":\"https://example.com/callback\",\"model\":\"elevenlabs/text-to-dialogue-v3\"}",
"failCode": "400",
"failMsg": "<error detail>",
"costTime": 12,
"creditsConsumed": 0
}
}