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."}
]
}'
const job = await client.ttsGeneration.batchSynthesizeV1TtsBatchPost({
items: [
{ speakerId: "speaker-1", text: "First sentence." },
{ speakerId: "speaker-2", text: "Second sentence." },
{ speakerId: "speaker-3", text: "Third sentence." },
],
});
console.log(job.jobId);
// Use jobs.getJobV1JobsJobIdGet() to track progress
{
"job_id": "job_abc123xyz",
"status": "pending",
"total_items": 3,
"created_at": "2024-01-15T10:30:00Z"
}
{
"detail": "Batch exceeds maximum of 100 items"
}
TTS Generation
Batch Synthesize
Generate speech for multiple texts asynchronously
POST
/
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."}
]
}'
const job = await client.ttsGeneration.batchSynthesizeV1TtsBatchPost({
items: [
{ speakerId: "speaker-1", text: "First sentence." },
{ speakerId: "speaker-2", text: "Second sentence." },
{ speakerId: "speaker-3", text: "Third sentence." },
],
});
console.log(job.jobId);
// Use jobs.getJobV1JobsJobIdGet() to track progress
{
"job_id": "job_abc123xyz",
"status": "pending",
"total_items": 3,
"created_at": "2024-01-15T10:30:00Z"
}
{
"detail": "Batch exceeds maximum of 100 items"
}
Request Body
array
required
Response
string
required
Unique job identifier to track progress
string
required
Initial job status:
pendinginteger
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."}
]
}'
const job = await client.ttsGeneration.batchSynthesizeV1TtsBatchPost({
items: [
{ speakerId: "speaker-1", text: "First sentence." },
{ speakerId: "speaker-2", text: "Second sentence." },
{ speakerId: "speaker-3", text: "Third sentence." },
],
});
console.log(job.jobId);
// Use jobs.getJobV1JobsJobIdGet() to track progress
{
"job_id": "job_abc123xyz",
"status": "pending",
"total_items": 3,
"created_at": "2024-01-15T10:30:00Z"
}
{
"detail": "Batch exceeds maximum of 100 items"
}
Next Steps
After creating a batch job, use the Get Job endpoint to track progress and retrieve results.⌘I