## Basic model info - Model name: elevenlabs/elevenlabs eleven-v3 - Model description: - Endpoint name: text-to-dialogue ## Model schema The model schema is defined in the OpenAPI schema: [OpenAPI Schema](https://oapi.sunra.ai/main/elevenlabs/eleven-v3/latest.json) ### Model input schema The model input schema is: ```json { "description": "Input schema for ElevenLabs text-to-dialogue generation.", "properties": { "seed": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "description": "Random seed for reproducibility.", "title": "Seed", "x-sr-order": 403 }, "inputs": { "description": "A list of dialogue inputs, each containing text and a voice which will be converted into speech.", "items": { "description": "A single dialogue input with text and voice.", "properties": { "custom_voice_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Optional ElevenLabs voice ID for this dialogue block. When set, overrides `voice` for this block only. Discover available voice IDs via https://docs.sunra.ai/multimodal/elevenlabs-voices.md", "title": "Custom Voice Id" }, "text": { "description": "The dialogue text", "title": "Text", "type": "string" }, "voice": { "description": "The name of the voice to be used for the generation", "enum": [ "Roger", "Sarah", "Laura", "Charlie", "George", "Callum", "River", "Harry", "Liam", "Alice", "Matilda", "Will", "Jessica", "Eric", "Bella", "Chris", "Brian", "Daniel", "Lily", "Adam", "Bill" ], "title": "Voice", "type": "string" } }, "required": [ "text", "voice" ], "title": "DialogueBlock", "type": "object" }, "title": "Inputs", "type": "array", "x-sr-order": 200 }, "language_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Language code (ISO 639-1) used to enforce a language for the model.", "title": "Language Code", "x-sr-order": 404 }, "pronunciation_dictionary_locators": { "default": [ ], "description": "A list of pronunciation dictionary locators (id, version_id) to be applied to the text. You may have up to 3 locators per request.", "items": { "description": "A pronunciation dictionary locator.", "properties": { "pronunciation_dictionary_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The ID of the pronunciation dictionary.", "title": "Pronunciation Dictionary Id" }, "version_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "The ID of the version of the pronunciation dictionary. If not provided, the latest version will be used.", "title": "Version Id" } }, "title": "PronunciationDictionaryLocator", "type": "object" }, "title": "Pronunciation Dictionary Locators", "type": "array", "x-sr-order": 402 }, "stability": { "anyOf": [ { "maximum": 1, "minimum": 0, "type": "number" }, { "type": "null" } ], "description": "Determines how stable the voice is and the randomness between each generation. Must be one of 0.0, 0.5, 1.0.", "title": "Stability", "x-sr-order": 400 }, "use_speaker_boost": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "This setting boosts the similarity to the original speaker.", "title": "Use Speaker Boost", "x-sr-order": 401 } }, "required": [ "inputs" ], "title": "TextToDialogueInput", "type": "object" } ``` ### Model output schema The model output schema is: ```json { "description": "Output schema for ElevenLabs Eleven V3 text-to-speech generation.", "properties": { "audio": { "properties": { "content_type": { "description": "The mime type of the file.", "title": "Content Type", "type": "string" }, "file_name": { "description": "The name of the file. It will be auto-generated if not provided.", "title": "File Name", "type": "string" }, "file_size": { "description": "The size of the file in bytes.", "title": "File Size", "type": "integer" }, "url": { "description": "The URL where the file can be downloaded from.", "title": "Url", "type": "string" } }, "required": [ "content_type", "file_name", "file_size", "url" ], "title": "SunraFile", "type": "object" }, "input_character_count": { "title": "Input Character Count", "type": "integer" } }, "required": [ "audio", "input_character_count" ], "title": "ElevenV3Output", "type": "object" } ``` ## Example inputs and outputs Use the following example inputs and outputs to understand the model. ### Input example ```json { "seed": null, "inputs": [ ], "language_code": null, "pronunciation_dictionary_locators": [ ], "stability": null, "use_speaker_boost": null } ``` ### Output example ```json { } ``` ## Model code examples ### JavaScript ```javascript import { sunra } from "@sunra/client"; const result = await sunra.subscribe("elevenlabs/eleven-v3/text-to-dialogue", { input: { inputs: [], stability: null, use_speaker_boost: null, pronunciation_dictionary_locators: [], seed: null, language_code: null }, logs: true, onQueueUpdate: (update) => { console.log(`Status Update: ${update.status}, Request ID: ${update.request_id}`); }, }); console.log(result.data); console.log(result.requestId); ``` ### Python ```python import sunra_client result = sunra_client.subscribe( "elevenlabs/eleven-v3/text-to-dialogue", arguments={ "inputs": [], "stability": None, "use_speaker_boost": None, "pronunciation_dictionary_locators": [], "seed": None, "language_code": None }, with_logs=True, on_enqueue=print, on_queue_update=print, ) print(result) ``` ### Java ```java import ai.sunra.client.*; import java.util.Map; import com.google.gson.JsonObject; var client = SunraClient.withEnvCredentials(); var response = client.subscribe( "elevenlabs/eleven-v3/text-to-dialogue", SubscribeOptions.builder() .input(Map.of( "inputs", , "stability", null, "use_speaker_boost", null, "pronunciation_dictionary_locators", , "seed", null, "language_code", null)) .resultType(JsonObject.class) .onQueueUpdate(update -> System.out.printf( "\nStatus Update: %s, Request ID: %s%n", update.getStatus(), update.getRequestId() )) .logs(true) .build() ); System.out.println("Completed!"); System.out.println(response.getData()); ``` ### Kotlin ```kotlin import ai.sunra.client.kt.* import com.google.gson.JsonObject val client = createSunraClient() val response = client.subscribe( endpointId = "elevenlabs/eleven-v3/text-to-dialogue", input = mapOf( "inputs" to , "stability" to null, "use_speaker_boost" to null, "pronunciation_dictionary_locators" to , "seed" to null, "language_code" to null), options = ai.sunra.client.kt.SubscribeOptions(logs = true), onUpdate = { update -> println("\nStatus Update: ${update.status}, Request ID: ${update.requestId}") } ) println("Completed!") println(response.data) ``` ### Curl ```bash curl --request POST \ --url https://api.sunra.ai/v1/queue/elevenlabs/eleven-v3/text-to-dialogue \ --header "Authorization: Key $SUNRA_KEY" \ --header "Content-Type: application/json" \ --data '{"inputs":[],"stability":null,"use_speaker_boost":null,"pronunciation_dictionary_locators":[],"seed":null,"language_code":null}' ``` ## Model readme >