Get Video Results with Webhooks

Not yet available. Webhook delivery for video jobs is tracked to be built — today, poll GET /v1/videos/{id} for the job result.

Video generation is asynchronous: you submit a job and fetch the result when it is ready. The shipped mechanism for that is polling.

Polling for results today#

Submit a job with model, prompt, and optionally seconds:

curl https://opendunes.com/api/v1/videos \
  -H "Authorization: Bearer $OPENDUNES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3.1",
    "prompt": "Saharan sand dunes at twilight, time-lapse clouds, cinematic",
    "seconds": 8
  }'

The endpoint responds 202 Accepted with a job id and an absolute poll URL:

{
  "id": "vid_01j...",
  "status": "pending",
  "poll_url": "https://opendunes.com/api/v1/videos/vid_01j..."
}

Poll GET /v1/videos/{id} until the job settles. The response is flat — id, status, and, once finished, a top-level url (or error):

import os, time, httpx

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

while True:
    status = httpx.get(job["poll_url"], headers=headers).json()
    if status["status"] == "completed":
        print(status["url"])
        break
    if status["status"] == "failed":
        print(status["error"])
        break
    time.sleep(5)

Statuses are pending, in_progress, completed, and failed. A failed job carries an error slug instead of a url:

{
  "id": "vid_01j...",
  "status": "failed",
  "error": "upstream_timeout"
}

Billing is per second of output, settled on completion; a failed job releases the reservation and charges nothing.

Intended design#

Webhook delivery is planned as an alternative to polling: you would register a callback URL and OpenDunes would POST the finished job to it, with signed payloads and automatic retries. Until that ships, the poll loop above is the supported path.