Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.unifically.com/llms.txt

Use this file to discover all available pages before exploring further.

Generate multi-voice dialogue audio using ElevenLabs eleven_v3 model with support for multiple speakers and emotion tags.

​
Model

elevenlabs/text-to-dialogue

​
Parameters

ParameterTypeRequiredDefaultDescription
dialoguearrayYes-Array of dialogue objects with text and voice
language_codestringNoenLanguage code for generation ("auto" defaults to "en")
stabilitynumberNo0.5Voice stability 0-1

​
Dialogue Object

Each item in the dialogue array must contain:
ParameterTypeRequiredDescription
textstringYesText for this speaker (supports emotion tags like [excitedly])
voicestringYesVoice ID for this speaker
Text-to-Dialogue always uses the eleven_v3 model - no model selection needed.

​
Resources

Get available voices from the Resources API: 
GET /v1/resources/elevenlabs/voices

​
Example

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "elevenlabs/text-to-dialogue",
    "input": {
      "stability": 0.5,
      "language_code": "auto",
      "dialogue": [
        {
          "text": "[excitedly] Hey Jessica! Have you tried the new ElevenLabs V3?",
          "voice": "TX3LPaxmHKxFdv7VOQHJ"
        },
        {
          "text": "[curiously] Yeah, just got it! The emotion is so amazing.",
          "voice": "cgSgspJ2msm6clMCkdW9"
        }
      ]
    }
  }'

​
Example - Longer Conversation

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "elevenlabs/text-to-dialogue",
    "input": {
      "stability": 0.6,
      "dialogue": [
        {
          "text": "[warmly] Welcome to the podcast! Today we have a special guest.",
          "voice": "TX3LPaxmHKxFdv7VOQHJ"
        },
        {
          "text": "[grateful] Thanks for having me! I am excited to be here.",
          "voice": "cgSgspJ2msm6clMCkdW9"
        },
        {
          "text": "[interested] So tell us about your latest project.",
          "voice": "TX3LPaxmHKxFdv7VOQHJ"
        },
        {
          "text": "[enthusiastically] Well, it all started last year when...",
          "voice": "cgSgspJ2msm6clMCkdW9"
        }
      ]
    }
  }'

​
Emotion Tags

You can add emotion tags in square brackets at the start of text to control the speaker’s tone:
  • [excitedly] - Excited, energetic delivery
  • [curiously] - Questioning, interested tone
  • [warmly] - Friendly, welcoming tone
  • [sadly] - Melancholic delivery
  • [angrily] - Frustrated, angry tone
  • [whispered] - Quiet, whispered speech
  • [shouted] - Loud, shouted delivery

​
Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "pending"
  }
}

​
Completed Response

{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "completed",
    "output": {
      "audio_url": "https://files.storagecdn.online/abc123.mp3"
    }
  }
}