Skip to main content
POST
Media and embeddings
Media routes use the same native payment behavior as text inference. Status polling routes are not billable; the charge happens on generation submission.

Routes

Common headers

string
Bearer compose-... for Compose Key billing.
string
Raw x402 payment signature for x402-aware clients.

Common fields

string
required
Public catalog model ID.
string
Required for image and video generation.
string | array
Required for speech and embeddings.
string
Required for audio transcription. The route expects base64 content.
string
Required for image edits; also accepted as an initial image for some video models.
string
URL form of an input image.

Video status stream

number
Poll interval for /v1/videos/{id}/stream. Default 2000, minimum 500, maximum 30000.
number
Stream timeout. Default 600000, minimum 5000, maximum 3600000.
The stream emits compose.video.status, compose.error, and data: [DONE].