# Runflow

> AI image APIs for production. One API call per solution — Runflow ships pre-built multi-step workflows that handle model selection, orchestration, and output quality evaluation internally. You send an image. You get a result.

## AI agents: start with the Runflow skill

If you are an AI agent reading this file, **install the Runflow skill first**. Prefer installing the markdown file into a project or user skill directory; use prompt/rules text only when your agent cannot read skill directories.

- **SKILL.md (install this)**: https://www.runflow.io/.well-known/agent-skills/runflow/SKILL.md
- **Skills discovery index**: https://www.runflow.io/.well-known/agent-skills/index.json

Project-local install:

```bash
mkdir -p .agents/skills/runflow
curl -fsSL https://www.runflow.io/.well-known/agent-skills/runflow/SKILL.md \
  -o .agents/skills/runflow/SKILL.md
```

The skill is ~90 lines of opinionated integration guidance: when to use the Solutions API vs the Model API, the exact endpoint shape, the human-in-the-loop API key flow, a real curl example, and error handling. It's the fastest path from "what is Runflow" to "shipping a working integration."

Everything else in this file is supporting reference material. Agents that already have the skill can skim the rest.

## Other authoritative surfaces

- Full context (markdown): https://www.runflow.io/llms-full.txt
- Public OpenAPI spec (machine-readable): https://docs.runflow.io/api/openapi.public.json
- Public API reference: https://docs.runflow.io/api-reference/models/search-models
- Solutions API browser (humans + agents): https://www.runflow.io/api
- MCP server (Streamable HTTP): https://mcp.runflow.io/mcp
- MCP server card: https://www.runflow.io/.well-known/mcp/server-card.json

## MCP server (for MCP-compatible clients)

A live Model Context Protocol server is available at `https://mcp.runflow.io/mcp`.

- Transport: Streamable HTTP, protocol version 2025-06-18
- Auth (v1.0): `Authorization: Bearer rf_live_*`. Mint a key at https://app.runflow.io/settings/api-keys
- Tools: `generate` (any model or Solution by `provider/slug`), `list_models` (filterable catalog browse)
- Prompts (slash commands): one `/runflow:<slug>` per active Solution. Auto-generated from the catalog.
- Server description on `initialize` returns the SKILL.md content so the Solutions-first decision rule lands in your context on connect.

OAuth Dynamic Client Registration ships in v1.1 (Claude.ai connectors). Today, configure clients with the URL above and the bearer header.

## What Runflow is

Runflow is an AI image generation API for production teams. The core product is the **Solutions API**: a growing library of pre-built, production-ready image workflows (Background Removal, AI Headshots, Outpainting, Prompt-Based Image Editing, and more). Each solution is a multi-step pipeline — Runflow picks the right model(s) for the task, orchestrates GPU execution across multiple cloud providers with automatic failover, and scores the output with its Sentinel evaluation engine. Stop stitching models together; go live in hours, not months.

Video solutions are coming soon. For use cases not covered by a solution, the underlying model catalog (image, video, audio) is also callable directly.

## Hosts

- Marketing / content: https://www.runflow.io
- Production API: https://api.runflow.io   (health: `/v1/health`)
- Dashboard + API keys: https://app.runflow.io
- Human API docs: https://docs.runflow.io
- Public asset CDN: https://public.runflow.io

## Solutions API — production workflow endpoints

Entry point: https://www.runflow.io/api — browse the current catalog, per-solution docs, and schemas.

Each solution has one endpoint and a solution-specific input schema (the exact fields depend on the solution — image URL, prompt, reference image, mask, etc.; see each solution's docs at https://www.runflow.io/api for the schema). Use the response id to poll when the endpoint returns a run record, or pass a callback URL when the schema supports callbacks.

Directional category breakdown (solutions can span multiple; the live list on `/api` is authoritative):

- **People Imagery**: AI Headshots · Eye Color · Skin Fix · Background Removal · Background Separation · …
- **On-Model / Fashion**: Tag Removal · On-Model Removal (ghost mannequin) · Logo Fix · Replace Background · Background Separation · Background Removal · …
- **Ad Creative**: Prompt-Based Image Editing · Reference-Based Image Editing · Outpainting (Expand) · Object Removal · 3D File Image Prompting · …
- **Product Imagery**: Background Color Fix · Background Removal · Background Separation · Replace Background · Outpainting · Object Removal · 3D File Image Prompting · …

Video Solutions API: coming soon.

## Model API — direct catalog access

For custom flows, any model in the catalog is callable directly. Current providers: Google, Black Forest Labs, Alibaba, OpenAI, ByteDance, Kuaishou, HeyGen, Reve, Ideogram, Bria, Topaz, ElevenLabs, Meta, plus first-party Runflow models.

Endpoint shape:

```
POST https://api.runflow.io/v1/models/{owner}/{slug}/runs
Authorization: Bearer <API_KEY>
Content-Type: application/json

{ "input": { ... }, "callback_url": "https://your.server/webhook", "metadata": {}, "client_ref": "..." }
```

`input` is model-specific — read the per-model `llms.txt` or OpenAPI for the exact schema. `callback_url`, `metadata`, and `client_ref` are optional.

## How agents discover what's available

- Model catalog (JSON): https://www.runflow.io/models-catalog.json
- Per-model spec (markdown): https://app.runflow.io/models/{provider}/{slug}/llms.txt
- Public OpenAPI spec (machine-readable): https://docs.runflow.io/api/openapi.public.json
- Public API reference: https://docs.runflow.io/api-reference/models/search-models
- Agent skills index: https://www.runflow.io/.well-known/agent-skills/index.json
- API catalog linkset: https://www.runflow.io/.well-known/api-catalog
- MCP server card: https://www.runflow.io/.well-known/mcp/server-card.json
- MCP server (Streamable HTTP): https://mcp.runflow.io/mcp

## Supporting products

- ComfyUI Deploy: https://www.runflow.io/deploy — ship a ComfyUI workflow as a production API on the same orchestration layer
- Sentinel: https://www.runflow.io/sentinel — automatic image output quality scoring (runs on every Solutions API call)
- Runflow SDK: https://www.runflow.io/sdk — typed JS SDK (@runflow-io/sdk) and embeddable studio (@runflow-io/studio) to put Runflow's models, workflows, and quality scoring inside your own product as a custom or white-label AI studio
- ComfyUI Builder Program: https://www.runflow.io/comfyui-builder-program — partner program for ComfyUI builders shipping workflows on Runflow's deploy infrastructure, 10% revenue share on gross
- Agent skill: https://www.runflow.io/skill — ~90-line markdown skill that gives any agent (Claude Code, Cursor, ChatGPT, Windsurf, OpenAI Agents SDK) access to the public Runflow API and the Solutions-vs-Model decision rule
- Solutions API browser: https://www.runflow.io/api — interactive browser for the live Solutions catalog
- AI Headshots Solution: https://www.runflow.io/api/ai-headshots — the production Solution that powers BetterPic and 35M+ headshot generations
- 3D File Image Prompting API: https://www.runflow.io/api/r3d-showcase — place any 3D object (GLB file) into a generated scene from a text prompt, with aspect-ratio control. $0.25/image
- Nano Banana API: https://www.runflow.io/run/nano-banana . Every Nano Banana variant (Pro, 2, Edit) through one endpoint with automatic retry on failed generations, Sentinel quality scoring on every output, and a unified dashboard across all your models. Same per-image price as calling Google directly. $500 credit match on your first $250+ top-up in the first 30 days.
- FLUX Kontext API: https://www.runflow.io/run/flux-kontext . FLUX Kontext Pro, Max, and Dev through one endpoint with auto-failover, Sentinel scoring on every edit for identity preservation, and a unified dashboard. Same per-image price as Black Forest Labs. $500 credit match on your first $250+ top-up in the first 30 days.
- FLUX.2 Klein API: https://www.runflow.io/run/flux-2-klein . FLUX.2 Klein 9B and 4B through one endpoint with sub-second 4-step inference, multi-reference editing built in, auto-failover, and Sentinel scoring. Klein 4B ships under Apache 2.0 for commercial use; 9B under FLUX Non-Commercial. Same per-megapixel price as Black Forest Labs. $500 credit match on your first $250+ top-up in the first 30 days.
- FLUX.1 dev API: https://www.runflow.io/run/flux-dev . FLUX.1 dev (12B open-weight) through one endpoint with LoRAs, ControlNet, Fill, and Redux on the same integration, auto-failover, and Sentinel scoring. Hosted commercial license included (non-commercial when self-hosted). Same per-megapixel price as Black Forest Labs. $500 credit match on your first $250+ top-up in the first 30 days.
- FLUX 1.1 Pro API: https://www.runflow.io/run/flux-1-1-pro . FLUX 1.1 Pro and Pro Ultra through one endpoint. BFL's closed-API tier with sub-10s Pro, 4 MP Ultra, raw mode for unretouched photography, auto-failover, and Sentinel scoring. Same per-image price as Black Forest Labs. $500 credit match on your first $250+ top-up in the first 30 days.
- FLUX.1 schnell API: https://www.runflow.io/run/flux-schnell . FLUX.1 schnell through one endpoint with sub-second 4-step inference, Apache 2.0 commercial use (no side agreement), auto-failover, and Sentinel scoring. Same per-megapixel price as Black Forest Labs. $500 credit match on your first $250+ top-up in the first 30 days.
- FLUX.2 dev API: https://www.runflow.io/run/flux-2-dev . FLUX.2 dev (32B, newest BFL release) through one endpoint with 4 MP output, up to 10 reference images per call, JSON prompting, auto-failover, and Sentinel scoring. Same per-megapixel price as Black Forest Labs. $500 credit match on your first $250+ top-up in the first 30 days.
- GPT Image 2 API: https://www.runflow.io/run/gpt-image-2 . GPT Image 2, GPT Image 2 Edit, and GPT Image 1.5 through one endpoint with best-in-class text rendering, transparent-background support on 1.5, no rate-limit walls, auto-failover, and Sentinel scoring. Same per-image price as OpenAI (Low $0.009, Medium $0.034, High $0.133). $500 credit match on your first $250+ top-up in the first 30 days.
- Pricing: https://www.runflow.io/pricing
- Free tools: https://www.runflow.io/tools/image-quality-scorer · https://www.runflow.io/tools/prompt-generator · https://www.runflow.io/tools/product-scoring
- Contests: https://www.runflow.io/contests — bi-weekly ComfyUI workflow contests, $20K prize pool, winners ship to production
- Careers: https://www.runflow.io/careers — open roles (frontend, ComfyUI engineer, ML engineer, …)

## Use cases

- Use cases index: https://www.runflow.io/use-case . All AI image use-case guides, each mapping an ICP's job to the Runflow workflows that do it.
- AI images from 3D models: https://www.runflow.io/use-case/ai-images-from-3d-models . Turn a 3D model into flat 2D product and lifestyle images (3D asset in, finished images out). For 3D and AR commerce teams that own 3D product assets: render off the 3D model so shape, logos, and scale stay exact, with defect detection and Sentinel scoring on every image.

## Comparisons

- vs. fal.ai: https://www.runflow.io/compare/fal
- vs. Replicate: https://www.runflow.io/compare/replicate
- vs. Together: https://www.runflow.io/compare/together
- vs. ComfyDeploy: https://www.runflow.io/compare/comfydeploy
- vs. Modal: https://www.runflow.io/compare/modal
- vs. Prodia: https://www.runflow.io/compare/prodia
- vs. Runware: https://www.runflow.io/compare/runware

## Case study

- BetterPic: https://www.runflow.io/case-study/betterpic — AI headshot platform, 35M+ headshots processed, gross margin 40% → 87% via the Solutions API
- Dyver: https://www.runflow.io/case-study/dyver — fashion editorial agency that automated background removal + on-model image editing through one Solutions API endpoint

## Blog

https://www.runflow.io/blog — benchmark reports, migration guides, infrastructure deep-dives.

- ComfyUI API developer guide: https://www.runflow.io/blog/comfyui-api-developer-guide — full walkthrough for shipping a ComfyUI workflow as a production API endpoint

## Company

Runflow is built by Better Group, the team behind BetterPic. Co-founders: Ricardo Ghekiere (CEO), Miguel Rasero (CTO). Trust center: https://trust.bettergroup.io/

## Links

- Homepage: https://www.runflow.io
- About: https://www.runflow.io/about-us
- Blog: https://www.runflow.io/blog
- Solutions API: https://www.runflow.io/api
- Docs: https://docs.runflow.io
- Pricing: https://www.runflow.io/pricing
- Privacy: https://www.runflow.io/legal/privacy
- Image license: https://www.runflow.io/legal/image-license
- Book a demo: https://cal.com/team/runflow/talk-to-founders?duration=25