API docsAPI reference

Create a generation

Pass the model id, its unified input parameters and optionally a provider slug. The response returns immediately with the task id; image models on synchronous providers may already be succeeded.

POST/api/v1/generationsBearer API key

Request

cURL

curl 'https://01router.com/api/v1/generations' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.5",
  "input": {
    "prompt": "A red fox running through fresh snow, cinematic"
  }
}'

Input parameters

JSON body

model stringRequired: Model slug from the catalog. Project keys may use a project-specific model slug.
input objectRequired: Model-specific input object. See the selected model reference for required fields, defaults and limits.
provider stringOptional: Optional provider slug. Omit for automatic routing; project settings may pin the provider.
project stringOptional: Optional project ID. Use its published model catalog and routing configuration.
callback_url string<uri>Optional: Public HTTPS URL, up to 1,000 characters. Receives the final generation object. Private network addresses are rejected.

Response example

200 · application/json

{
  "id": "gen_example",
  "object": "generation",
  "model": "seedance-2.5",
  "type": "video",
  "provider": "01router",
  "status": "processing",
  "input": {
    "prompt": "A red fox running through fresh snow, cinematic"
  },
  "outputs": [],
  "error": null,
  "credits": 100,
  "price_usd": 1,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

Responses are illustrative. IDs, usage, prices and results depend on the actual request.

Response fields

id string: Generation ID returned by the create request.
object "generation": generation
model string: Model slug from the catalog. Project keys may use a project-specific model slug.
type video | image | audio | chat
provider string: Optional provider slug. Omit for automatic routing; project settings may pin the provider.
status string: queued / processing / succeeded / failed. Stop polling on succeeded or failed.
input object: Model-specific input object. See the selected model reference for required fields, defaults and limits.
outputs string[]: Result file URLs. Empty until available; download promptly because URLs may expire.
error string | null: Error message on failure; null otherwise.
credits number: Credits charged for this generation; zero after a refund.
price_usd number: Price of this generation in USD; zero after a refund.
created_at string: Creation time in ISO 8601 format.
completed_at string | null: Completion time in ISO 8601 format, or null while running.

Usage notes

Poll at intervals of at least 3 seconds. A 504 from the synchronous image endpoint means the task may still be running: poll its error.id instead of submitting it again.

Use with AI

Give your coding assistant the documentation index or the full API reference, including live model parameters.

llms.txt llms-full.txt This page as Markdown