Skip to main content
Start AI image and video runs with one HTTP call, then receive results by callback or polling. The Runflow API exposes a curated catalog of 45+ models from Runflow, Google, Alibaba, OpenAI, and others. Auth is HTTP Bearer. Live count: GET /v1/public/models.

​
Five-minute quickstart

export RUNFLOW_API_KEY="your_key"

curl -X POST https://api.runflow.io/v1/models/runflow/background-replace/runs \
  -H "Authorization: Bearer $RUNFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "prompt": "white studio", "image_url": "https://..." } }'
Get a key at app.runflow.io. Full walkthrough at Quickstart.

​
Where to go next

Browse models

45+ models, 6 categories, prices and endpoints.

Quickstart

First call in under 5 minutes.

API reference

Generated from the public OpenAPI spec.

For agents

Skill, llms.txt, OpenAPI catalog.

​
Concepts

Authentication

Bearer header.

Runs

Callbacks, polling, statuses.

Callbacks

Async result delivery.

Errors

Status codes, error envelope.

Pricing

Per-request, per-second, per-megapixel.

Rate limits

Headers and backoff.

​
Guides

Pick a model

Decision tree from task to model.

Batch process media

Many inputs, one request.

Handle async callbacks

Webhook handler patterns.

Verify signatures

HMAC verification.