Skip to main content
POST
https://api.destined.ai
/
v1
/
tts
/
batch
curl -X POST "https://api.destined.ai/v1/tts/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"speaker_id": "speaker-1", "text": "First sentence."},
      {"speaker_id": "speaker-2", "text": "Second sentence."},
      {"speaker_id": "speaker-3", "text": "Third sentence."}
    ]
  }'

{
  "job_id": "job_abc123xyz",
  "status": "pending",
  "total_items": 3,
  "created_at": "2024-01-15T10:30:00Z"
}

​
Request Body

​
items
array
required
Array of synthesis requests (max 100 items)

​
Response

​
job_id
string
required
Unique job identifier to track progress
​
status
string
required
Initial job status: pending
​
total_items
integer
required
Number of items in the batch
curl -X POST "https://api.destined.ai/v1/tts/batch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"speaker_id": "speaker-1", "text": "First sentence."},
      {"speaker_id": "speaker-2", "text": "Second sentence."},
      {"speaker_id": "speaker-3", "text": "Third sentence."}
    ]
  }'

{
  "job_id": "job_abc123xyz",
  "status": "pending",
  "total_items": 3,
  "created_at": "2024-01-15T10:30:00Z"
}

​
Next Steps

After creating a batch job, use the Get Job endpoint to track progress and retrieve results.