QOYO Agent API
aokazikov-spec/qoyo-agent-api
Gera imagens, vídeos e áudio via API única com confirmação de preço
Ver no GitHubSkill oficial do QOYO Studio que integra geração de imagens, vídeos e áudio em agentes IA (Claude, Cursor). Oferece confirmação de preço antes da execução e suporta as principais plataformas de geração através de uma API unificada.
Instalação
npx convez-ai aokazikov-spec/qoyo-agent-api1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar conteúdo visual sob demanda em agentes IA
- Criar reels, logos e capas automaticamente
- Orquestrar múltiplos modelos de geração (diffusion, video, TTS)
- Controlar custos com preview de preço antes de executar
Veredito

Skill bem estruturado e documentado que simplifica integração com serviços de geração de mídia. Recomendado para desenvolvedores que precisam abstrair complexidade de múltiplos provedores de IA generativa, com ponto positivo em transparência de custos.
README
A tradução para o português deste README ainda está na fila.
QOYO Agent API — навык для ИИ-агентов
RU: QOYO Studio — это единая платформа, которая объединяет лучшие нейросетевые модели для создания картинок, видео и аудио. Официальный навык‑агент встраивает эту платформу прямо в Cursor, Claude и ваших ботов. Опишите, что нужно получить, — агент уточнит настройки, покажет точную стоимость и начнёт генерацию только после вашего явного «да». Подробная документация на русском и английском.
EN: QOYO Studio is a single platform that brings together the best AI models for generating images, video and audio. The official agent skill embeds this platform directly into Cursor, Claude and your own bots. Describe what you want, and the agent will refine the parameters, show you the exact price, and only start generating after your explicit “yes.” Full documentation in English and Russian.
Keywords: cursor skill, ai agent, mcp, openapi, text-to-image, text-to-video, image generation api, video generation api, навык cursor, генерация видео, генерация изображений, навык для ии агента, навык для ии генерации
English docs — § English below · Репозиторий: github.com/aokazikov-spec/qoyo-agent-api
Для кого этот репозиторий
| Аудитория | Что получаете |
|---|---|
| Разработчики агентов | Готовый SKILL.md с протоколом общения и рекомендациями моделей |
| Пользователи Cursor | Копируете навык в .cursor/skills/ — агент сам ходит в API |
| Интеграторы / партнёры | Документация API, MCP-дескриптор, примеры curl |
| Владельцы ботов | Биллинг с баланса личного кабинета QOYO, без угадывания цен |
Production API: https://qoyo.ru/api/v1
Ключ API: qoyo.ru/cabinet → раздел «Разработчикам» → qoyo_sk_… (показывается один раз)
Состав репозитория
| Файл | Назначение |
|---|---|
| SKILL.md | Главный навык — протокол диалога, модели, сценарии (рилс, логотип, обложка, сторис) |
| AGENT_SETUP.md | Пошаговая установка и чеклист перед /generate |
| QOYO_AGENT_API.md | Полная документация API (EN + RU) |
| PRICING_AND_INPUT.md | Расчёт цены, billingInput, особые модели |
| ENDPOINTS.md | Шпаргалка по маршрутам |
| mcp-qoyo-agent.json | Дескриптор MCP (OpenAPI transport) |
| .env.example | Шаблон переменных окружения |
| examples/ | Примеры curl и тел запросов |
| CHANGELOG.md | История версий |
Живые схемы на сервере: OpenAPI · каталог моделей GET /catalog
Быстрый старт (5 минут)
1. Получите API-ключ
- Войдите на qoyo.ru/cabinet
- Создайте ключ в разделе API для ИИ-агентов
- Скопируйте
qoyo_sk_…— повторно не показывается
2. Настройте окружение
cp .env.example .env
# отредактируйте .env:
# QOYO_API_KEY=qoyo_sk_ваш_ключ
# QOYO_API_BASE=https://qoyo.ru/api/v1
3. Установите навык
Cursor:
.cursor/skills/qoyo-agent-api/SKILL.md ← скопируйте SKILL.md из этого репо
Или клонируйте весь репозиторий и укажите агенту путь к SKILL.md.
Claude / другой агент: прочитайте AGENT_SETUP.md и передайте агенту SKILL.md + AGENT_SETUP.md.
4. Проверьте подключение
export QOYO_API_KEY="qoyo_sk_…"
export QOYO_API_BASE="https://qoyo.ru/api/v1"
curl -s -H "Authorization: Bearer $QOYO_API_KEY" "$QOYO_API_BASE/me"
Ожидайте JSON с балансом кредитов.
5. Первый запрос через агента
Скажите агенту: «Сгенерируй картинку заката в горах». Агент должен:
- Уточнить модель и параметры
- Вызвать
POST /priceи показать стоимость - Дождаться вашего «да»
- Вызвать
POST /generate
Поведение агента (кратко)
Подробно — в SKILL.md § User Interaction Protocol.
Уточнить задачу → собрать промпт и параметры из каталога
→ GET /catalog/{modelId}
→ POST /price → показать кредиты и ₽
→ подтверждение пользователя
→ POST /generate → GET /tasks/{id}?sync=1
Критично:
- Не угадывать
duration,resolution,aspect_ratio— только из каталога - Не вызывать
/generateбез/priceи подтверждения inputдля generate = тот же, что в/price(илиbillingInput)
Рекомендуемые модели (v1.1)
Всегда сверяйте с GET /catalog — id и опции могут меняться.
| Задача | modelId |
|---|---|
| Универсальная картинка | gpt-image-2-text-to-image |
| Быстрая картинка + референсы | nano-banana-pro |
| Рилс / Shorts 9:16 | bytedance/seedance-2-fast |
| Оживить фото → видео | kling-2.6/image-to-video |
| Говорящий аватар / сторис | kling/ai-avatar-standard + ElevenLabs TTS |
| Музыка | suno/generate-music |
| Озвучка | elevenlabs/text-to-speech-multilingual-v2 |
Готовые диалоги: рилс, логотип, обложка трека, сторис с аватаром — в SKILL.md § Scenario examples.
Подключение MCP
Файл mcp-qoyo-agent.json описывает HTTP-транспорт к OpenAPI QOYO. Добавьте путь к файлу в конфиг MCP-клиента; Bearer-токен — ваш QOYO_API_KEY.
Рекомендуемый порядок вызовов:
GET /me → GET /catalog → GET /catalog/{modelId}
→ POST /price → POST /generate → GET /tasks/{id}?sync=1
API workflow
sequenceDiagram
participant User
participant Agent
participant QOYO as QOYO API
Agent->>QOYO: GET /me (баланс)
Agent->>User: Уточнить задачу и параметры
Agent->>QOYO: GET /catalog/{modelId}
Agent->>QOYO: POST /price
Agent->>User: Стоимость — подтверждаете?
User->>Agent: Да
Agent->>QOYO: POST /generate
Agent->>QOYO: GET /tasks/{id}?sync=1
Agent->>User: resultUrls[]
Биллинг
- Списание с баланса личного кабинета (кредиты)
POST /price— единственный источникcreditsиbillingInput- Скидка API (до 30%) уже в ответе
/price - Реферальные бонусы не начисляются на расходы через API
Подробнее: PRICING_AND_INPUT.md
Примеры curl
bash examples/curl-examples.sh
Или вручную — см. examples/request-price.json, examples/request-generate.json.
Версии и релизы
| Версия | Дата | Изменения |
|---|---|---|
| 1.1.0 | 2026-06-05 | Протокол общения, сценарии, Nano Banana Pro |
| 1.0.0 | 2026-06-04 | Первый публичный пакет |
Скачать архив: GitHub Releases (после публикации репозитория).
Ссылки
| Ресурс | URL |
|---|---|
| QOYO Studio | https://qoyo.ru |
| Личный кабинет / ключ API | https://qoyo.ru/cabinet?tab=developers |
| OpenAPI | https://qoyo.ru/api/v1/openapi.json |
| Документация на сайте | https://qoyo.ru/docs/QOYO_AGENT_API.md |
| Поддержка | https://qoyo.ru/help |
Разработка пакета
Каноническая копия в монорепозитории QOYO: integration/qoyo-agent-api/.
Этот репозиторий — standalone-выкладка для GitHub; синхронизируется из publish/qoyo-agent-api/ в проекте QOYOFin.
Лицензия
MIT — свободное использование документации и навыка; генерация контента оплачивается через API QOYO по тарифам сервиса.
English
QOYO Agent API — official integration pack for AI coding agents (Cursor, Claude Code, OpenClaw, custom bots) to generate images, video, audio and run chat models through QOYO Studio public REST API.
Features
- SKILL.md — conversation protocol, model recommendations (GPT Image, Nano Banana Pro, Seedance, Kling Avatar, Suno, ElevenLabs…)
- Scenario templates — Reels, logo, album cover, talking-head Stories
- MCP — mcp-qoyo-agent.json + live OpenAPI
- Accurate billing —
POST /pricebeforePOST /generate; never guess resolution/duration - Account — API keys and balance top-up only at qoyo.ru/cabinet; API discount via support form
Quick setup
- Create
qoyo_sk_…at qoyo.ru/cabinet?tab=developers - Copy
SKILL.md→.cursor/skills/qoyo-agent-api/SKILL.md QOYO_API_KEY+QOYO_API_BASE=https://qoyo.ru/api/v1- Agent flow:
GET /catalog/{modelId}→POST /price→ user confirms →POST /generate
Docs: AGENT_SETUP.md · SKILL.md · QOYO_AGENT_API.md