Quickstart

Every WideRouter job follows the same three steps regardless of whether you are generating an image or a video, and regardless of which model you pick.

Scaffold notice. The endpoint paths and field names below are placeholders from the repository bootstrap. Replace them with the real API surface, then regenerate the localized pages.

Get an API key

Create a key in the console, then export it so the examples below can read it. Never hard-code a key into a file you commit.

export WIDEROUTER_API_KEY="sk-your-api-key"

Create a task

curl https://api.widerouter.com/v1/tasks \
  -H "Authorization: Bearer $WIDEROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "prompt": "a lighthouse at dusk"
  }'

import os, requests

resp = requests.post(
    "https://api.widerouter.com/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['WIDEROUTER_API_KEY']}"},
    json={"model": "your-model-id", "prompt": "a lighthouse at dusk"},
    timeout=30,
)
task_id = resp.json()["id"]

The call returns immediately with a task id. Generation happens in the background.

Poll until it finishes

Poll the task endpoint with backoff until the status reaches a terminal state, then download whatever the task produced.

Poll with backoff, not in a tight loop. Start around two seconds and grow the interval; a busy client that polls every 100 ms will get rate limited without finishing any faster.

Getting started

Get an API key

Create a task

Poll until it finishes

Next steps

Models

API reference

​Get an API key

​Create a task

​Poll until it finishes

​Next steps

Models

API reference

Get an API key

Create a task

Poll until it finishes

Next steps