LogoZenn.CEO/
Панель управленияЧатAPI-ключиДокументация
Документация

API Reference и настройка

Один API-ключ ck_ работает в Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor и через прямой HTTP. Официальные цены прайс-листа провайдеров одним счётом — pay as you go, без подписки.

Содержание
1. Начало работы2. Base URLs3. Claude Code4. OpenCode5. Codex CLI6. Gemini CLI7. Cursor IDE8. Прямой API (cURL)9. Генерация изображений10. Модели и тарифы11. Аутентификация12. Тарифные планы13. Rate Limits и ошибки14. Скоро

1. Начало работы

Zenn.Engineering — это drop-in API-шлюз для моделей Anthropic, OpenAI и Google AI, плюс генерация изображений. Используйте один ключ с префиксом ck_ везде — без изменений кода, просто направьте инструмент на наш base URL.

1. Получите API-ключ

Выберите план на /pricing, затем создайте ключ на /manage-api-keys.

2. Установите Base URL

Направьте инструмент на https://zenn.engineering/api/v1.

3. Создавайте

Работает с Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor и любым OpenAI/Anthropic-совместимым клиентом.

2. Base URLs

Один ключ, три протокол-совместимых base URL (Anthropic / OpenAI / Gemini), плюс endpoint для генерации изображений.

SurfaceBase URLИспользовать с
Anthropic-совместимыйhttps://zenn.engineering/api/v1Claude Code, Anthropic SDK, OpenCode (anthropic provider)
OpenAI-совместимый (Codex)https://zenn.engineering/api/v1/codexCodex CLI, OpenAI SDK, Cursor
Gemini-совместимыйhttps://zenn.engineering/api/v1/geminiGemini CLI, Google AI SDK
Генерация изображенийhttps://zenn.engineering/api/v1/images/generationsgpt-image-2 (OpenAI-совместимый payload)

3. Claude Code

Официальный CLI Anthropic для Claude. Установите две env-переменные — и работает как drop-in замена.

Шаг 1 — Настройте окружение

Добавьте в shell-профиль (~/.zshrc или ~/.bashrc):

shell
export ANTHROPIC_BASE_URL=https://zenn.engineering/api/v1
export ANTHROPIC_API_KEY=ck_YOUR_API_KEY

Шаг 2 — Перезапустите и запустите

terminal
# 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 — Установка

terminal
npm i -g opencode-ai

Шаг 2 — Создайте конфиг

Отредактируйте ~/.config/opencode/opencode.json:

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 — Запуск

terminal
opencode

5. Codex CLI

Официальный CLI OpenAI для семейства GPT-5 / Codex. Установите две env-переменные и направьте на наш Codex base URL.

Настройте окружение

shell
export OPENAI_BASE_URL=https://zenn.engineering/api/v1/codex
export OPENAI_API_KEY=ck_YOUR_API_KEY

Запуск

terminal
# 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. Прокси принимает этот заголовок прозрачно.

Настройте окружение

shell
export GEMINI_BASE_URL=https://zenn.engineering/api/v1/gemini
export GEMINI_API_KEY=ck_YOUR_API_KEY

Запуск

terminal
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 URLhttps://zenn.engineering/api/v1/codex
OpenAI API Keyck_YOUR_API_KEY
Add custom modelsgpt-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 · Claude
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 · GPT-5.5
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 · Gemini
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 · gpt-image-2
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-260000$0.06В работе

Все модели изображений, видео и аудио тарифицируются по официальному прайсу. Другие модели изображений (семейство Nano Banana, Gemini 3 Pro Image, Seedream) присутствуют в каталоге, но пока Coming Soon — API отклоняет их до включения. См. /models для полного каталога.

11. Аутентификация

Все API-ключи используют префикс ck_. Прокси принимает любой стандартный SDK-формат заголовков, чтобы клиенты работали без модификаций.

ЗаголовокФорматИспользуется
x-api-keyck_...Claude Code, Anthropic SDK
AuthorizationBearer ck_...OpenCode, Codex CLI, OpenAI SDK, cURL
anthropic-api-keyck_...Альтернативный заголовок Anthropic
x-goog-api-keyck_...Gemini CLI

Пробрасываемые заголовки

anthropic-version (по умолчанию 2023-06-01) и anthropic-beta пробрасываются. SSE streaming полностью поддерживается.

12. Тарифные планы

Разовое пополнение — без подписки. Каждое пополнение фиксирует множитель кредитов (Pro 1×, Max 4×, Enterprise 6×) — ваши кредиты сохраняют этот множитель до использования. Последующие пополнения могут быть на любом уровне.

Pro
$10 · 20 000 000 кредитов

Стандартные цены. Pay-as-you-go.

  • · Все frontier LLM по официальному прайс-листу
  • · API, совместимый с OpenAI / Anthropic / Gemini
  • · Лимиты расходов на ключ, аналитика в реальном времени
Max
$100 · 800 000 000 кредитов

4× кредитов — $100 = $400 использования по прайс-листу.

  • · Всё из Pro
  • · 4× кредитов за доллар при пополнении
  • · Тот же прайс-лист на каждой модели
  • · Приоритетная очередь + ускоренная маршрутизация
Enterprise
$2 000 · 12 000 000 000 кредитов

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/gemini1,000
/v1/images/generations500
/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-ключ.

Посмотреть планыУправление API-ключами
Logo
Zenn.CEOПередовой интеллект — для каждого
XX (Twitter)GitHubLinkedInEmail
Product
  • Chat
  • API
  • Pricing
Компания
  • About
  • Контакты
  • Политика cookie
  • Политика конфиденциальности
  • Условия использования
  • Политика возврата
Все системы работают штатно
•Сделано в Калифорнии с любовью ❤️
© 2026. Все права защищены.