APIリファレンスとセットアップ
ひとつのck_ APIキーが、Claude Code、OpenCode、Codex CLI、Gemini CLI、Cursor、そして直接のHTTP呼び出しすべてで使えます。公式プロバイダーのリスト価格を単一の請求書で — 従量課金、サブスクリプション不要。
1. はじめに
Zenn.Engineeringは、Anthropic、OpenAI、Google AIモデル、そして画像生成のためのドロップイン対応APIゲートウェイです。すべてのツールでck_プレフィックス付きの単一キーを使えます — コードを変更せず、ベースURLを向けるだけ。
/pricingでプランを選び、/manage-api-keysでキーを作成してください。
ツールをhttps://zenn.engineering/api/v1に向けます。
Claude Code、OpenCode、Codex CLI、Gemini CLI、Cursor、そしてOpenAI/Anthropic互換クライアント全般で利用可能です。
2. ベースURL
ひとつのキーで、3つのプロトコル互換ベースURL（Anthropic / OpenAI / Gemini）と画像生成エンドポイントを利用できます。
| サーフェス | ベースURL | 対応ツール |
|---|---|---|
| Anthropic互換 | https://zenn.engineering/api/v1 | Claude Code, Anthropic SDK, OpenCode（anthropicプロバイダー） |
| 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互換ペイロード） |
3. Claude Code
Anthropic公式のClaude用CLI。env varを2つ設定するだけでドロップイン代替として動作します。
ステップ1 — 環境変数を設定
シェルプロファイル（~/.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はx-api-keyヘッダー（Anthropic SDKネイティブ）でAPIキーを送信し、ベースURLに/messagesを付加します。anthropic-versionとanthropic-betaのヘッダーは上流に転送されます。SSEによるストリーミングにも対応。
4. OpenCode
マルチプロバイダー対応の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
OpenAI公式のGPT-5 / Codexファミリー向けCLI。env varを2つ設定し、Codexのベース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
GoogleのGemini CLIは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がベース URLの/modelsにアクセスし、キーが有効か確認します。
8. ダイレクトAPI（cURL）
3つのプロトコル形式、ひとつのキー。クライアントが既に対応している形式を選んでください。
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. 画像生成
現在API経由でルーティング可能な画像モデルはgpt-image-2のみです。解像度ティア（1K / 2K / 4K）はすべて同一の定額料金で課金されます — 詳細はモデルセクションを参照してください。その他の画像・動画・音声モデルはComing Soonとして掲載されています。
エンドポイント
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」を選択してプロンプトを送信すると、画像がインラインで表示されます。サーバーが上流のポーリングを行い、画像1枚あたり6クレジット（$0.06）が課金されます。
10. モデルと料金
クレジット課金（1,000,000 クレジット = $1.00）。LLM 料金は各プロバイダ公式の 100 万トークン単価、画像は 1 枚単価。近日公開 タグ付きモデルは掲載されていますが、有効化されるまで API は拒否します。すべてのモデルは公式定価で消費します — 価値はトップアップ時のクレジット倍率（Pro 1×、Max 4×、Enterprise 6×）から得られます。プランの詳細はセクション 12 をご覧ください。
Claude (Anthropic)
| モデル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
| モデル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)
| モデル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
| モデル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 | 稼働中 |
画像（稼働中）
| モデル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ストリーミングに完全対応しています。
12. プラン
一回限りのトップアップ — サブスクリプション不要。各トップアップでクレジット倍率（Pro 1×、Max 4×、Enterprise 6×）が固定され、そのクレジットを使い切るまで倍率価値が維持されます。次回のトップアップはどのプランも選べます。
標準価格。従量課金。
- · すべての最先端LLMを公式リスト価格で
- · OpenAI / Anthropic / Gemini互換のAPI
- · キー単位の支出上限、リアルタイム分析
4倍のクレジット — $100でリスト価格換算$400相当の利用。
- · Proのすべての機能
- · チャージ時に1ドルあたり4倍のクレジット
- · すべてのモデルが同じリスト価格
- · 優先キュー + 高速ルーティング
6倍のクレジット — $1,000でリスト価格換算$6,000相当の利用+ Anthropic Max優先チャネル。
- · Maxのすべての機能
- · チャージ時に1ドルあたり6倍のクレジット
- · すべてのモデルが同じリスト価格
- · Anthropic Max優先チャネル
- · 専任サポート、監査対応の請求書
すべてのモデルに適用される、ひとつの料金ルール
- · すべてのLLM・画像・動画・音声モデルは/modelsに表示される公式リスト価格で消費されます。
- · Max（$100 → 4倍）とEnterprise（$1,000 → 6倍）の価値は、チャージ時に付与される追加クレジットによるもので、モデル別の割引ティアによるものではありません。
- · バケット適格性もモデル別の細則もありません — クレジットはClaude Opus、GPT-5.5、Gemini Flashすべてで同じように使えます。
倍率はチャージごとに適用されます。既存のMaxクレジットは消費するまで4倍の価値を保ちます — その後Proでチャージすれば、$10で20Mクレジットが1倍で付与されます。詳細は/pricingを参照してください。
13. レート制限とエラー
ユーザー単位のレート制限
| エンドポイント | リクエスト数 / 時間 |
|---|---|
| /v1/messages, /v1/chat/completions, /v1/gemini | 1,000 |
| /v1/images/generations | 500 |
| /v1/responses, /v1/codex/* | 1,000 |
レート制限のステータスはレスポンスヘッダーで返されます: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset。
エラーコード
| ステータス | 意味 |
|---|---|
| 401 | APIキーが欠落または無効 |
| 402 | クレジット不足 — /checkoutでチャージしてください |
| 403 | ティアが要求されたモデルを解放していません（例: Opus 4.7） |
| 429 | ユーザー単位のレート制限に到達 |
| 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のエントリーはAPIからHTTP 503を返します。今呼び出しても何も起こらず、クレジットも消費されません。