На главную
Введение
YoYoGPT: единая инфраструктура доступа к десяткам AI-моделей. Один API-ключ, один баланс, один endpoint: платформа сама управляет поставщиками, маршрутизацией запросов и тарификацией.
API совместим с OpenAI SDK: достаточно заменить baseURL и apiKey в вашем клиенте. Весь трафик проходит через наш шлюз, поэтому вы получаете доступ к моделям OpenAI, Anthropic, Google, DeepSeek, Mistral и других лабораторий без отдельных договоров.
Базовый URL
POST https://yoyogpt.com/v1/chat/completions
GET https://yoyogpt.com/v1/models
Баланс, ключи и история — в консоли: https://yoyogpt.com/console
Совместимость. Запросы и ответы повторяют формат OpenAI Chat Completions, поэтому существующий код на Python, Node.js или curl продолжит работать после смены хоста.
Быстрый старт
Три шага до первого запроса: создайте аккаунт, получите API-ключ в консоли и отправьте запрос. При регистрации на баланс начисляется стартовый $1, а дальнейшее пополнение выполняется одноразовыми кодами.
1. Получите API-ключ
Зарегистрируйтесь и создайте ключ в разделе «API-ключи» консоли. Ключ показывается один раз и хранится только на вашей стороне.
2. Отправьте первый запрос
curl https://yoyogpt.com/v1/chat/completions \
-H "Authorization: Bearer sk-yoyogpt-..." \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Привет!"}]}'
3. Или используйте SDK
import OpenAI from 'openai'
const client = new OpenAI({
baseURL: 'https://yoyogpt.com/v1',
apiKey: process.env.YOYOGPT_API_KEY,
})
const reply = await client.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: 'Привет!' }],
})
Лимиты. По умолчанию действуют мягкие лимиты на количество запросов в минуту. Увеличить их или установить жёсткий бюджет можно в консоли.
Аутентификация
Ключ передаётся в заголовке Authorization в формате Bearer-токена. Все запросы к любому endpoint требуют этот заголовок.
Authorization: Bearer sk-yoyogpt-<ваш_api_ключ>
Ключи создаются в консоли с правами на чтение моделей, запись запросов или управление балансом. Отозвать ключ можно в любой момент: он перестанет работать немедленно.
Безопасность. Храните ключ на сервере, не передавайте его в клиентских приложениях и не включайте в публичные репозитории. Для веб-проектов используйте прокси-слой или серверные функции.
Подключение CLI-инструментов
Для любого OpenAI-совместимого CLI нужны три значения: Base URL https://yoyogpt.com/v1, API-ключ из консоли и ID модели из GET /v1/models.
OpenCode
Самый быстрый способ: в консоли откройте «API-ключи», нажмите Use, выберите OpenCode и скачайте готовый opencode.jsonc. Генератор добавит все доступные модели, их контекст и поддержку reasoning.
Для ручной настройки сохраните файл в корне проекта как opencode.jsonc. Глобальный путь в Windows: %USERPROFILE%\.config\opencode\opencode.jsonc (например, C:\Users\User\.config\opencode\opencode.jsonc); в macOS/Linux: ~/.config/opencode/opencode.jsonc.
{
"provider": {
"yoyogpt": {
"npm": "@ai-sdk/openai-compatible",
"name": "YoYoGPT",
"options": { "baseURL": "https://yoyogpt.com/v1", "apiKey": "{env:YOYOGPT_API_KEY}" },
"models": { "gpt-5.6-sol": { "name": "GPT-5.6 Sol", "reasoning": true, "provider": { "npm": "@ai-sdk/openai" }, "options": { "store": false }, "variants": { "low": { "reasoningEffort": "low", "reasoningSummary": "auto" }, "high": { "reasoningEffort": "high", "reasoningSummary": "auto" } } } }
}
},
"agent": { "build": { "options": { "store": false } }, "plan": { "options": { "store": false } } },
"$schema": "https://opencode.ai/config.json"
}
# macOS / Linux
export YOYOGPT_API_KEY="sk-yoyogpt-..."
opencode
# PowerShell
$env:YOYOGPT_API_KEY="sk-yoyogpt-..."; opencode
В OpenCode выполните /models и выберите yoyogpt/<model-id>. Для разового запуска можно передать --model yoyogpt/gpt-5.6-sol.
Другой OpenAI-совместимый CLI
export OPENAI_BASE_URL="https://yoyogpt.com/v1"
export OPENAI_API_KEY="sk-yoyogpt-..."
# В настройках CLI укажите model: gpt-5.6-sol
Проверка. Если список моделей пуст, выполните запрос curl https://yoyogpt.com/v1/models -H "Authorization: Bearer $YOYOGPT_API_KEY" и проверьте точное имя модели.
Подключение Desktop-клиентов
YoYoGPT Desktop
Установите приложение и войдите с теми же email и паролем, что используются в веб-консоли. Клиент создаст персональный API-ключ, подключит провайдера YoYoGPT и синхронизирует каталог моделей автоматически. Дополнительный Base URL вводить не требуется.
OpenCode Desktop
Используйте тот же opencode.jsonc, что и для CLI. Нажмите Use рядом с ключом и сохраните файл в %USERPROFILE%\.config\opencode\opencode.jsonc на Windows или ~/.config/opencode/opencode.jsonc на macOS/Linux. После перезапуска откройте выбор моделей и выберите провайдера YoYoGPT.
Chatbox, Cherry Studio и другие клиенты
Создайте пользовательского провайдера типа «OpenAI API» или «OpenAI Compatible» и заполните:
| Поле | Значение |
|---|
| Provider type | OpenAI Compatible |
| Base URL / API Host | https://yoyogpt.com/v1 |
| API Key | sk-yoyogpt-... |
| Models endpoint | GET /v1/models |
| Default model | gpt-5.6-sol или любая модель из каталога |
Если клиент не загружает модели сам, добавьте ID вручную точно в том виде, в котором он возвращается API. Включите streaming и tool/function calling, если эти переключатели есть в настройках клиента.
Единый endpoint. Chat Completions, Responses, embeddings, audio и images доступны под тем же префиксом /v1; конкретный набор операций зависит от выбранной модели.
Роутинг и fallback
Запрос принимает шлюз, который выбирает поставщика по идентификатору модели, списывает средства с единого баланса и возвращает ответ в едином формате. При недоступности основного поставщика активируется fallback-цепочка.
Автоматический fallback
{
"model": "gpt-4o",
"fallback": ["claude-sonnet-4-5", "gemini-2-5-flash"],
"max_retries": 3
}
Поле fallback задаёт список моделей, которые шлюз попробует по порядку при ошибке, таймауте или исчерпании лимита. Если все кандидаты недоступны, возвращается последняя ошибка поставщика.
Тарификация. Списывается только стоимость фактически выполненного запроса. Ответ содержит поля model и provider, по которым видно, какая модель отработала.
Модели
Актуальный каталог моделей доступен через GET /v1/models и на главной странице: список синхронизируется с models.dev. Флагманские модели на момент запуска:
$ curl https://yoyogpt.com/v1/models \
-H "Authorization: Bearer sk-yoyogpt-..."
| Модель | Провайдер | Категория |
|---|
| gpt-4o | OpenAI | Текст |
| claude-sonnet-4-5 | Anthropic | Текст |
| gemini-2-5-flash | Google | Текст |
| deepseek-chat | DeepSeek | Текст |
| grok-4 | xAI | Текст |
| dall-e-3 | OpenAI | Изображения |
Каталог растёт. Модели добавляются по мере выхода релизов: подпишитесь на список изменений, чтобы получать уведомления о новых моделях и поставщиках.