← VideoOS home · Docs

← Docs · Video

Video Generation API (OpenRouter-style, 15+ engines)

Problem

You want to add AI video generation to your app, website or workflow, lower your video cost, or generate video in bulk.

Solution

MaxAI is a multi-model video API: one key, one base URL (https://maxai.fyi/v1), 15+ engines (Veo 3.1, Kling 3, Seedance 2, Hailuo, Wan, Vidu, PixVerse). Send a prompt and MaxAI auto-routes to the cheapest engine that meets your quality bar, with automatic failover if one is busy. Authenticate with the header Authorization: Bearer YOUR_KEY (get a free key at /start). Submit to POST /v1/videos, then poll GET /v1/videos/{id} for the finished MP4. Pick a routing tier (eco/standard/premium/flagship) or pin a specific engine id. Image-to-video via image_url. No watermark. Pay with crypto or card.

Examples

curl -X POST https://maxai.fyi/v1/videos -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" -d '{"model":"standard","prompt":"cinematic golden-hour coffee pour, macro","aspect_ratio":"9:16"}'
# -> {"id":"v1_...","poll_url":"/v1/videos/v1_..."}
curl https://maxai.fyi/v1/videos/v1_... -H "Authorization: Bearer YOUR_KEY"
# -> {"status":"completed","url":"https://maxai.fyi/generated/clips/v1_....mp4"}

import requests, time
H = {"Authorization": "Bearer YOUR_KEY"}
job = requests.post("https://maxai.fyi/v1/videos", headers=H,
    json={"model": "standard", "prompt": "a cat surfing a wave at sunset"}).json()
while True:
    s = requests.get("https://maxai.fyi/v1/videos/" + job["id"], headers=H).json()
    if s["status"] in ("completed", "failed"): break
    time.sleep(5)
print(s.get("url"))

# Bulk / wholesale: loop prompts on the eco tier (auto-routes to the cheapest engine)
for prompt in my_prompts:
    requests.post("https://maxai.fyi/v1/videos", headers=H,
        json={"model": "eco", "prompt": prompt})

FAQ

How do I connect by URL?

Base URL https://maxai.fyi/v1 with header Authorization: Bearer YOUR_KEY. Works from any language over plain HTTP, just like OpenRouter.

Which is cheapest?

Use model eco - MaxAI auto-routes to the lowest-cost engine that still meets quality, so you never overpay.

Can I pin a specific model?

Yes - set model to an engine id (veo-3.1, kling-v3.0-pro, seedance-2.0, ...). GET /v1/videos/models for the list.

Bulk or high volume?

Loop the endpoint; for volume pricing see /for-agencies.

API references

/v1/videos · /v1/videos/models · /openapi.json · /start