К основному содержанию
скилл CX Codex

flux-3-generate — скилл для Claude Code: что делает и как установить

Скилл flux-3-generate для Claude Code проводит задачу FLUX 3 video API от отправки до проверки MP4: опрашивает статус и скачивает черновики и результат.

MIT 185 установок ★ 138 обновлён 2026-09-09

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add black-forest-labs/skills --skill flux-3-generate -a claude-code
Открыть на GitHub

Что делает flux-3-generate

Скилл проводит задачу через асинхронный FLUX 3 video API: собирает запрос, отправляет его один раз, опрашивает статус и скачивает результат. В запросе всегда указан mode: t2v генерирует по тексту, i2v берёт keyframes, v2v продолжает start_video, draft_enhance повторяет черновик из draft_cache в полном качестве.

Схема строгая, и лишнее или пропущенное обязательное поле даёт 422. Статус опрашивается каждые 6 секунд. На Pending, Reasoning и Generating ждём дальше, Ready означает успех, а Error, Request Moderated, Content Moderated и Task not found — провал, после которого Ready не наступит. Если 429 пришёл при опросе, не отправляйте запрос заново: задача жива, а второй рендер оплачивается отдельно. Ссылки на файлы подписаны и живут примерно час. Скачивайте сразу и все элементы result.samples и result.draft_caches.

Нужен ключ в переменной BFL_API_KEY, он передаётся в заголовке x-key. Скилл проверяет, что переменная задана, но не печатает её. Напоследок проверяется MP4: файл декодируется, длительность, разрешение и пропорции совпадают с запросом, звук есть только если его просили.

Какие задачи решает

  • отправить задачу в FLUX 3 video API и дождаться статуса Ready
  • превратить свои картинки в закреплённые кадры через i2v
  • продолжить готовый ролик с его последних кадров через v2v
  • сначала сделать дешёвый черновик, потом пересчитать выбранный в полном качестве
  • сохранить все файлы draft_caches, пока не истекли подписанные ссылки

Примеры запросов агенту

  • Отправь задачу в FLUX 3 video API в режиме t2v и опрашивай её до Ready
  • Сделай черновик с draft: true, скачай все draft_caches и проверь MP4
  • Продолжи мой ролик через v2v с start_video и сохрани id и polling_url задачи

Как установить flux-3-generate

1Через Skills CLI (Vercel)

npx skills add black-forest-labs/skills --skill flux-3-generate -a claude-code

2Вручную: положить файлы

~/.claude/skills/flux-3-generate/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/flux-3-generate/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о flux-3-generate

Как установить flux-3-generate в Claude Code?

Выполните npx skills add black-forest-labs/skills --skill flux-3-generate -a claude-code. Скилл окажется в ~/.claude/skills/flux-3-generate/SKILL.md.

Что делает flux-3-generate?

Отправляет задачу в FLUX 3 video API, опрашивает статус, скачивает MP4 и черновики. Затем проверяет файл технически: декодирование, длительность, разрешение, наличие звука.

Что делать, если API вернул 429?

Если 429 пришёл при отправке, задача не создана: подождите свободного слота и отправьте то же тело снова. Если при опросе, задача существует, продолжайте опрашивать тот же polling_url и ничего не пересылайте.

Исходный текст

SKILL.md · MIT
---
name: flux-3-generate
description: Use when submitting or polling a FLUX 3 video API job. Also covers drafts, downloads, and technical validation.
metadata:
  author: Black Forest Labs
  version: "1.0.0"
  tags: flux, flux-3, bfl, video-api, generation, polling, drafts, qc
---

# FLUX 3 Generate

Execute a ready plan through the asynchronous API, preserve expiring artifacts, and
verify the MP4. Read the [FLUX 3 API reference](https://docs.bfl.ai) before building a
request; it is authoritative wherever this skill disagrees. Authenticate with the
`x-key` header from `BFL_API_KEY`; check the variable exists without printing it, and
never put keys in prompts, logs, or saved request bodies.

## Request shape

Every request names its `mode` (required, exact strings) and carries the matching media
field:

| `mode` | Media field | What the model does |
| --- | --- | --- |
| `t2v` | none | Generates the clip from your text alone |
| `i2v` | `keyframes` (required) | Puts your images on screen, pixel for pixel, as pinned frames |
| `v2v` | `start_video` (required) | Continues from the final frames of your clip |
| `draft_enhance` | `draft_cache` (required) | Replays a cached draft at full quality; accepts no other fields, not even `prompt` |

- The schema is strict: any field it does not know returns a `422` naming it
  (`Extra inputs are not permitted`). A missing required field 422s the same way.
- Settings on the generating modes: `aspect_ratio` (`auto`, `21:9`, `2:1`, `16:9`,
  `4:3`, `1:1`, `3:4`, `9:16`), `duration` (integer 5-20 or `"auto"`), `resolution`
  (`hd` or `fhd`), `generate_audio` (bool), `draft` (bool), `version`.
- Constraints couple (a video input at higher resolution may cap duration): read the
  reference rather than assuming fields are independent.
- Three or more bare keyframes, and all `[seconds, image]` timestamped keyframes, need
  an integer `duration`. Media travels as a public URL or inline base64; keyframe
  images are at least 256x256.

## Run a job

1. **Submit once.** Persist the returned task `id` and `polling_url` with the
   secret-free request.
2. **Poll every 6 seconds** to a terminal state with the `x-key` header, following
   redirects. Planning time on a complex brief is normal, not a stall. The API status
   strings are exact. KEEP POLLING on `Pending`, `Reasoning`, `Generating`. STOP on
   `Ready` (success) and on `Error`, `Request Moderated`, `Content Moderated`, or
   `Task not found` (failures). None of these terminal statuses ever later becomes
   `Ready`.
   - `429` on submit means your org's concurrency ceiling is full and **no task was
     created**. There is nothing to poll. Wait for a slot, then resubmit the same body.
   - `429` on poll means the task exists and is unaffected. Back off and keep polling
     the same `polling_url`. Never resubmit, or you pay for a second render.
   - `503`: bounded backoff.
3. **Download immediately.** Observed signed sample and draft cache URLs expire roughly
   one hour after the result is ready. The `se=` query parameter on the URL itself is
   the authoritative expiry. Read it rather than assuming a fixed window. Video
   outputs arrive in `result.samples`, which is a list. Draft bundles arrive in
   `result.draft_caches`, which is also a list. The singular `result.draft_cache` is
   the first element of that list, not the complete set. Iterate every element of both
   lists and download all of them before doing anything else, recording the local path
   and task ID per element. A client reading only the singular `result.draft_cache` key
   silently drops paid artifacts that cannot be recovered once the signed URLs expire.
   Save the downloaded files, plus task ID and status.
4. **Validate**: container decodes, duration/resolution/aspect match intent, audio
   present exactly when requested. Technical validity is not creative approval; hand
   review to the specialist that owns it.

## Drafts

Add `draft: true` while a concept is unproven: a fast low-step preview plus a
`draft_cache` costs far less than a full render. Judge a draft on event legibility,
composition, and continuity; softness is the low-step trade and resolves at full
quality. Enhance only the chosen cache (it replays the same generation, so preserve
draft-to-cache identity when several are in play).

Between reruns change one consequential dimension. After two structurally similar
misses, return to the creative skill instead of accumulating adjectives.

## References

- [references/api-quick-reference.md](references/api-quick-reference.md)

© Black Forest Labs · MIT · black-forest-labs/skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
flux-best-practices Black Forest Labs Скилл flux-best-practices для Claude Code помогает составлять промпты для моделей FLUX.1 и FLUX.2: описывать сцены, настраивать типографику и указывать точные оттенки. CX Codex +1 1 200установок bfl-api Black Forest Labs Скилл bfl-api для Claude Code помогает подключить BFL FLUX API для генерации и редактирования изображений. Описывает асинхронные запросы, polling и вебхуки. CX Codex +1 1 200установок flux-2-klein prime-skills Генерация картинок через Flux 2 Klein на RunComfy с готовыми паттернами промптов для быстрых итераций и финального рендера. CX Codex +1 446 700установок flux social-media-skills Скилл для работы с FLUX и FLUX.2: помогает выбрать вариант модели и лицензию, написать промпт и править картинку вместо перегенерации. CX Codex +1 1 100установок flux-image acedatacloud Скилл flux-image генерирует и редактирует изображения через API AceDataCloud: текст в картинку, правки по описанию, видео FLUX 3. Работает через OpenClaw Gateway с ключом ACEDATACLOUD_API_TOKEN в .env. CX Codex +1 238установок fal-generate nexu-io Генерирует изображения и видео через модели fal.ai — Flux, SDXL, ideogram и другие эндпоинты. Запускается по фразам «fal generate», «flux image» или «sdxl». CX Codex +1 2 900установок

Из того же набора8

flux-3-prompt-doctor Скилл flux-3-prompt-doctor проверяет брифы видеогенерации для FLUX 3 до отправки в API. Находит нестыковки в требованиях и выбирает режим генерации. CX Codex +1 203установок flux-3-video Скилл flux-3-video маршрутизирует задачи генерации видео в FLUX 3 между профильными скиллами для подготовки промптов, раскадровки, звука и запуска рендера. CX Codex +1 185установок flux-3-cinematic-inserts Скилл flux-3-cinematic-inserts помогает составить промпт для генерации одного изолированного кадра в FLUX 3 text-to-video. Фокусируется на физике движения, поведении камеры и непрерывности сцены без склеек. CX Codex +1 185установок flux-3-keyframes-continuation Скилл flux-3-keyframes-continuation помогает собирать FLUX 3-видео из изображений и роликов: задаёт ключевые кадры, раскадровку или продолжение клипа. CX Codex +1 183установок flux-3-audio-dialogue Скилл flux-3-audio-dialogue для Claude Code описывает звук для FLUX 3: реплики, закадровый голос, фон, эффекты и музыку. Разделяет эти слои отдельными описаниями. CX Codex +1 181установок flux-3-product-ads Скилл flux-3-product-ads для Claude Code собирает рекламный ролик продукта из видео и озвучки FLUX 3. Включается при создании ролика: помогает спроектировать кадры, синхронизировать действие с текстом и проверить сборку. CX Codex +1 136установок flux-3-archival-formats Скилл flux-3-archival-formats для Claude Code помогает генерировать архивный и исторический стиль для видео в модели FLUX 3. Запрос строится через физические форматы записи и деградацию пленки вместо абстрактных настроений. CX Codex +1 136установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой