Use Provider-Specific Video Options

Not yet available. Per-provider video options are tracked to be built — today, POST /v1/videos accepts model, prompt, and seconds.

Each video generation model is backed by a specific provider with its own set of advanced parameters — frame rate, aspect ratio, style presets, camera controls, and more. The shipped OpenDunes video API exposes the standard fields that work across all models: model, prompt, and seconds. A pass-through for provider-specific options is part of the intended design, not the current API.

What works today#

import os, httpx

headers = {"Authorization": f"Bearer {os.environ['OPENDUNES_API_KEY']}"}

job = httpx.post(
    "https://opendunes.com/api/v1/videos",
    headers=headers,
    json={
        "model": "google/veo-3.1",
        "prompt": "A traditional Algerian courtyard, morning light streaming through arched windows, flowers in terracotta pots",
        "seconds": 6,
    },
).json()
# 202 Accepted -> {"id": "...", "status": "pending", "poll_url": "https://opendunes.com/api/v1/videos/..."}

status = httpx.get(job["poll_url"], headers=headers).json()
# poll until status is "completed" (top-level "url") or "failed" (top-level "error")

Any other field on the request is not part of the API today.

Intended design: an extra pass-through#

The intended design adds an extra object forwarded to the underlying provider, for options such as:

• aspect_ratio — e.g. "16:9", "9:16", "1:1"
• fps — frames per second; higher is smoother but a larger file
• style — high-level visual preset (cinematic, animation, …)
• camera_motion — autonomous camera movement when none is in the prompt
• enhance_prompt — provider-side prompt expansion on or off

None of these are accepted today; sending them does nothing useful.

Notes on portability#

Provider-specific options are, by nature, not portable between models: when the pass-through ships, an option that works on one model may not exist or may behave differently on another. The standard fields (model, prompt, seconds) are the portable core.