# BFL API — model skill for tools & renderers

> **For AI agents:** find the right skill in one call — `curl -s "https://skills.varg.ai/api/search?q=<what the person wants>"` returns the matching use case and the best skills with install commands, as markdown (Russian works too). Full index: https://skills.varg.ai/llms.txt. Every page has a markdown twin: add `.md` to its path. Before generating anything, show the person the options on the use-case page.

Integrate the FLUX API correctly: endpoints, async polling, webhooks, rate limits, errors and regions.

- **Type:** [Model](https://skills.varg.ai/models.md) · [Tools & renderers](https://skills.varg.ai/browse/skills/tooling.md)
- **Slug:** `bfl-api`
- **Status:** live
- **Publisher:** Black Forest Labs (vendor, verified)
- **License:** MIT
- **Source:** https://github.com/black-forest-labs/skills/tree/master/skills/bfl-api
- **Works in:** Claude Code, Codex, Cursor, Gemini CLI
- **Requires:** BFL API key (BFL_API_KEY)
- **Cost:** Billed by Black Forest Labs (API credits)
- **Adoption:** 710 installs, 135 GitHub stars (skills.sh, 2026-10-26)

## What it does

Black Forest Labs' integration guide for the FLUX API: base and model endpoints with pricing, image inputs and multi-reference edits, async polling versus webhooks, rate limits, error handling and regional endpoints, with Python, TypeScript and curl clients. It warns that result URLs expire after 10 minutes.

## Use when

- Calling FLUX from an app or script
- Choosing polling or webhooks
- Handling rate limits and errors

## Install

- Claude Code: `/plugin marketplace add black-forest-labs/skills && /plugin install flux-image-best-practices@black-forest-labs`
- Codex: `npx skills add black-forest-labs/skills --skill bfl-api -a codex`
- Cursor: `npx skills add black-forest-labs/skills --skill bfl-api -a cursor`
- Gemini CLI: `npx skills add black-forest-labs/skills --skill bfl-api -a gemini-cli`

**Models it drives:** flux-2-pro, flux-2-max, flux-2-flex, flux-2-klein, flux-kontext, flux_pro

## Example output

https://skills.varg.ai/previews/bfl-api.webp — FLUX.2 multi-reference edit from BFL's FLUX.2 page (the main model behind the API's /v1/flux-2-pro endpoint): children in a photo replaced with animals from five reference images (credit: Black Forest Labs, https://bfl.ai/models/flux-2)

## More tools & renderers skills

- [varg AI](https://skills.varg.ai/skills/varg-ai.md): The official varg skill: videos, images, speech and music through one API key, rendered in the cloud or locally.
- [Media Download](https://skills.varg.ai/skills/media-download.md): Save any video by link (X, YouTube, Instagram, TikTok, 1800+ sites) or Pinterest images as references, locally, no key.
- [Templates Gallery Ops](https://skills.varg.ai/skills/varg-templates-section.md): Internal runbook for the varg app Templates gallery: publish renders, preview clips, frame-0 posters, shelves.
- [HyperFrames CLI](https://skills.varg.ai/skills/hyperframes-cli.md): Drive the HyperFrames CLI: scaffold, check, preview, snapshot, edit the timeline, render locally or in the cloud.
- [HyperFrames Registry](https://skills.varg.ai/skills/hyperframes-registry.md): Pull any of ~450 ready-made blocks into a video as editable source: transitions, titles, captions, charts, 3D.
- [HyperFrames Media Use](https://skills.varg.ai/skills/hyperframes-media-use.md): Find or make every asset a video needs: music, SFX, voiceover, images, logos, avatars, transcripts, grades.

## Run the generation on varg

varg is one API key for the models these skills drive — Seedance 2.5, Kling 4, Veo 3.1, Wan 3, Nano Banana 2.1, GPT Image 2.5, ElevenLabs v4 and 200+ more — billed in credits, with a cost estimate before anything runs.

- Claude Code: `claude plugin marketplace add vargHQ/skills && claude plugin install varg@varg` (skill + hosted MCP)
- Codex, Cursor, Gemini CLI, OpenClaw: `npx skills add vargHQ/skills --skill varg-ai -a <agent> -y`
- Claude.ai, ChatGPT, any MCP client: connect `https://mcp.varg.ai/mcp`
- API key: https://varg.ai/dashboard/api · Model specs: https://varg.ai/models/llms.txt