Чек-лист
кодовое словоМедиа

Картинки и видео без подписки: fal.ai и скилл для Claude Code

Здесь всё, чтобы генерировать картинки и видео прямо из Claude Code и платить только за результат: что понадобится, как завести ключ fal, поставить утилиту genmedia и готовый скилл fal-media, как им пользоваться и сколько стоят модели.

Содержание9 глав
  1. 01Что это
  2. 02Что понадобится
  3. 03Шаг 1. Ключ fal и баланс
  4. 04Шаг 2. Ставим genmedia и вставляем ключ
  5. 05Шаг 3. Ставим скилл fal-media
  6. 06Промпт установки скилла
  7. 07Шаг 4. Первый запуск
  8. 08Модели и цены на fal
  9. 09Если что-то не работает

Что это

fal.ai - платформа, где собрано больше 1000 моделей для картинок, видео, звука и 3D: https://fal.ai

Подписки нет: пополняешь баланс, и деньги списываются за каждый готовый результат. Ошибки сервера и ожидание в очереди не оплачиваются.

genmedia - официальная консольная утилита fal для ИИ-агентов: https://fal.ai/docs/documentation/setting-up/genmedia

Через неё Claude Code запускает модели fal и сразу скачивает результат на диск.

Скилл fal-media из этого материала превращает запрос своими словами в сильный промпт, делает картинку в Nano Banana 2, сохраняет её в папку проекта и по желанию оживляет в Kling 3 или Seedance 2.5. Перед каждым платным запуском он показывает промпт и цену и ждёт твоего «да».

Что понадобится

  • Claude Code - установка и требования: https://code.claude.com/docs/en/setup
  • Claude Code работает на тарифе Pro и выше (Pro - 20 долларов в месяц при помесячной оплате) или с ключом Anthropic Console, на бесплатном плане его нет.
  • Claude Code работает только в странах из списка Anthropic, проверь, что твой аккаунт и оплата подходят: https://www.anthropic.com/supported-countries
  • Аккаунт fal с балансом. fal принимает оплату картой или через ACH в долларах. В условиях fal есть раздел Export Control об экспортном контроле США - прочитай его до оплаты и проверь, что твой аккаунт и карта под него подходят: https://fal.ai/legal/terms-of-service
  • Терминал: на macOS и Linux обычный, на Windows - PowerShell.

Шаг 1. Ключ fal и баланс

  1. Зарегистрируйся на https://fal.ai
  2. Пополни баланс в разделе Баланс fal: https://fal.ai/dashboard/billing
  3. Купленные кредиты действуют 365 дней. Если баланс опустится ниже порога, аккаунт заблокируется и запросы перестанут проходить, пока не пополнишь.
  4. Открой раздел Ключи fal: https://fal.ai/dashboard/keys
  5. Нажми Create Key, выбери тип API и дай ключу понятное имя.
  6. Сразу скопируй ключ: второй раз fal его не покажет.

Шаг 2. Ставим genmedia и вставляем ключ

  1. macOS и Linux, в терминале: curl https://genmedia.sh/install -fsS | bash
  2. Windows, в PowerShell: irm https://genmedia.sh/install.ps1 | iex
  3. Закрой и снова открой терминал, чтобы команда genmedia стала доступна.
  4. Выполни genmedia setup и вставь ключ, когда мастер его попросит. genmedia сохранит ключ в своих настройках в зашифрованном виде.
  5. Проверь связь: genmedia models "nano banana" --limit 3 - в ответе появятся модели Nano Banana.

Шаг 3. Ставим скилл fal-media

  1. Запусти Claude Code в папке проекта, где хочешь хранить картинки и видео: claude
  2. Вставь в чат целиком промпт установки из следующего раздела - от слов «Создай личный скилл» до слов «Конец текста скилла».
  3. Claude Code создаст файл ~/.claude/skills/fal-media/SKILL.md и покажет путь к нему.
  4. Набери / и найди в списке fal-media. Если скилла нет, перезапусти Claude Code.

Вручную: создай папку ~/.claude/skills/fal-media, в ней файл SKILL.md. Первая строка файла - три дефиса, за ней строки name и description из шапки, затем снова строка из трёх дефисов, а после неё весь текст инструкции.

Промпт установки скилла

Создай личный скилл Claude Code: файл ~/.claude/skills/fal-media/SKILL.md (на Windows - папка .claude\skills\fal-media в папке пользователя). Файл начинается с YAML-шапки между двумя строками из трёх дефисов. В шапке два поля, name и description, их значения ниже. После шапки перенеси текст инструкции слово в слово, сохранив нумерацию и переносы строк. Ничего не запускай, только создай файл и покажи путь к нему.

Шапка:

name: fal-media

description: Генерирует картинки и видео через fal.ai. Превращает запрос своими словами в сильный промпт, делает картинку в Nano Banana, сохраняет её в папку проекта и по желанию оживляет в Kling 3 или Seedance 2.5. Используй, когда просят сгенерировать картинку, фото, обложку, иллюстрацию или видео из картинки.

Текст инструкции:

Ты генерируешь картинки и видео через fal.ai консольной утилитой genmedia. Запрос пользователя: $ARGUMENTS

Если запрос пустой, спроси, что нужно сгенерировать.

Правила

  1. Перед каждым платным запуском покажи план и примерную цену и дождись ответа «да». Каждая команда genmedia run создаёт новый платный запрос, поэтому никогда не запускай её повторно, чтобы узнать, готов ли результат.

  2. Сохраняй всё в папку media-gen в текущем проекте. Для каждой задачи - своя подпапка с датой и коротким названием латиницей, например media-gen/2026-09-17-moon-cat/

  3. Если команда genmedia не найдена или пишет No fal.ai API key found, остановись и попроси пользователя выполнить в обычном терминале genmedia setup, а потом перезапустить Claude Code.

  4. Если fal отвечает ошибкой про баланс или блокировку аккаунта, остановись и попроси пополнить баланс на https://fal.ai/dashboard/billing

Шаг 1. Разбери запрос

Определи главный объект, действие, место, настроение, стиль (фото, 3D, иллюстрация, аниме), для чего нужна картинка и какой формат подойдёт. Если непонятно, для чего картинка, задай один короткий вопрос. Остальное решай сам.

Шаг 2. Напиши промпт

Пиши промпт на английском одним абзацем в таком порядке: главный объект и что он делает; окружение и 3-5 конкретных деталей (фактуры, отражения, мелкие предметы); кадр и камера (крупный или общий план, ракурс, объектив); свет и время суток; стиль и качество изображения. Если на картинке нужен текст, дай его в кавычках и укажи, где он стоит. Не добавляй пустые слова вроде masterpiece или best quality.

Шаг 3. Выбери модель и покажи план

Модель по умолчанию - fal-ai/nano-banana-2, около 8 центов за картинку 1K, 2K дороже в 1,5 раза. Для максимального качества и сложного текста на картинке - fal-ai/nano-banana-pro, около 15 центов за картинку. Формат: 16:9 для обложек и горизонтальных видео, 9:16 для сторис и рилс, 1:1 для постов, 4:5 для ленты. Покажи пользователю название задачи, модель, формат, разрешение, примерную цену и сам промпт. Спроси: запускаем или что-то поправить?

Шаг 4. Сгенерируй и сохрани картинку

После «да» выполни команду, подставив свои значения:

genmedia run fal-ai/nano-banana-2 --prompt "ПРОМПТ" --aspect_ratio 16:9 --resolution 1K --num_images 1 --download media-gen/ПАПКА/ --json

Из ответа возьми путь к файлу из downloaded_files и ссылку на картинку из images (поле url). Ссылку запомни: по ней картинку можно оживить. Покажи пользователю путь к файлу и спроси, оживить ли картинку в видео. Предложи два варианта: Kling 3 - от 3 до 15 секунд, около 17 центов за секунду со звуком; Seedance 2.5 - от 4 до 30 секунд, в 720p около 47 центов за секунду, звук входит в цену.

Шаг 5. Напиши промпт движения

Если пользователь выбрал видео, опиши на английском в 1-3 предложениях, что именно двигается в кадре, как движется камера, какой темп и какой звук. Не пересказывай картинку: модель её уже видит. Длительность по умолчанию 5 секунд. Покажи промпт, модель, длительность и цену и дождись «да».

Шаг 6. Запусти видео в очереди

Для Kling 3:

genmedia run fal-ai/kling-video/v3/pro/image-to-video --prompt "ПРОМПТ ДВИЖЕНИЯ" --start_image_url "ССЫЛКА НА КАРТИНКУ" --duration 5 --async --json

Для Seedance 2.5:

genmedia run bytedance/seedance-2.5/image-to-video --prompt "ПРОМПТ ДВИЖЕНИЯ" --image_url "ССЫЛКА НА КАРТИНКУ" --duration 5 --resolution 720p --async --json

Из ответа сохрани request_id. Если пользователь дал свою картинку с диска и ссылки на неё нет, сначала выполни genmedia upload "ПУТЬ К КАРТИНКЕ" --json и возьми ссылку из cdn_url.

Шаг 7. Дождись и скачай видео

Раз в 30 секунд проверяй статус командой genmedia status ID-МОДЕЛИ REQUEST_ID --json, где ID-МОДЕЛИ - fal-ai/kling-video/v3/pro/image-to-video или bytedance/seedance-2.5/image-to-video. Пока статус не COMPLETED (в любом регистре), жди и проверяй снова, новых run не делай. Когда готово, скачай видео в ту же папку: genmedia status ID-МОДЕЛИ REQUEST_ID --download media-gen/ПАПКА/ --json. Если в ответе ошибка, покажи её пользователю и ничего не перезапускай без его ответа.

Шаг 8. Итог

Коротко перечисли, какие файлы сохранены и где, какие модели использованы и сколько примерно это стоило. Предложи следующий шаг: другой вариант картинки, другой формат или ещё одно видео.

Конец текста скилла.

Шаг 4. Первый запуск

  1. В Claude Code напиши: /fal-media кот в скафандре пьёт кофе на Луне, реализм, обложка для YouTube
  2. Claude покажет промпт на английском, модель Nano Banana 2, формат 16:9 и цену около 8 центов. Ответь «да» или попроси поправить.
  3. Claude Code спросит разрешение запустить команду genmedia - разреши.
  4. Картинка сохранится в папку media-gen внутри проекта, в подпапку с датой и названием.
  5. На вопрос про видео ответь, например: «да, Kling 3, пусть кот медленно поворачивает голову к камере и подмигивает».
  6. Видео генерируется дольше картинки: скилл сам проверяет статус раз в 30 секунд и скачивает ролик в ту же папку.

Ссылки на файлы fal открыты всем, у кого они есть, и хранятся на серверах fal не меньше 7 дней, поэтому скилл сразу сохраняет всё к тебе на диск.

Модели и цены на fal

Пример: картинка 1K в Nano Banana 2 и 5 секунд видео в Kling 3 со звуком стоят около 0,92 доллара. Цены на fal меняются, актуальная всегда на странице модели.

Если что-то не работает

  • Команда genmedia не найдена - закрой и снова открой терминал, перезапусти Claude Code. На Windows ставь genmedia из PowerShell.
  • No fal.ai API key found - выполни genmedia setup ещё раз и вставь ключ.
  • Запросы отклоняются из-за баланса - пополни баланс на https://fal.ai/dashboard/billing
  • Скилла нет в списке / - проверь, что файл лежит по пути ~/.claude/skills/fal-media/SKILL.md, и перезапусти Claude Code.
  • Нужна другая модель - попроси Claude найти её командой genmedia models и показать цену командой genmedia pricing, затем замени ID модели в тексте скилла.
  • Хочешь без консольной утилиты - у fal есть MCP-сервер для Claude Code, команда подключения во вкладке Claude Code на странице MCP-сервер fal: https://fal.ai/docs/documentation/setting-up/mcp (скилл из этого материала рассчитан на genmedia).