Agnes AI Generation Skill
Скрипт на Python вызывает API Agnes AI: текст, картинки и видео по описанию, фото или двум ключевым кадрам, с опросом готовности
- 425 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скрипт ходит на внешний API Agnes с вашим ключом и отправляет туда промпты и ссылки на картинки
- Автор советует отправить ключ агенту в чат, а ключ в истории чата остается на виду
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/agnes-ai-generation-skillОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скрипт ходит на внешний API Agnes с вашим ключом и отправляет туда промпты и ссылки на картинки
- Автор советует отправить ключ агенту в чат, а ключ в истории чата остается на виду
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл оборачивает официальные API Agnes AI в одну команду `scripts/agnes_api.py`. Агент генерирует текст моделью `agnes-2.0-flash`, в том числе потоком, рисует картинки и правит их моделью `agnes-image-2.1-flash`, а видео делает моделью `agnes-video-v2.0` из текста, из одной картинки, из набора картинок или между двумя ключевыми кадрами. Видео создается асинхронно: скрипт принимает идентификатор задачи, с флагом `--poll` опрашивает статус и возвращает ссылки на готовые файлы. Промпты для картинок и видео на другом языке скрипт сначала переводит на английский моделью `agnes-2.0-flash`, потому что видео на английском у Agnes выходит стабильнее. Перевод выключает флаг `--no-translate-prompt`. После генерации скилл по умолчанию возвращает только ссылки и ничего не скачивает на диск, пока вы не попросите сохранить файл. Для видео скрипт сам подставляет `--num-frames 121 --frame-rate 24` и перед запросом проверяет, что число кадров имеет вид 8n+1 и не больше 441.
Для кого. Пользователям Claude Code, Codex, Cursor и Windsurf с аккаунтом на платформе Agnes, которым нужны картинки и ролики из чата с агентом без ручной работы с REST.
Подходит, если
- Короткий ролик в кинематографичном стиле собирают из текстового описания и забирают по ссылке
- Одну картинку оживляют: добавляют легкое движение камеры и естественный свет
- Два изображения связывают плавным переходом через режим ключевых кадров
- Сцену на фото перерисовывают в другой стиль, сохраняя композицию
- Прежде чем строить конвейер, прогоняют `smoke-test` и смотрят, отвечают ли текст и картинки
Не подходит, если
- Агент должен вести многоходовой вызов функций через Agnes Responses API: автор прямо называет такой цикл ненадежным
- Нужны надежные режимы видео из нескольких картинок и по ключевым кадрам: автор не прогнал их до конца
- Аккаунта и ключа на платформе Agnes нет
- Файлы нужны сразу на диске: скилл по умолчанию отдает только ссылки
Пример запроса к агенту
Через Agnes сделай 5-секундное кинематографичное видео: кот идет по пляжу на закате, дождись готовности и верни ссылкуОграничения
Нужен ключ с платформы Agnes (`https://platform.agnes-ai.com/`), его задают в `AGNES_API_KEY`, `AGNES_API_TOKEN` или `APIHUB_AGNES_API_KEY`. Запросы идут на `https://apihub.agnes-ai.com`. Автор не проверил до конца режимы нескольких картинок и ключевых кадров, а один раз сервер вернул ошибку `division by zero` при опросе задачи, поэтому режимы стоит пробовать по одному. Вызов инструментов поддержан только как форма запроса: Responses API с несколькими ходами не годится для автоматического цикла агента. Автор советует отправить ключ агенту в чат, но надежнее задать переменную окружения: тогда ключ не останется в истории. Последний релиз v0.1.0, коммиты июня 2026 года.
Как отключить. Удалите папку скилла `agnes-ai-generation` из каталога скиллов агента и снимите переменную `AGNES_API_KEY` из окружения. Если задавали ее на Windows на уровне пользователя, удалите запись в настройках среды. Ключ на платформе Agnes удалите вручную, если он больше не нужен.
Частые вопросы
Как подключить Agnes к Claude Code или Codex?
Выполните `npx skills add Yacey/agnes-ai-generation-skill`, а для всех поддерживаемых агентов добавьте флаг `--all`. Затем получите ключ на платформе Agnes и задайте его в переменной `AGNES_API_KEY`.
Какие модели вызывает скилл?
`agnes-2.0-flash` для текста, `agnes-image-2.1-flash` для картинок и правки изображений, `agnes-video-v2.0` для видео из текста, картинки, набора картинок или ключевых кадров.
Как получить готовое видео?
Запустите `python scripts/agnes_api.py video --prompt "..." --poll`. Скрипт создаст задачу, будет опрашивать статус по `video_id` и вернет ссылку на mp4. Статус задачи отдельно показывает `video-get` с идентификатором.
Почему скилл переводит мой промпт на английский?
Agnes стабильнее делает видео и картинки по английским промптам, поэтому скрипт переводит чужие языки моделью `agnes-2.0-flash`. Если нужен ваш исходный текст, добавьте `--no-translate-prompt`.
Скачивает ли скилл файлы на диск?
Нет, по умолчанию он возвращает только поле `urls`. Файл на диск попадает, если вы прямо просите скачать или сохранить результат.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыТри скилла вызывают бесплатные модели Agnes AI: чат, изображения и видео через Python-скрипты и ключ из переменной окружения
Скилл превращает идею, ссылку или скринкаст в готовое видео: аватар HeyGen, b-roll, субтитры и контроль качества
Три скилла HeyGen: аватар по фото, видео с ним в кадре по описанию и перевод готовых роликов с переозвучкой и синхронизацией губ
Скилл пишет промпты для генерации видео, картинок и музыки на 14 платформах и по желанию отправляет их в браузере
Генерация и правка картинок из любого агента: CLI imagegen-agent и скилл с библиотекой промптов Codex для совместимых API
Два скилла для генеративного видео и картинок: video пишет промпты для Seedance, Kling и Veo по правилам драматургии, image подбирает модель и синтаксис
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Agnes AI Generation Skill (эта карточка) | нет | 425 | |
| AI Video Generator | нет | 456 | десять скиллов готовят подробные промпты для Seedance 2.0; этот скилл сам вызывает API Agnes и возвращает готовые файлы |
| Nano Banana 2 Skill | нет | 417 | картинки через Gemini; здесь модели Agnes и видео, в том числе по ключевым кадрам |
Коротко о README
Страница идет по шагам: получить ключ, поставить скилл, задать переменную, дать первый запрос. Дальше набор примеров команд для текста, картинок и видео, раздел про язык промптов, список проверенного и непроверенного на настоящем API и схема репозитория. Есть версия на английском.
Бейдж для README
Исходный SKILL.md
--- name: agnes-ai-generation description: Call Agnes AI / Sapiens AI generation APIs for text, image, and video. Use when the user asks to use Agnes models, Agnes Image, Agnes Video, Agnes 2.0 Flash, apihub.agnes-ai.com, or to generate text, images, edit images, create videos, animate images, create keyframe videos, or test Agnes API calls. --- # Agnes AI Generation Use this skill to call Agnes text, image, and video generation APIs through `https://apihub.agnes-ai.com`. ## Quick Start 1. Read `references/api.md` when endpoint details, parameters, or response fields are needed. 2. Use `scripts/agnes_api.py` for real API calls instead of rewriting curl by hand. 3. Require an API key in `AGNES_API_KEY`, `AGNES_API_TOKEN`, or `APIHUB_AGNES_API_KEY`. Never print the key. 4. For light live verification, run `smoke-test`; it avoids video creation by default. Add `--include-image-edit` for image-to-image, and add `--video-case <case>` explicitly for video modes. Treat the skill as fully tested only when basic text, text streaming, text tool calling, text-to-image, image-to-image, text-to-video, image-to-video, multi-image video, keyframe video, and video retrieval return successful responses. ## Commands Text generation: ```bash python scripts/agnes_api.py text --prompt "Write a concise product tagline for an AI assistant." ``` Streaming text: ```bash python scripts/agnes_api.py text --prompt "Write a short product intro." --stream ``` Streaming output is normalized and includes aggregated `content`, `events`, `done`, and a short `raw_prefix`. Image generation: ```bash python scripts/agnes_api.py image --prompt "A luminous floating city above a misty canyon at sunrise, cinematic realism" --size 1024x768 ``` Image-to-image: ```bash python scripts/agnes_api.py image --prompt "Turn the scene into a rainy cyberpunk night while preserving composition" --image https://example.com/input.png --size 1024x768 ``` Text-to-video with polling: ```bash python scripts/agnes_api.py video --prompt "A cinematic shot of a cat walking on the beach at sunset" --poll ```