Async Jobs

Most generation endpoints (/producer/*, /suno/*, /mvs/*) are asynchronous: the POST returns a job descriptor immediately and you poll /api/v1/tasks/{jobId} until terminal state.

Lifecycle

queued ──► processing ──► succeeded
                     │
                     └──► failed
                     │
                     └──► cancelled

Terminal states: succeeded, failed, cancelled. Polling stops at terminal.

Polling strategy

We recommend exponential backoff with a cap:

Attempt	Wait
1	60s
2	90s
3	135s
4	180s (capped)
N	180s

These numbers match the server-side polling we use internally to providers. Polling more aggressively will not surface results faster and will burn rate-limit budget.

Timeouts

• Default soft timeout: 10 minutes (job marked failed with code: TIMEOUT).
• Image jobs typically finish in < 30s; music in 30–90s; MV renders 2–6 minutes.

Webhooks

Not yet available. Track Changelog for delivery date.