Video
Poll or retrieve video
Poll the status of a video generation job, or retrieve the completed video.
Response depends on the current task status:
- queued/generating: Returns JSON with progress info
- completed (single variant): Returns raw MP4 binary (
Content-Type: video/mp4) - completed (multiple variants): Returns ZIP archive (
Content-Type: application/zip) - failed: Returns JSON with error details
Authorization
SIWx Sign-In-With-X<token>
Base64-encoded JSON envelope containing a CAIP-122 sign-in message and its cryptographic signature.
{
"message": "<CAIP-122 message>",
"signature": "<base58 for Solana, hex for EVM>"
}In: header
Request Body
application/json
task_id*string
Task ID returned by /video/queue.
wait_for_final?boolean
If true, the server blocks (up to ~30s) waiting for the task to finish.
user?string
End-user identifier.
metadata?object
Response Body
application/json
curl -X POST "https://beta.aimo.network/api/v1/video/retrieve" \ -H "Content-Type: application/json" \ -d '{ "task_id": "string" }'{
"id": "string",
"status": "queued",
"progress": 0,
"estimated_seconds": 0,
"error": {
"code": "string",
"message": "string"
},
"provider_metadata": {
"provider": "string",
"raw": {}
}
}