API Reference и настройка
Один API-ключ ck_ работает в Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor и через прямой HTTP. Официальные цены прайс-листа провайдеров одним счётом — pay as you go, без подписки.
1. Начало работы
Zenn.Engineering — это drop-in API-шлюз для моделей Anthropic, OpenAI и Google AI, плюс генерация изображений. Используйте один ключ с префиксом ck_ везде — без изменений кода, просто направьте инструмент на наш base URL.
Выберите план на /pricing, затем создайте ключ на /manage-api-keys.
Направьте инструмент на https://zenn.engineering/api/v1.
Работает с Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor и любым OpenAI/Anthropic-совместимым клиентом.
2. Base URLs
Один ключ, три протокол-совместимых base URL (Anthropic / OpenAI / Gemini), плюс endpoint для генерации изображений.
| Surface | Base URL | Использовать с |
|---|---|---|
| Anthropic-совместимый | https://zenn.engineering/api/v1 | Claude Code, Anthropic SDK, OpenCode (anthropic provider) |
| OpenAI-совместимый (Codex) | https://zenn.engineering/api/v1/codex | Codex CLI, OpenAI SDK, Cursor |
| Gemini-совместимый | https://zenn.engineering/api/v1/gemini | Gemini CLI, Google AI SDK |
| Генерация изображений | https://zenn.engineering/api/v1/images/generations | gpt-image-2 (OpenAI-совместимый payload) |
3. Claude Code
Официальный CLI Anthropic для Claude. Установите две env-переменные — и работает как drop-in замена.
Шаг 1 — Настройте окружение
Добавьте в shell-профиль (~/.zshrc или ~/.bashrc):
export ANTHROPIC_BASE_URL=https://zenn.engineering/api/v1 export ANTHROPIC_API_KEY=ck_YOUR_API_KEY
Шаг 2 — Перезапустите и запустите
# Default model (Sonnet 4.6) claude # Pick a different model claude --model claude-opus-4-7 claude --model claude-haiku-4-5
Как это работает
Claude Code отправляет API-ключ через заголовок x-api-key (нативно для Anthropic SDK) и добавляет /messages к base URL. Заголовки anthropic-version и anthropic-beta пробрасываются upstream. Streaming поддерживается через SSE.
4. OpenCode
Multi-provider AI-агент для кодинга. Один JSON-конфиг даёт вам Claude, GPT-5 и Gemini через один ключ.
Шаг 1 — Установка
npm i -g opencode-ai
Шаг 2 — Создайте конфиг
Отредактируйте ~/.config/opencode/opencode.json:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://zenn.engineering/api/v1",
"apiKey": "ck_YOUR_API_KEY"
},
"models": {
"claude-opus-4-7": { "name": "Claude Opus 4.7" },
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
"claude-haiku-4-5": { "name": "Claude Haiku 4.5" }
}
},
"zenn-codex": {
"npm": "@ai-sdk/openai-compatible",
"name": "Zenn Codex",
"options": {
"baseURL": "https://zenn.engineering/api/v1/codex",
"apiKey": "ck_YOUR_API_KEY"
},
"models": {
"gpt-5.5": { "name": "GPT-5.5" },
"gpt-5.5-pro": { "name": "GPT-5.5 Pro" },
"gpt-5.5-instant": { "name": "GPT-5.5 Instant" },
"gpt-5.4": { "name": "GPT-5.4" },
"gpt-5.3-codex": { "name": "GPT-5.3 Codex" }
}
},
"zenn-gemini": {
"npm": "@ai-sdk/openai-compatible",
"name": "Zenn Gemini",
"options": {
"baseURL": "https://zenn.engineering/api/v1/gemini",
"apiKey": "ck_YOUR_API_KEY"
},
"models": {
"gemini-3.1-pro-preview": { "name": "Gemini 3.1 Pro" },
"gemini-3-pro-preview": { "name": "Gemini 3 Pro" },
"gemini-3-flash-preview": { "name": "Gemini 3 Flash" }
}
},
"zenn-chinese": {
"npm": "@ai-sdk/openai-compatible",
"name": "Zenn Chinese (DeepSeek / Moonshot / Zhipu)",
"options": {
"baseURL": "https://zenn.engineering/api/v1/codex",
"apiKey": "ck_YOUR_API_KEY"
},
"models": {
"deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
"deepseek-v4-flash": { "name": "DeepSeek V4 Flash" },
"kimi-k2.6": { "name": "Kimi K2.6" },
"glm-5.1": { "name": "GLM-5.1" }
}
}
}
}Шаг 3 — Запуск
opencode
5. Codex CLI
Официальный CLI OpenAI для семейства GPT-5 / Codex. Установите две env-переменные и направьте на наш Codex base URL.
Настройте окружение
export OPENAI_BASE_URL=https://zenn.engineering/api/v1/codex export OPENAI_API_KEY=ck_YOUR_API_KEY
Запуск
# Default codex # Pick a model codex --model gpt-5.5 codex --model gpt-5.5-pro codex --model gpt-5.5-instant codex --model gpt-5.3-codex # Chinese coding models (via OpenAI-compatible /v1/codex) codex --model deepseek-v4-pro codex --model kimi-k2.6 codex --model glm-5.1
Codex CLI использует Authorization: Bearer и формат OpenAI /chat/completions + /responses — оба поддерживаются.
6. Gemini CLI
Gemini CLI от Google отправляет ключ через x-goog-api-key. Прокси принимает этот заголовок прозрачно.
Настройте окружение
export GEMINI_BASE_URL=https://zenn.engineering/api/v1/gemini export GEMINI_API_KEY=ck_YOUR_API_KEY
Запуск
gemini --model gemini-3.1-pro-preview gemini --model gemini-3-flash-preview
7. Cursor IDE
В Cursor → Settings → Models → "Custom OpenAI Model":
| Поле | Значение |
|---|---|
| Override OpenAI Base URL | https://zenn.engineering/api/v1/codex |
| OpenAI API Key | ck_YOUR_API_KEY |
| Add custom models | gpt-5.5, gpt-5.5-pro, gpt-5.5-instant, gpt-5.4, gpt-5.3-codex, deepseek-v4-pro, kimi-k2.6, glm-5.1 |
Нажмите Verify после сохранения — Cursor обратится к /models на base URL, чтобы проверить ключ.
8. Прямой API (cURL)
Три протокольных формата, один ключ. Выберите тот, на котором уже говорит ваш клиент.
Anthropic-совместимый — /v1/messages
curl -X POST https://zenn.engineering/api/v1/messages \
-H "x-api-key: ck_YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude"}]
}'OpenAI-совместимый — /v1/codex/chat/completions
curl -X POST https://zenn.engineering/api/v1/codex/chat/completions \
-H "Authorization: Bearer ck_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [{"role": "user", "content": "Hello, GPT-5.5"}],
"stream": true
}'Gemini — /v1/gemini/chat/completions
curl -X POST https://zenn.engineering/api/v1/gemini/chat/completions \
-H "Authorization: Bearer ck_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-pro-preview",
"messages": [{"role": "user", "content": "Hello, Gemini"}]
}'9. Генерация изображений
gpt-image-2 — единственная модель генерации изображений, доступная сейчас через API. Уровни разрешения (1K / 2K / 4K) тарифицируются по единой цене — подробности см. в разделе Models. Другие модели изображений, видео и аудио помечены как Coming Soon.
Endpoint
POST https://zenn.engineering/api/v1/images/generations GET https://zenn.engineering/api/v1/images/generations (list models)
Сгенерировать изображение
curl -X POST https://zenn.engineering/api/v1/images/generations \
-H "Authorization: Bearer ck_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "A cinematic photo of a small red apple on a marble countertop",
"n": 1
}'Асинхронное поведение
DocsPage.imageGen.asyncBody
В браузерном чате
Откройте /chat, выберите "GPT Image 2 — Image Generation" в селекторе моделей, отправьте промпт — изображение появится прямо в чате. Сервер сам опрашивает upstream и тарифицирует 6 кредитов ($0.06) за изображение.
10. Модели и тарифы
Биллинг по кредитам (1 000 000 кредитов = $1.00). Цены LLM — официальный прайс провайдера за миллион токенов; изображения — за генерацию. Модели с пометкой Скоро перечислены, но API отклоняет их до активации. Каждая модель списывается по официальной цене — ценность даёт множитель кредитов при пополнении (Pro 1×, Max 4×, Enterprise 6×). См. раздел 12 для деталей тарифов.
Claude (Anthropic)
| Model ID | Вход / MTok | Выход / MTok | Чтение кэша | Статус |
|---|---|---|---|---|
| claude-opus-4-7 | $15.00 | $75.00 | $1.50 | В работе |
| claude-opus-4-6 | $15.00 | $75.00 | $1.50 | В работе |
| claude-sonnet-4-6 | $3.00 | $15.00 | $0.30 | В работе |
| claude-haiku-4-5 | $1.00 | $5.00 | $0.10 | В работе |
OpenAI / GPT
| Model ID | Вход / MTok | Выход / MTok | Чтение кэша | Статус |
|---|---|---|---|---|
| gpt-5.5 | $5.00 | $30.00 | $0.50 | В работе |
| gpt-5.5-instant | $5.00 | $30.00 | $0.50 | В работе |
| gpt-5.5-pro | $30.00 | $180.00 | $30.00 | В работе |
| gpt-5.4 | $5.00 | $22.50 | $0.50 | В работе |
| gpt-5.3-codex | $1.75 | $14.00 | $0.17 | В работе |
| gpt-5.2 | $1.75 | $14.00 | $0.17 | В работе |
Gemini (Google)
| Model ID | Вход / MTok | Выход / MTok | Чтение кэша | Статус |
|---|---|---|---|---|
| gemini-3.1-pro-preview | $4.00 | $18.00 | $0.40 | В работе |
| gemini-3-pro-preview | $4.00 | $18.00 | $0.40 | В работе |
| gemini-3-flash-preview | $0.50 | $3.00 | $0.05 | В работе |
DeepSeek / Moonshot / Zhipu
| Model ID | Вход / MTok | Выход / MTok | Чтение кэша | Статус |
|---|---|---|---|---|
| deepseek-v4-pro | $1.74 | $3.48 | $0.01 | В работе |
| deepseek-v4-flash | $0.14 | $0.28 | $0.0028 | В работе |
| kimi-k2.6 | $0.95 | $4.00 | $0.16 | В работе |
| glm-5.1 | $1.40 | $4.40 | $0.26 | В работе |
Изображения (в работе)
| Model ID | Кредитов / изображение | Цена / изображение | Статус |
|---|---|---|---|
| gpt-image-2 | 60000 | $0.06 | В работе |
Все модели изображений, видео и аудио тарифицируются по официальному прайсу. Другие модели изображений (семейство Nano Banana, Gemini 3 Pro Image, Seedream) присутствуют в каталоге, но пока Coming Soon — API отклоняет их до включения. См. /models для полного каталога.
11. Аутентификация
Все API-ключи используют префикс ck_. Прокси принимает любой стандартный SDK-формат заголовков, чтобы клиенты работали без модификаций.
| Заголовок | Формат | Используется |
|---|---|---|
| x-api-key | ck_... | Claude Code, Anthropic SDK |
| Authorization | Bearer ck_... | OpenCode, Codex CLI, OpenAI SDK, cURL |
| anthropic-api-key | ck_... | Альтернативный заголовок Anthropic |
| x-goog-api-key | ck_... | Gemini CLI |
Пробрасываемые заголовки
anthropic-version (по умолчанию 2023-06-01) и anthropic-beta пробрасываются. SSE streaming полностью поддерживается.
12. Тарифные планы
Разовое пополнение — без подписки. Каждое пополнение фиксирует множитель кредитов (Pro 1×, Max 4×, Enterprise 6×) — ваши кредиты сохраняют этот множитель до использования. Последующие пополнения могут быть на любом уровне.
Стандартные цены. Pay-as-you-go.
- · Все frontier LLM по официальному прайс-листу
- · API, совместимый с OpenAI / Anthropic / Gemini
- · Лимиты расходов на ключ, аналитика в реальном времени
4× кредитов — $100 = $400 использования по прайс-листу.
- · Всё из Pro
- · 4× кредитов за доллар при пополнении
- · Тот же прайс-лист на каждой модели
- · Приоритетная очередь + ускоренная маршрутизация
6× кредитов — $2 000 = $12 000 использования + приоритетный канал Anthropic Max.
- · Всё из Max
- · 6× кредитов за доллар при пополнении
- · Тот же прайс-лист на каждой модели
- · Приоритетный канал Anthropic Max
- · Выделенная поддержка, инвойсинг под аудит
Одно правило тарификации, все модели
- · Каждая LLM-, image-, video- и audio-модель тарифицируется по официальному прайс-листу, указанному на /models.
- · Ценность Max ($100 → 4×) и Enterprise ($2 000 → 6×) в дополнительных кредитах при пополнении, а не в скидочных уровнях по моделям.
- · Никаких bucket-фильтров и мелкого шрифта по моделям — ваши кредиты одинаково работают на Claude Opus, GPT-5.5 и Gemini Flash.
Множители применяются к каждому пополнению. Существующие Max-кредиты сохраняют 4× до их использования — пополните Pro потом, и эти $10 дадут 20M кредитов по 1×. См. /pricing для полной разбивки.
13. Rate Limits и ошибки
Rate limits на пользователя
| Endpoint | Запросов / час |
|---|---|
| /v1/messages, /v1/chat/completions, /v1/gemini | 1,000 |
| /v1/images/generations | 500 |
| /v1/responses, /v1/codex/* | 1,000 |
Статус rate-limit возвращается в response-заголовках: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset.
Коды ошибок
| Статус | Значение |
|---|---|
| 401 | Отсутствует / некорректный API-ключ |
| 402 | Недостаточно кредитов — пополните на /checkout |
| 403 | Уровень не открывает запрошенную модель (например, Opus 4.7) |
| 429 | Достигнут rate limit пользователя |
| 503 | Модель в каталоге, но Coming Soon |
| 504 | Таймаут генерации изображения (повторите) |
14. Скоро
Перечислены публично, но API отклоняет их до стабилизации маржи в модели множителя кредитов:
Семейство Nano Banana, Gemini 3 Pro Image, Seedream, GPT-4o Image, Imagen.
Veo 3.1, Kling 3.0, Seedance 2.0, HappyHorse 1.0, MiniMax Hailuo, Vidu Q3, WAN 2.6.
Fish Audio TTS, Voice Clone, ASR.
Полный список — на /models. Записи coming-soon возвращают HTTP 503 от API; их вызов сегодня — no-op без списания кредитов.
Готовы начать?
Один ключ работает в Claude Code, OpenCode, Codex CLI, Gemini CLI и Cursor. Пополните кредиты и создайте свой API-ключ.
