> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apisale.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ElevenLabs Dialogue — Text To Dialogue

> ElevenLabs Eleven v3 text-to-dialogue. Optimized for text to dialogue via apisale.

## Overview

ElevenLabs Eleven v3 text-to-dialogue. Optimized for text to dialogue via apisale.

<Info>
  **Docs** = API contract + Try it (snapshot). **[Explore](https://apisale.ai/explore)** = browser playground. **[Model page](https://apisale.ai/models/elevenlabs/elevenlabs-dialogue/text-to-dialogue)** = product examples.
</Info>

## Endpoint

```http theme={null}
POST https://api.apisale.ai/v1/run/elevenlabs/elevenlabs-dialogue/text-to-dialogue
```

|                |                                                   |
| -------------- | ------------------------------------------------- |
| **Model slug** | `elevenlabs/elevenlabs-dialogue/text-to-dialogue` |
| **Category**   | Text To Dialogue (`text-to-dialogue`)             |
| **Lab**        | Elevenlabs                                        |
| **Mode**       | async                                             |

## Pricing

**From \$0.0001/character**

apisale price is **30%** below the vendor's official list price.

| Tier           | Unit      | Official price | apisale price |
| -------------- | --------- | -------------- | ------------- |
| \$0.1/1k chars | character | \$0.0001       | \$0.0001      |

<Info>
  **Official price** = vendor list price. **apisale price** = what you pay through apisale.
</Info>

## Request

```json theme={null}
{‌
  "input": {‌
    "stability": 0.5,
    "inputs": [
      {‌
        "text": "The light on those cliffs is extraordinary.",
        "voice": "Aria"
      },
      {‌
        "text": "It feels like a Malick frame.",
        "voice": "Roger"
      }
    ]
  }
}
```

### Parameters

Fields marked \* are required. Use `Authorization: Key YOUR_API_KEY` for REST.

<ParamField body="input.inputs" type="array" required>
  Dialogue turns: \[\{ text, voice }]
</ParamField>

<ParamField body="input.stability" type="number">
  Default: `0.5` Range: 0 – 1
</ParamField>

<ParamField body="input.language_code" type="string">
  —
</ParamField>

<ParamField body="webhook_url" type="string">
  Optional HTTPS webhook when the run reaches a terminal state.
</ParamField>

<ParamField body="sync" type="boolean">
  Block until completion (same Run response shape).
</ParamField>

<AccordionGroup>
  <Accordion title="Input schema">
    ```json expandable theme={null}
    {‌
      "params": {‌
        "inputs": {‌
          "type": "array",
          "required": true,
          "description": "Dialogue turns: [{‌ text, voice }]"
        },
        "stability": {‌
          "max": 1,
          "min": 0,
          "type": "number",
          "default": 0.5
        },
        "language_code": {‌
          "type": "string"
        }
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Submit response

Returns a **Run** with `run_id`. Poll with [GET /v1/runs/\{run\_id}](/model-apis/poll-runs) or use **Try it** above.

<ResponseField name="run_id" type="string" required>
  Unique run ID — save for polling and webhooks.
</ResponseField>

<ResponseField name="status" type="string" required>
  `queued` (async) or terminal state for sync runs.
</ResponseField>

<ResponseField name="output" type="object">
  Result when `status` is `succeeded` — see **Output schema** below.
</ResponseField>

### Example (async submit)

```json theme={null}
{
  "run_id": "run_550e8400-e29b-41d4-a716-446655440000",
  "endpoint": "elevenlabs/elevenlabs-dialogue/text-to-dialogue",
  "model": "text-to-dialogue",
  "capability": "audio",
  "mode": "text-to-dialogue",
  "status": "queued",
  "output": null,
  "error": null,
  "billing": null,
  "created_at": "2026-06-27T12:00:00.000Z",
  "started_at": null,
  "completed_at": null,
  "elapsed_ms": null
}
```

Full lifecycle: [Runs lifecycle](/model-apis/runs-lifecycle).

## Output

When `status` is `succeeded`, `output` follows this schema:

<AccordionGroup>
  <Accordion title="Output schema">
    ```json expandable theme={null}
    {‌
      "type": "object",
      "example": {‌
        "audio": {‌
          "url": "https://example.com/out.mp3",
          "content_type": "audio/mpeg"
        }
      },
      "required": [
        "audio"
      ],
      "properties": {‌
        "audio": {‌
          "type": "object",
          "required": [
            "url"
          ],
          "properties": {‌
            "url": {‌
              "type": "string"
            },
            "file_name": {‌
              "type": "string"
            },
            "content_type": {‌
              "type": "string"
            }
          }
        }
      },
      "description": "Succeeded task output: audio file."
    }
    ```
  </Accordion>
</AccordionGroup>

## Example

```bash theme={null}
curl -X POST "https://api.apisale.ai/v1/run/elevenlabs/elevenlabs-dialogue/text-to-dialogue" \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "stability": 0.5,
    "inputs": [
      {
        "text": "The light on those cliffs is extraordinary.",
        "voice": "Aria"
      },
      {
        "text": "It feels like a Malick frame.",
        "voice": "Roger"
      }
    ]
  }
}'
```

## Related

* [Runs lifecycle](/model-apis/runs-lifecycle)
* [Audio API overview](/api/audio)
* [Account API](/get-started/account-and-monitoring)


## OpenAPI

````yaml openapi-catalog.json POST /v1/run/elevenlabs/elevenlabs-dialogue/text-to-dialogue
openapi: 3.0.3
info:
  title: apisale Model Catalog
  version: '2026-09-01T09:47:50.773Z'
  description: Per-model OpenAPI operations for Mintlify Try playground.
servers:
  - url: https://api.apisale.ai
security: []
paths:
  /v1/run/elevenlabs/elevenlabs-dialogue/text-to-dialogue:
    post:
      tags:
        - Model catalog
        - audio
        - Elevenlabs
      summary: Create ElevenLabs Dialogue — Text To Dialogue
      description: >-
        ElevenLabs Eleven v3 text-to-dialogue. Optimized for text to dialogue
        via apisale.
      operationId: submit-elevenlabs-elevenlabs-dialogue-text-to-dialogue
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - input
              properties:
                input:
                  type: object
                  properties:
                    inputs:
                      description: 'Dialogue turns: [{ text, voice }]'
                      type: array
                      items:
                        type: string
                    stability:
                      type: number
                      minimum: 0
                      maximum: 1
                      default: 0.5
                    language_code:
                      type: string
                  required:
                    - inputs
                  example:
                    stability: 0.5
                    inputs:
                      - text: The light on those cliffs is extraordinary.
                        voice: Aria
                      - text: It feels like a Malick frame.
                        voice: Roger
                webhook_url:
                  type: string
                  format: uri
                sync:
                  type: boolean
                  default: false
            example:
              input:
                stability: 0.5
                inputs:
                  - text: The light on those cliffs is extraordinary.
                    voice: Aria
                  - text: It feels like a Malick frame.
                    voice: Roger
      responses:
        '201':
          description: Run accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RunObject'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    RunObject:
      type: object
      required:
        - run_id
        - endpoint
        - model
        - capability
        - mode
        - status
        - created_at
      properties:
        run_id:
          type: string
          description: Unique run identifier
        endpoint:
          type: string
          description: Model slug
        model:
          type: string
        capability:
          type: string
        mode:
          type: string
        status:
          type: string
          enum:
            - queued
            - processing
            - succeeded
            - failed
            - timeout
            - cancelled
        output:
          type: object
          nullable: true
        error:
          type: object
          nullable: true
          properties:
            type:
              type: string
              description: Machine-readable error code
            code:
              type: number
              description: HTTP status
            message:
              type: string
        billing:
          type: object
          nullable: true
          properties:
            amount:
              type: string
            currency:
              type: string
              enum:
                - usd
        created_at:
          type: string
          format: date-time
        started_at:
          type: string
          format: date-time
          nullable: true
        completed_at:
          type: string
          format: date-time
          nullable: true
        elapsed_ms:
          type: number
          nullable: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Key sk-... (native REST) or Bearer sk-... (vendor SDKs)

````