Async Jobs

Use async jobs for long text, batch generation, or workflows where polling is acceptable.

POST /api/open/v1/speech/tts/jobs
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

{
  "text": "Hello from FishSpeech.",
  "voiceId": "YOUR_VOICE_ID",
  "engineModelId": "fishaudio-s2pro",
  "format": "mp3"
}

The create endpoint returns 202 Accepted with a task object.

GET /api/open/v1/speech/tts/jobs/{taskId}
Authorization: Bearer YOUR_API_TOKEN

Successful tasks include audioUrl when a short-lived audio URL can be generated.