Video Generation | OpenDunes Docs

Video Generation produces short clips from a text prompt. It runs asynchronously: submit a job, then poll until the clip is ready. It is billed per second of output video in DA, and clips are stored temporarily — download them promptly. The OpenAI SDK has no video resource, so call the endpoint directly with httpx.

Submit a job and poll#

Python

import os
import httpx
import time

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

# Submit the generation job — responds 202 with a poll URL
resp = httpx.post(
    "https://opendunes.com/api/v1/videos",
    headers=headers,
    json={
        "model": "example-provider/video-model",
        "prompt": "A time-lapse of sand dunes shifting under a clear Algerian sky, golden hour, cinematic.",
        "seconds": 6,
    },
)
job = resp.json()
job_id = job["id"]

# Poll until terminal
while True:
    status = httpx.get(
        f"https://opendunes.com/api/v1/videos/{job_id}",
        headers=headers,
    ).json()
    if status["status"] == "completed":
        print(status["video"]["url"])
        break
    elif status["status"] == "failed":
        print("Generation failed")
        break
    time.sleep(5)

Parameters#

Parameter	Description
`model`	Video generation model slug (`?modality=video`).
`prompt`	Text description of the desired video.
`seconds`	Requested clip length, 1–60 (model-dependent maximum).

The cost of the requested seconds is held on submission and settled on completion. A failed or timed-out job releases the full hold and charges nothing. Returned URLs are signed and time-limited — download promptly. See the video API reference.

Submit a job and poll#

Python

import os
import httpx
import time

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

# Submit the generation job — responds 202 with a poll URL
resp = httpx.post(
    "https://opendunes.com/api/v1/videos",
    headers=headers,
    json={
        "model": "example-provider/video-model",
        "prompt": "A time-lapse of sand dunes shifting under a clear Algerian sky, golden hour, cinematic.",
        "seconds": 6,
    },
)
job = resp.json()
job_id = job["id"]

# Poll until terminal
while True:
    status = httpx.get(
        f"https://opendunes.com/api/v1/videos/{job_id}",
        headers=headers,
    ).json()
    if status["status"] == "completed":
        print(status["video"]["url"])
        break
    elif status["status"] == "failed":
        print("Generation failed")
        break
    time.sleep(5)

Parameters#

Parameter	Description
`model`	Video generation model slug (`?modality=video`).
`prompt`	Text description of the desired video.
`seconds`	Requested clip length, 1–60 (model-dependent maximum).