curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "elevenlabs-tts-turbo-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "voice": "Rachel",
    "speed": 1.08,
    "stability": 0.55,
    "similarity_boost": 0.78,
    "style": 0.12,
    "timestamps": false,
    "apply_text_normalization": "auto",
    "text": "Welcome to NovaDesk. Your workspace is ready, your calendar is synced, and your first customer briefing starts in ten minutes."
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2026-06-25T10:30:00"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.poyo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "elevenlabs-tts-turbo-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "voice": "Rachel",
    "speed": 1.08,
    "stability": 0.55,
    "similarity_boost": 0.78,
    "style": 0.12,
    "timestamps": false,
    "apply_text_normalization": "auto",
    "text": "Welcome to NovaDesk. Your workspace is ready, your calendar is synced, and your first customer briefing starts in ten minutes."
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2026-06-25T10:30:00"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

{
  "code": 123,
  "error": {
    "message": "<string>",
    "type": "<string>"
  }
}

After submission, a task_id will be returned. If you provided a callback_url, when the task status becomes finished or failed, a POST request will be sent to the callback_url.
Regardless of whether callback_url is provided, you can retrieve the result through the unified Query Task Status endpoint.

ElevenLabs TTS Turbo v2.5

elevenlabs-tts-turbo-2-5 converts text inputs into low-latency multilingual speech audio. Results are returned as task files, matching the standard image, video, 3D, and audio task response structure.

Available Model

elevenlabs-tts-turbo-2-5 - ElevenLabs TTS Turbo v2.5 text-to-speech generation

Required Parameters

text: Text to convert to speech
- Length: 1-40000 characters
- Billing is calculated from text.trim().length
- Use previous_text and next_text when splitting long-form narration into multiple requests

Optional Parameters

voice: Voice name or compatible voice ID for speech generation. Default: Rachel
stability: Voice stability from 0 to 1. Default: 0.5
similarity_boost: Voice similarity boost from 0 to 1. Default: 0.75
style: Style exaggeration from 0 to 1. Default: 0
speed: Speech speed from 0.7 to 1.2. Default: 1
timestamps: Boolean. When true, timestamp data may be returned with the generated audio
previous_text: Optional context that came before text, useful for long-form continuity
next_text: Optional context that comes after text, useful for long-form continuity
language_code: Optional ISO 639-1 code used to enforce a target language, such as en, fr, de, ja, vi, hu, or no
apply_text_normalization: auto, on, or off. Default: auto

Credit Billing

Billing is calculated by trimmed text length: 8 credits per 1000 characters. PoYo is priced at $0.04 / 1000 characters; the Fal reference price is $0.05 / 1000 characters.

Request Examples

Low-latency product voiceover

Estimated usage: 126 billable characters, 1.008000 credits.

{
  "model": "elevenlabs-tts-turbo-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "text": "Welcome to NovaDesk. Your workspace is ready, your calendar is synced, and your first customer briefing starts in ten minutes.",
    "voice": "Rachel",
    "speed": 1.08,
    "stability": 0.55,
    "similarity_boost": 0.78,
    "style": 0.12,
    "timestamps": false,
    "apply_text_normalization": "auto"
  }
}

Localized pickup notification

Estimated usage: 88 billable characters, 0.704000 credits.

{
  "model": "elevenlabs-tts-turbo-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "text": "Bonjour, votre commande est prete. Merci de presenter votre code de retrait a l'accueil.",
    "voice": "Aria",
    "language_code": "fr",
    "stability": 0.6,
    "similarity_boost": 0.75,
    "speed": 1,
    "timestamps": true,
    "apply_text_normalization": "auto"
  }
}

Long-form continuity

Estimated usage: 97 billable characters, 0.776000 credits.

{
  "model": "elevenlabs-tts-turbo-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "previous_text": "The city lights faded behind the train.",
    "text": "Mira lowered her voice and said, keep the map close. By sunrise, everyone will be looking for it.",
    "next_text": "The carriage fell silent as the tunnel opened ahead.",
    "voice": "Sarah",
    "stability": 0.42,
    "similarity_boost": 0.82,
    "style": 0.35,
    "speed": 0.94,
    "apply_text_normalization": "auto"
  }
}

Expressive host intro

Estimated usage: 108 billable characters, 0.864000 credits.

{
  "model": "elevenlabs-tts-turbo-2-5",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "text": "Tonight, the gallery opens with a quiet piano note, then the host welcomes every guest with calm confidence.",
    "voice": "Laura",
    "stability": 0.48,
    "similarity_boost": 0.8,
    "style": 0.4,
    "speed": 0.98,
    "apply_text_normalization": "auto"
  }
}

Notes

PoYo’s public parameter name is text.
Fal reference pricing is $0.05 / 1000 characters; PoYo pricing is $0.04 / 1000 characters.
Query status through the standard task status API.
Successful responses return files, where the generated speech uses file_type: audio.

Authorizations

Authorization

string

header

required

All API endpoints require Bearer Token authentication.

Get your API Key from the API Key Management Page.

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

required

Model identifier.

Available options:

elevenlabs-tts-turbo-2-5

Example:

"elevenlabs-tts-turbo-2-5"

input

object

required

Show child attributes

callback_url

string<uri>

Webhook callback URL for result notifications

Example:

"https://your-domain.com/callback"

Response

Task submitted successfully

code

integer

required

Example:

200

data

object

required

Show child attributes

Overview

Image Model

Video Model

Music Model

Chat Model

3D Model

Task Management

ElevenLabs TTS Turbo v2.5

ElevenLabs TTS Turbo v2.5

Available Model

Required Parameters

Optional Parameters

Credit Billing

Request Examples

Low-latency product voiceover

Localized pickup notification

Long-form continuity

Expressive host intro

Notes

Authorizations

Body

Response

​ElevenLabs TTS Turbo v2.5

​Available Model

​Required Parameters

​Optional Parameters

​Credit Billing

​Request Examples

​Low-latency product voiceover

​Localized pickup notification

​Long-form continuity

​Expressive host intro

​Notes

Authorizations

Body

Response

ElevenLabs TTS Turbo v2.5

Available Model

Required Parameters

Optional Parameters

Credit Billing

Request Examples

Low-latency product voiceover

Localized pickup notification

Long-form continuity

Expressive host intro

Notes