API GPT Image 2.5 уже доступен. Создавайте и редактируйте изображения →
PoYoPoYo

PoYo MCP Server

Все модели PoYo в вашем AI Agent.

Подключитесь один раз, чтобы Codex, Claude Code, Cursor и VS Code могли искать модели изображений, видео, аудио, чата и 3D, читать актуальные Schema и открытые цены и запускать задачи через PoYo.

MCP — это безопасное подключение, которое позволяет AI Agent использовать модели PoYo без самостоятельного написания API-запросов.

npx -y @poyoapi/mcp

Локальный stdio-мост для VS Code или клиентов только со stdio. Требуется Node.js 20+; используйте настройку ниже.

Создать API KeyПосмотреть настройкуДокументация MCP

Настройка

Подключитесь за три шага. Открывайте расширенные настройки только для ограничения категорий или моделей.

1

Подготовьте API Key

Сначала создайте PoYo API Key. Он понадобится клиенту при подключении.

Не вставляйте настоящий API Key в общий файл конфигурации или URL.

Создать API Key
2

Выберите клиент и найдите конфигурацию

Выберите используемое приложение, чтобы увидеть только подходящее расположение конфигурации.

Рекомендуемый способ

Откройте Settings в Codex, выберите MCP servers, затем Add server и Streamable HTTP.

Открыть официальную инструкцию клиента

Файл ручной конфигурации

~/.codex/config.toml

Область действия

Все проекты текущего пользователя

Откройте настройки MCP в клиенте. Если визуального входа нет, откройте или создайте указанный выше файл.

Пути с ./ находятся внутри открытого проекта. При необходимости создайте папку или файл.

3

Добавьте конфигурацию и проверьте

Скопируйте конфигурацию выбранного клиента, перезагрузите MCP и выполните бесплатную проверку.

Объедините существующую конфигурацию, не перезаписывайте её

Если файл уже содержит другие MCP Server, добавьте только запись poyo и сохраните всё существующее содержимое.

Добавьте следующую конфигурацию в ~/.codex/config.toml

[mcp_servers.poyo]
url = "https://api.poyo.ai/mcp"
bearer_token_env_var = "POYO_API_KEY"
tool_timeout_sec = 45

Сохраните API Key в переменной окружения POYO_API_KEY до запуска клиента. После сохранения начните новую сессию Codex, чтобы конфигурация MCP загрузилась заново.

Как задать POYO_API_KEY?

Скопируйте команду для своей системы, замените your_api_key на настоящий Key и запустите клиент из той же сессии терминала.

macOS / Linux

export POYO_API_KEY="your_api_key"

Windows PowerShell

$env:POYO_API_KEY="your_api_key"

Эти команды действуют только в текущей сессии терминала. Не сохраняйте настоящий Key в файлах проекта, снимках экрана или открытых журналах команд.

Документация MCP
Попросить Agent помочь с настройкой

Скопируйте безопасный Prompt, который сохранит настройки, не запишет настоящий Key в файл и покажет diff перед изменением.

Проверьте подключение

Проверяйте эти состояния по порядку. Платные задачи моделей не запускаются.

  1. 1Инструменты PoYo видны в клиенте: конфигурация загружена.
  2. 2poyo_account возвращает данные аккаунта: API Key работает.
  3. 3poyo_search_models возвращает модели: каталог доступен.
Подключение не работает?
  • Нет инструментов: проверьте расположение конфигурации и перезагрузите MCP Server.
  • Проверка аккаунта не прошла: проверьте POYO_API_KEY и перезапустите клиент из той же среды.
  • Сбой подключения: проверьте https://api.poyo.ai/mcp и доступ HTTPS в сети или прокси.

Когда проверки инструментов, аккаунта и каталога пройдены, PoYo MCP подключён.

Что может Agent с PoYo MCP?

Опишите задачу обычным языком. Agent найдёт подходящую модель, прочитает её входные данные и цену, запустит её и вернёт результат после завершения длительной задачи.

Поиск моделей

Поиск актуальных моделей изображений, видео, аудио, чата или 3D по задаче на естественном языке

poyo_search_models
Подходящие модели

Чтение входных данных

Чтение актуальной входной Schema, примеров, протоколов и возможностей

poyo_get_model_schema
Допустимые входные данные

Проверка цены

Чтение текущей открытой цены перед платным запросом

poyo_get_pricing
Подтверждение цены

Запуск коротких задач

Выполнение задач чата или генерации, которые возвращаются после короткого ожидания

poyo_chatpoyo_run_model
Готовый результат

Продолжение длительных задач

Отправка длительной задачи, сохранение task_id и последующее чтение состояния и результатов

poyo_submit_jobpoyo_check_job
Состояние и результат

Чтение аккаунта

Чтение текущих данных аккаунта и кредитов перед выполнением модели

poyo_account
Состояние аккаунта

Когда использовать MCP, CLI или REST API?

Используйте MCP, когда Agent должен выбирать и вызывать модели, PoYo CLI — для автоматизации в терминале или CI, а REST API — для трафика приложения или вывода по токенам.

01

AI-ассистент или Agent для программирования

Выбор

MCP

Streamable HTTP

Почему подходит

Позволяет Agent находить модели, читать Schema и цены и вызывать инструменты в редакторе или диалоге.

Что вы контролируете

Область инструментов и разрешения клиента

Документация
02

Скрипты терминала или CI

Выбор

PoYo CLI

@poyoapi/cli

Почему подходит

Находите модели, запускайте генерацию, ожидайте задачи и выводите JSON, JSONL или CSV из оболочки.

Что вы контролируете

Флаги команд, входные файлы и формат вывода

Документация
03

Бэкенд вашего приложения

Выбор

REST API

HTTP + JSON / SSE

Почему подходит

Обрабатывайте трафик приложения, поток токенов, опрос, Webhook и пакетные задачи.

Что вы контролируете

Жизненный цикл запроса и пользовательский опыт

Документация

Частые вопросы

Подробнее о подключениях MCP, API Key, области инструментов, оплате и восстановлении длительных задач.

Создайте API Key, добавьте PoYo в клиент по документации MCP, затем проверьте аккаунт, Schema модели и открытые цены.

Создать API KeyДокументация MCP