Skip to main content
The Unified API separates task submission from task completion. This keeps client timeouts short while image and video models continue working in the background.

​
Submit

POST /v1/task/submit accepts the common envelope:

​
Retrieve

GET /v1/task/{task_id} returns the current task state.
Only succeeded and failed are terminal. Clients should tolerate repeated reads of the same state.

​
Choose a completion strategy

Polling

Best for local tools, scripts, and the first integration.

Callbacks

Best for services that already expose a public HTTPS endpoint.
Polling and callbacks are complementary. Keep the read endpoint available as the recovery path when callback delivery is delayed.