> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runflow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Runflow

> Start AI image and video runs with one HTTP call, then receive results by callback or polling. 45+ models, one auth header.

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](/models) from Runflow, Google, Alibaba, OpenAI, and others. Auth is HTTP Bearer. Live count: [`GET /v1/public/models`](https://api.runflow.io/v1/public/models).

## Five-minute quickstart

```bash theme={"dark"}
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](https://app.runflow.io/settings/api-keys). Full walkthrough at [Quickstart](/quickstart).

## Where to go next

<CardGroup cols={2}>
  <Card title="Browse models" icon="grid" href="/models">45+ models, 6 categories, prices and endpoints.</Card>
  <Card title="Quickstart" icon="rocket" href="/quickstart">First call in under 5 minutes.</Card>
  <Card title="API reference" icon="code" href="/api">Generated from the public OpenAPI spec.</Card>
  <Card title="For agents" icon="sparkles" href="/agents">Skill, llms.txt, OpenAPI catalog.</Card>
</CardGroup>

## Concepts

<CardGroup cols={3}>
  <Card title="Authentication" icon="key" href="/concepts/authentication">Bearer header.</Card>
  <Card title="Runs" icon="play" href="/concepts/runs">Callbacks, polling, statuses.</Card>
  <Card title="Callbacks" icon="webhook" href="/concepts/callbacks">Async result delivery.</Card>
  <Card title="Errors" icon="triangle-exclamation" href="/concepts/errors">Status codes, error envelope.</Card>
  <Card title="Pricing" icon="coin" href="/concepts/pricing">Per-request, per-second, per-megapixel.</Card>
  <Card title="Rate limits" icon="gauge" href="/concepts/rate-limits">Headers and backoff.</Card>
</CardGroup>

## Guides

<CardGroup cols={2}>
  <Card title="Pick a model" icon="signs-post" href="/guides/pick-a-model">Decision tree from task to model.</Card>
  <Card title="Batch process media" icon="layer-group" href="/guides/batch-process-media">Many inputs, one request.</Card>
  <Card title="Handle async callbacks" icon="bell" href="/guides/handle-async-callbacks">Webhook handler patterns.</Card>
  <Card title="Verify signatures" icon="shield-check" href="/guides/verify-callback-signatures">HMAC verification.</Card>
</CardGroup>
