API Guides

Async Tasks

Submit and poll image and video generation tasks.

Media generation uses a unified asynchronous task lifecycle:

pending → processing → ready
                    ↘ failed

After creating a task, use its numeric taskId to poll GET /api-platform/v1/tasks/{taskId}. Poll with exponential backoff and stop after the terminal status ready or failed.

The final response includes the output asset URLs. Temporary R2 inputs bound through the media upload API are deleted when the task reaches either terminal status.

Temporary Media Uploads

Stage reliable image, video, and audio inputs on PixMind R2 and clean them up with the generation task.

Errors and Retries

Handle normalized API errors and retry safely.