convez.ai
SkillIntegração & APIsIntermediário
aokazikov-spec

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 GitHub
InicialPluginScore · de 0 a 100

Skill 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-api

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

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 — навык для ИИ-агентов

Version API License: MIT QOYO

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-ключ

  1. Войдите на qoyo.ru/cabinet
  2. Создайте ключ в разделе API для ИИ-агентов
  3. Скопируйте 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. Первый запрос через агента

Скажите агенту: «Сгенерируй картинку заката в горах». Агент должен:

  1. Уточнить модель и параметры
  2. Вызвать POST /price и показать стоимость
  3. Дождаться вашего «да»
  4. Вызвать 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:16bytedance/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.02026-06-05Протокол общения, сценарии, Nano Banana Pro
1.0.02026-06-04Первый публичный пакет

Скачать архив: GitHub Releases (после публикации репозитория).


Ссылки

РесурсURL
QOYO Studiohttps://qoyo.ru
Личный кабинет / ключ APIhttps://qoyo.ru/cabinet?tab=developers
OpenAPIhttps://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 /price before POST /generate; never guess resolution/duration
  • Account — API keys and balance top-up only at qoyo.ru/cabinet; API discount via support form

Quick setup

  1. Create qoyo_sk_… at qoyo.ru/cabinet?tab=developers
  2. Copy SKILL.md → .cursor/skills/qoyo-agent-api/SKILL.md
  3. QOYO_API_KEY + QOYO_API_BASE=https://qoyo.ru/api/v1
  4. Agent flow: GET /catalog/{modelId} → POST /price → user confirms → POST /generate

Docs: AGENT_SETUP.md · SKILL.md · QOYO_AGENT_API.md

Ver o original no GitHub

Bom para

Relacionados