Job parameters
| Field | Required | Notes |
|---|---|---|
script |
yes | 10–5000 chars, the narration text |
voiceId |
yes | a voice preset id from GET /v1/voices |
style |
no | cinematic (default), animated, lofi |
language |
no | ISO code, default pl |
durationMs |
no | 3000–60000; auto-derived if omitted |
narrationSpeed |
no | 0.7–1.2 |
webhookUrl |
no | receives job.done / job.failed |
Send an Idempotency-Key header to make retries safe — the same key on the same
account returns the original job instead of creating a duplicate.