Videos

Video generation is always async. Submit a job, receive a task_id, then either poll /api/v1/tasks/{id} or set webhook_url to be notified on completion.

How async tasks work#

POST returns immediately with task_id and status:"queued". Status transitions to "running" once a worker picks it up, then "success", "failed" or "expired". Webhooks fire on terminal states.

Pick a video model#

Video models differ substantially: Veo fixes duration to 8s but supports audio tracks; Sora and Kling do 5/10s; Runway needs an image for I2V; Hailuo accepts camera directives inline in the prompt. The matrix below summarises; the per-model section spells out every parameter.

Request body (shared)#

Response#

Per-model parameters#

Pass only the fields the per-model table lists. Orux AI rejects unknown fields with invalid_param. webhook_url is supported by all video models — strongly preferred over polling for production.

Hailuo 02: camera directives in prompt#

Hailuo 02 accepts camera-motion directives written inline in the prompt as bracketed tokens. Multiple directives may be combined comma-separated. The directive set is:

Veo 3.1: image-to-video input formats#

Veo accepts three input shapes for the optional starting frame: an https URL to a publicly accessible image, a base64 data URI ("data:image/png;base64,…") inline in the JSON body, or a reference to a previous Orux AI task that produced an image (pass {"task_id":"img_…"} as the image field). Duration is fixed at 8 seconds; resolution defaults to 1080p; audio is on by default.

Examples#

# 1. Submit a job
curl https://orux.top/api/v1/tasks \
  -H "Authorization: Bearer $ORUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo-3.1-quality",
    "prompt": "A drone shot flying over Tokyo at sunset, cinematic",
    "duration": 8,
    "resolution": "1080p",
    "webhook_url": "https://your.app/webhooks/orux"
  }'
# -> { "task_id": "task_01HZX...", "status": "QUEUED", "submit_time": "2026-06-04T22:00:00" }

# 2. Poll until done
curl https://orux.top/api/v1/tasks/task_01HZX... \
  -H "Authorization: Bearer $ORUX_API_KEY"
# -> { "task_id": "...", "status": "SUCCESS", "result_urls": ["https://..."], "duration_sec": 38 }

curl https://orux.top/api/v1/tasks \
  -H "Authorization: Bearer $ORUX_API_KEY" \
  -d '{
    "model":"veo-3.1-quality",
    "prompt":"Cinematic dolly-in toward a fox in a moonlit forest",
    "aspect_ratio":"16:9",
    "audio": true,
    "image":"data:image/png;base64,iVBORw0KGgoAAA..."
  }'

curl https://orux.top/api/v1/tasks \
  -H "Authorization: Bearer $ORUX_API_KEY" \
  -d '{
    "model":"hailuo-02",
    "prompt":"[Tracking Shot, Pan Right] A skateboarder weaves through a rainy night market, neon reflections on wet pavement.",
    "duration": 6
  }'