grok-media
Инструкция по генерации изображений и видео через xAI Grok: аутентификация, эндпоинты, структура промптов, редактирование изображений, видео на основе референсов и асинхронный опрос. Полезно для интеграции медиа-функций xAI в проекты.
AIcalesthio
official
Разработка
★ 64.9k
Что делает навык
Навык обеспечивает интеграцию с медиа-моделями xAI (Grok) через OpenMontage для генерации изображений, их редактирования и создания видео. Он обрабатывает аутентификацию, отправку запросов к API и асинхронный опрос статуса выполнения задач.
Когда применять
- Генерация изображений по текстовому описанию (text-to-image) с заданием соотношения сторон и разрешения.
- Редактирование существующих изображений или создание композиций из нескольких источников (image editing/compositing).
- Создание коротких видео по тексту, на основе одного изображения или с использованием нескольких референсных изображений для сохранения идентичности объектов.
- Интеграция медиа-функций xAI в проекты с учетом ограничений по длительности и разрешению видео.
Как работает
- Настроить переменную окружения XAI_API_KEY и использовать базовый URL https://api.x.ai/v1 с заголовком авторизации.
- Сформировать промпт: для изображений описать субъект, действие и обстановку с одним стилевым якорем; для редактирования указать только изменения.
- Отправить запрос на соответствующий эндпоинт (POST /images/generations, /images/edits или /videos/generations) с указанием модели и параметров.
- Для видео-запросов выполнить асинхронный опрос статуса через GET /videos/{request_id} до получения статуса 'done' или ошибки.
- Обработать результат: скачать вывод promptly или вернуть ошибку с сохранением контекста запроса при сбое.
- Следовать рекомендациям по промптам: использовать естественный язык, избегать перегрузки сцены и явно указывать роль референсных изображений.
Примеры запросов агенту
Сгенерируй изображение кота в космосе в стиле киберпанк, используя модель grok-imagine-image.
Возьми это изображение и добавь к нему красную шляпу, используя эндпоинт редактирования.
Создай короткое видео, где персонаж с первого референсного изображения надевает куртку со второго, используя режим reference-to-video.
Что понадобится
- Переменная окружения XAI_API_KEY
- Доступ к API xAI (базовый URL https://api.x.ai/v1)
Описание составлено по SKILL.md навыка, сверено 08.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «grok-media» из репозитория:
# https://github.com/calesthio/openmontage
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r grok-media/ ~/.claude/skills/grok-media/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.