Разработчикам · MCP
Изображения и видео прямо из вашего ИИ-агента
MCP-сервер FlyAIgh даёт Claude Code, Codex, Cursor и другим MCP-клиентам доступ ко всем моделям изображений и видео на FlyAIgh: узнать цену, сгенерировать, использовать свои файлы как референсы и скачать результат — всё с одного баланса кредитов.
Нужна подписка Basic или выше.
Адрес
- URL
- https://www.flyaigh.com/api/mcp
- Транспорт
- Streamable HTTP (без сессий)
- Аутентификация
- Authorization: Bearer <ваш API-ключ>
Настройка в три шага
- 1
Оформите Basic или выше
API входит во все платные подписки начиная с Basic, помесячные и годовые. Кредиты, потраченные через API, списываются с того же баланса, что и на сайте.
- 2
Создайте API-ключ
Откройте Инструменты → MCP, задайте имя и скопируйте ключ. Он начинается с fa_live_, показывается только один раз, и его можно отозвать в любой момент.
- 3
Добавьте FlyAIgh в агента
Вставьте одну из конфигураций ниже и просите у агента изображение или видео обычными словами.
Подключите клиента
Замените fa_live_your_key своим ключом. Не храните ключ в общих файлах и репозиториях.
Claude Code
claude mcp add --transport http flyaigh https://www.flyaigh.com/api/mcp \
--header "Authorization: Bearer fa_live_your_key"Codex · ~/.codex/config.toml
[mcp_servers.flyaigh]
url = "https://www.flyaigh.com/api/mcp"
bearer_token_env_var = "FLYAIGH_API_KEY"Затем задайте ключ в терминале: export FLYAIGH_API_KEY=fa_live_your_key
Cursor · ~/.cursor/mcp.json
{
"mcpServers": {
"flyaigh": {
"url": "https://www.flyaigh.com/api/mcp",
"headers": { "Authorization": "Bearer fa_live_your_key" }
}
}
}Другие клиенты (только stdio)
npx -y mcp-remote https://www.flyaigh.com/api/mcp \
--header "Authorization: Bearer fa_live_your_key"Для клиентов, которые умеют запускать только локальную команду, mcp-remote соединяет их с HTTP-адресом.
Инструменты
Агент видит восемь инструментов. Два из них тратят кредиты, остальные только читают.
- list_models
- Модели изображений или видео: режимы, длительности, разрешения, пропорции, лимиты референсов и пример цены.
- quote
- Точная стоимость запроса в кредитах — те же проверки и та же цена, что и при реальном вызове. Ничего не списывается.
- generate_image
- Создать изображение по тексту или на основе ваших референсов. Тратит кредиты.
- generate_video
- Создать видео по тексту, первому кадру, первому и последнему кадру или по референсным изображениям, видео и аудио. Тратит кредиты.
- get_job
- Статус задачи. Когда готово — ссылка на скачивание; неудачные задачи возвращаются автоматически.
- list_my_generations
- Ваши недавние генерации — чтобы снова использовать как референс или скачать ещё раз.
- upload_file
- Загрузите своё изображение, видео или аудио и получите id файла для использования как референс.
- get_balance
- Остаток кредитов, ваш тариф и сколько этот ключ потратил сегодня и в этом месяце.
Что можно попросить
Сделай во FlyAIgh 5-секундное видео 9:16: бумажный кораблик плывёт по дождливой ночной улице. Сначала покажи цену, потом сгенерируй и сохрани файл в ./out.
Хороший агент вызывает quote, спрашивает подтверждение, генерирует с expected_credits и idempotency_key и проверяет get_job, пока файл не будет готов.
Цены и ограничения
- Те же кредиты, что и на сайте, для той же модели и настроек. Никакой наценки за API и отдельного счёта.
- Расходы ограничены балансом кредитов. На странице MCP можно задать ключу собственный дневной лимит; по умолчанию его нет. Расход по каждому ключу по дням виден на той же странице.
- Если цена изменилась между quote и генерацией, ничего не списывается и возвращается новая цена (expected_credits).
- Каждый ключ может отправлять 10 задач в минуту, поэтому зациклившийся агент быстро останавливается. Повтор с тем же idempotency_key в течение 24 часов никогда не списывает дважды.
- Загрузки: изображения до 25 МБ, видео до 200 МБ, аудио до 30 МБ; загрузка в base64 до 3 МБ. Референсами могут быть только ваши файлы и генерации.
- Неудачные задачи возвращаются автоматически. Приватные оригиналы отдаются подписанными ссылками, которые действуют один час.
Вопросы
Какой тариф нужен для API FlyAIgh?
Любая подписка начиная с Basic, помесячная или годовая. Бесплатные аккаунты и аккаунты, купившие только пробный пакет или пакет кредитов, создавать ключи не могут. Когда подписка заканчивается, ключи приостанавливаются и снова работают после продления.
Как оплачивается использование API?
Кредитами с того же баланса, что и на сайте, по той же цене для той же модели и настроек. Перед генерацией вызовите quote, чтобы узнать точную цену. Дополнительной платы за API нет.
Какие модели доступны агенту?
Все модели изображений и видео на FlyAIgh. Инструмент list_models возвращает актуальный список с режимами, длительностями, разрешениями и примером цены для каждой модели, так что агент всегда видит то же, что предлагает сайт.
Можно ли использовать свои изображения, видео или аудио?
Да. upload_file даёт агенту ссылку для загрузки (или принимает небольшой файл напрямую) и возвращает id файла для первого кадра или референса. Подойдут и прошлые генерации из библиотеки.
Безопасен ли мой API-ключ?
Мы храним только хеш ключа, сам ключ показывается один раз, а отозвать его можно на странице MCP в любой момент — отозванный ключ сразу перестаёт работать. Обращайтесь с ним как с паролем: храните в переменной окружения, а не в общем файле.
Работает ли это в ChatGPT или приложениях Claude?
Пока сервер использует API-ключи, которые поддерживают агенты для программирования — Claude Code, Codex и Cursor. Подключение в один клик для приложений ChatGPT и Claude требует входа через OAuth; оно запланировано.
Добавьте модели в свою работу
Создайте ключ, добавьте одну строку в агента и делайте изображения и видео, не выходя из редактора или терминала.
Создать API-ключ