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
POST
/video/retrieve
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": {}
  }
}