Video generation

Async jobs, preview gate, fal.ai + Runway - up to 10 seconds.

Async job pattern

Video generation is async. POST /v2/video/generate returns a job_id immediately. Poll GET /v2/video/job/{id} until status is completed or failed.

Providers & models

fal.ai - LTX-Video T1 (5s max $0.006/s) · Wan 2.1 1.3B T1 (8s $0.007/s) · Wan 2.1 14B T2 (8s $0.04/s) · Wan I2V 14B T2 · Kling v1.6 Standard T2 (10s $0.045/s) · Kling v1.6 Pro T3 (10s $0.12/s)
Runway - Gen-4 Turbo T3 (10s $0.05/s) - requires image_url

Preview gate (auto mode)

When quality_mode = auto and the configured tier is T2 or T3, HiWay first generates a cheap T1 preview. The job enters preview_ready status with a low-cost preview URL. You call POST /v2/video/job/{id}/approve to trigger the full render, or reject to discard it (you only pay for the preview).

# Start job
curl -X POST https://app.hiway2llm.com/v2/video/generate \
  -H "Authorization: Bearer hw_live_…" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A cat walking on a beach", "duration_s": 5}'

# Poll
curl https://app.hiway2llm.com/v2/video/job/JOB_ID \
  -H "Authorization: Bearer hw_live_…"