Quickstart - HyperGate AI

Step 1 — Get your available models

curl https://hypergate.store/v1/models \
  -H "Authorization: Bearer <your-token>"

{
  "object": "list",
  "data": [
    {
      "id": "seedance/2.5/text-to-video",
      "object": "model",
      "owned_by": "bytedance",
      "name": "Seedance 2.5 — Text to Video",
      "description": "...",
      "capabilities": {
        "endpoint": "/v1/videos",
        "modality": "text-to-video",
        "seconds": { "type": "range", "min": 4, "max": 30 }
      }
    }
  ]
}

Copy an id from the response — you’ll need it in the next step.

Step 2 — Create a video job

curl -X POST https://hypergate.store/v1/videos \
  -H "Authorization: Bearer <your-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance/2.5/text-to-video",
    "prompt": "A wooden boat drifting across a calm bay at dawn, slow panning camera",
    "aspect_ratio": "16:9",
    "duration": 5
  }'

The API responds immediately with HTTP 202 and a job object:

{
  "object": "video",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "model": "seedance/2.5/text-to-video",
  "status": "in_progress",
  "created_at": 1790000000
}

Save the id — you’ll use it to check the result.

Step 3 — Poll for the result

curl https://hypergate.store/v1/videos/3fa85f64-5717-4562-b3fc-2c963f66afa6 \
  -H "Authorization: Bearer <your-token>"

Poll every 3–5 seconds until status is completed or failed. Generation typically takes 1–5 minutes.

{
  "object": "video",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "model": "seedance/2.5/text-to-video",
  "status": "completed",
  "created_at": 1790000000,
  "video_url": "https://hypergate.store/media/3fa85f64.mp4",
  "expires_at": 1790000600
}

Download or stream from video_url before expires_at (Unix timestamp — files are kept for 10 minutes).

Job status values

Status	Meaning
`queued`	Accepted, waiting to be sent to the AI provider
`in_progress`	Submitted to provider and generating (covers submitting → processing → downloading internally)
`completed`	Done — `video_url` is available
`failed`	Generation failed — see `error.code`