AIKraft/Skills/grok-media

grok-media

Инструкция по генерации изображений и видео через xAI Grok: аутентификация, эндпоинты, структура промптов, редактирование изображений, видео на основе референсов и асинхронный опрос. Полезно для интеграции медиа-функций xAI в проекты.

calesthio official Разработка ★ 64.9k

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

Навык обеспечивает интеграцию с медиа-моделями xAI (Grok) через OpenMontage для генерации изображений, их редактирования и создания видео. Он обрабатывает аутентификацию, отправку запросов к API и асинхронный опрос статуса выполнения задач.

Когда применять

  • Генерация изображений по текстовому описанию (text-to-image) с заданием соотношения сторон и разрешения.
  • Редактирование существующих изображений или создание композиций из нескольких источников (image editing/compositing).
  • Создание коротких видео по тексту, на основе одного изображения или с использованием нескольких референсных изображений для сохранения идентичности объектов.
  • Интеграция медиа-функций xAI в проекты с учетом ограничений по длительности и разрешению видео.

Как работает

  1. Настроить переменную окружения XAI_API_KEY и использовать базовый URL https://api.x.ai/v1 с заголовком авторизации.
  2. Сформировать промпт: для изображений описать субъект, действие и обстановку с одним стилевым якорем; для редактирования указать только изменения.
  3. Отправить запрос на соответствующий эндпоинт (POST /images/generations, /images/edits или /videos/generations) с указанием модели и параметров.
  4. Для видео-запросов выполнить асинхронный опрос статуса через GET /videos/{request_id} до получения статуса 'done' или ошибки.
  5. Обработать результат: скачать вывод promptly или вернуть ошибку с сохранением контекста запроса при сбое.
  6. Следовать рекомендациям по промптам: использовать естественный язык, избегать перегрузки сцены и явно указывать роль референсных изображений.

Примеры запросов агенту

Сгенерируй изображение кота в космосе в стиле киберпанк, используя модель 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 и совместимые) подхватывает его по описанию и следует шагам.