async/tts-pro-v1.0
Speech · Up to $10.45 per 1M characters
Endpoint
POST /v1/audio/speech — answers 202 with a job. Poll GET /v1/jobs/{id}, or receive it by webhook, until its state is final.
Dependencies
No field depends on another.
Request
curl https://api.opinference.com/v1/audio/speech \
-H "Authorization: Bearer $OP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "async/tts-pro-v1.0",
"prompt": "a paper boat drifting down a rain gutter"
}'Response
The job resource once it has succeeded.
{
"id": "job_01J9K2…",
"generation_id": "gen_01J9K2…",
"object": "job",
"state": "succeeded",
"modality": "audio_tts",
"model": "async/tts-pro-v1.0",
"created_at": "2026-09-30T08:00:00Z",
"started_at": "2026-09-30T08:00:04Z",
"completed_at": "2026-09-30T08:01:12Z",
"output": [
{
"url": "https://…?X-Amz-Signature=…",
"url_expires_at": "2026-09-30T09:01:12Z",
"type": "audio/mpeg",
"bytes": 196413,
"checksum_sha256": "…"
}
],
"usage": {
"units": {
"audio_second": 12
}
}
}Input
A JSON body. A key not listed here is refused, and the error names it.
| Field | Description |
|---|---|
| modelstring · required | The id of this model. |
| promptstring · required | The text to speak. |
| languageenum | The language of the speech.One of: en, fr, es, de, it, pt |
| voiceenum | The voice that speaks.One of: Jennie, Stella, Max, Hayes, Elara, Cleo, Fisher, Corin, Thaddeus, Lucina, Acadia, Huxley, Winslet, Jethro, Elio, Rupert, Eira, Nyra, Arian, Lily, Pierce, Kaela, Elowen, Freya, Lenny, Alessa, Pandora, Fia, Abbott, Kael, Orla, Sable, Marnie, Sera, Virel, Liora, Riven, Elys, Dreena, Rhea, Vela, Nymera, Isolde, Lirien, Zella, Avenna, Mirelle, Calia, Lunea, Lucan, Tarian, Arlo, Jovan, Neron, Ziven, Dax, Orien, Lior, Eryx, Tyren, Nox, Elric, Varian, Zoran, Miro, Dalen, Ronix, Jarek, Nyxie, Soren, Viona, Selene, Rachiel, Corbin, Abigail, Faith, Kimberly, Dave, Grace, Alden, Renly, Violet, Joel, Xavier, Esmeralda, Robert, Lila, Brooks, Lennox, Vanessa, Simon, Nyomi, Jack, Penelope, Brayden, Abel, Nellie, Connie, Andrew, Lincoln · Default: Jennie |
| modelsstring[] | Other model ids to try, in order, if this one is unavailable. Up to 5. |
| providerobject | Routing preferences: region, zdr, data_collection, sort, max_price. |
| opobject | Gateway options: retention (may only tighten), tags, session_id. |
Output
A job resource.
| Field | Description |
|---|---|
| id | The job id. Poll GET /v1/jobs/{id} with it. |
| generation_id | The generation this job belongs to. |
| object | Always "job". |
| state | queued, processing, succeeded, failed or canceled. The last three are final. |
| modality | The kind of output. |
| model | The model id that was asked for. |
| created_at | When the job was accepted. |
| started_at | When work began. Absent while queued. |
| completed_at | When the job reached a final state. |
| progress.percent | Percent complete, 0 to 100, or null when not reported. |
| progress.phase | queued, running or done. |
| progress.queue_position | Always null today. |
| output[] | The files produced: url (signed, re-issued on every read), url_expires_at, type, bytes, checksum_sha256. |
| usage | The billable units the job consumed. |
| usage.cost | An estimate from the published price: billing_usd, cost_source, cost_status ("estimated") and price_version. Your balance is charged the settled amount. |
| op_metadata | What applied when the job was accepted: generation_id, requested_model, retention_class, region and policy[]. |
| error | On failure: code, kind and a fixed message for the code. |