Изображения и видео

Modelflare Media Skill

Установите один навык агента, чтобы Claude Code, Codex или любой агент, поддерживающий SKILL.md, мог выбрать изображение или видеомодель Modelflare, оценить стоимость звонка, отправить его и сохранить результат.

Modelflare Media Skill — это устанавливаемый навык агента: папка с SKILL.md, сгенерированной ссылкой на модель и одним вспомогательным скриптом. Как только оно окажется в каталоге навыков вашего агента, Claude Code, Codex или любой агент, который читает SKILL.md, знает, как выбрать изображение или видеомодель Modelflare, указать его цену, отправить правильный запрос, дождаться видео и сохранить результат.

Пакет создается на основе действующего каталога моделей каждые несколько минут, поэтому список моделей и цены в нем никогда не устаревают. Текстовые модели намеренно исключены: у вашего агента они уже есть. Вспомогательному сценарию требуется только Node.js 18 или новее, который уже требуется Claude Code и Codex, и он ведет себя одинаково в macOS, Windows и Linux.

1. Установите

Вам не нужно знать, где ваш агент хранит навыки; агент делает. Отправьте ему это сообщение, одинаковое для каждого агента:

Install this skill: https://modelflare.dev/skills/modelflare-media/modelflare-media.zip (or use the attached zip), then read its SKILL.md. If you do not support skills, extract it anywhere and follow SKILL.md. My key is in the environment variable MODELFLARE_API_KEY.

Если агент не может загрузить файлы, скачайте zip-архив самостоятельно и прикрепите его к сообщению. Агенты, поддерживающие навыки (Claude Code, Codex и другие), устанавливают его в свое местоположение навыков; агент без механизма навыков все равно может читать SKILL.md из любого места, где он извлек пакет.

Ручная установка (необязательно)

Требуется только в том случае, если вы предпочитаете размещать файлы самостоятельно, например, на общей машине или в CI.

curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

Оба устанавливаются в ~/.claude/skills/modelflare-media (в Windows это %USERPROFILE%\.claude\skills), что Claude Code воспринимается как навык уровня пользователя; копия уровня проекта попадает в .claude/skills/ внутри репозитория. Для другого агента сначала установите SKILL_DIR в его папку навыков (точный путь см. в документации этого агента).

SKILL_DIR=~/.codex/skills curl -fsSL https://modelflare.dev/skills/modelflare-media/install.sh | sh

$env:SKILL_DIR = "$HOME\.codex\skills"; irm https://modelflare.dev/skills/modelflare-media/install.ps1 | iex

Вы также можете напрямую прочитать SKILL.md, чтобы увидеть, что будет делать агент.

2. Дайте вашему агенту ключ

Создайте ключ API в консоли и установите его в среде, в которой работает ваш агент. В macOS и Linux добавьте экспорт в свой профиль оболочки, чтобы сохранить его; в Windows вторая строка делает его постоянным.

macOS или Linux
Windows PowerShell

export MODELFLARE_API_KEY="sk-..."

$env:MODELFLARE_API_KEY = "sk-..."
setx MODELFLARE_API_KEY "sk-..."

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

Навык никогда не записывает ключ в файлы или подсказки и никогда не печатает его. Учетные записи, созданные через Castaly, уже имеют ключ с именем Castaly, который маршрутизируется через каждую разблокированную группу; любой другой ключ с группами изображений или видео тоже подойдет.

3. Попросите СМИ

Поговорите со своим агентом как обычно:

«Создайте плакат прибрежной обсерватории в сумерках в формате 16:9 с помощью gpt-image-2.»
«Превратите этот стартовый кадр в 5-секундное видео 1080p с помощью Seedance».
«Какие видеомодели стоимостью менее 0,10 доллара США в секунду могут выполнять преобразование изображения в видео?»

Агент читает SKILL.md, извлекает действующий каталог из https://modelflare.dev/api/pricing, чтобы узнать, какие модели может использовать ключ и сколько они стоят, затем открывает собственную страницу этой модели на сайте документации для получения точного тела запроса, таблицы параметров и ограничений и вызывает API с помощью собственного HTTP-клиента. Каждый вызов несет заголовок X-Modelflare-Skill: modelflare-media/1.0, поэтому журналы использования показывают, какие запросы поступили от навыка.

4. Из верстака Castaly

Каждое поколение в Castaly Workbench имеет панель «Воспроизведите это в своем собственном агенте» с сообщением об установке, zip-архивом и кратким описанием задачи. Отправьте сообщение об установке один раз, затем вставьте бриф, и агент воспроизведет ту же модель и параметры с вашим собственным ключом.

Чего навык не делает

Он не говорит вашему агенту, как работать. Повторные попытки, пакетная обработка и информация об отчетах находятся между вами и вашим агентом; навык документирует только API.
У него нет собственного списка моделей. Каталог и каждый контракт на запрос считываются в реальном времени, поэтому опубликованную сегодня модель можно использовать уже сегодня.
Файлы не загружаются ни в какое хранилище: локальные эталонные изображения встраиваются в запрос в виде URL-адресов данных, поэтому сохраняйте их небольшими (несколько МБ).
Он не может разблокировать группы моделей. Если API отвечает model_unavailable, эта модель недоступна для этой учетной записи.

Макет упаковки

modelflare-media/
  SKILL.md   authentication, where the live catalog is, how to find each model's
             request contract on the docs site, and what the error codes mean

Пакет не содержит данных модели, поэтому он не устаревает; переустановите только для того, чтобы получить новую версию навыка.