Create Video

Endpoint

POST /v1/videos

Returns HTTP 202 immediately. Poll GET /v1/videos/{id} for the result.

Request

string

required

Bearer <your-token>

string

required

application/json

string

Any unique string. Reusing the same key returns the existing job instead of creating a new one. See Idempotency.

Body

string

required

Model ID from GET /v1/models.

string

required

Text description of the video to generate. Max 2500 characters.

string

Elements to avoid in the output. Max 2500 characters.

string

default:"16:9"

Output aspect ratio. One of 16:9, 9:16, 1:1.

number

default:"5"

Clip length in seconds. Allowed values depend on the model — check durations from GET /v1/models.

number

default:"0.5"

How closely to follow the prompt. Range 0–1. Higher = more literal.

string

Publicly accessible image URL. Required for image-to-video models. See Image to Video.

Example

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

Response `202`

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "model": "kwaivgi/kling-v2.5-pro/text-to-video",
  "status": "queued",
  "created_at": "2026-08-14T08:00:00.000Z"
}

Getting Started

API Reference

Guides

Endpoint

Request

Body

Example

Response `202`

​Endpoint

​Request

​Body

​Example

​Response 202

Endpoint

Request

Body

Example

Response `202`