API रेफ़रेंस और सेटअप
एक ck_ API key Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, और प्रत्यक्ष HTTP पर काम करती है। एक ही बिल पर आधिकारिक provider लिस्ट मूल्य निर्धारण — pay as you go, कोई सब्सक्रिप्शन आवश्यक नहीं।
1. शुरुआत करना
Zenn.Engineering Anthropic, OpenAI, और Google AI मॉडलों के लिए एक ड्रॉप-इन API gateway है, साथ ही इमेज जनरेशन। आप हर जगह एक ही ck_-उपसर्ग वाली key का उपयोग करते हैं — कोई कोड परिवर्तन नहीं, बस अपने टूल को हमारे baseURL पर पॉइंट करें।
/pricing पर एक प्लान चुनें, फिर /manage-api-keys पर एक key बनाएं।
अपने टूल को https://zenn.engineering/api/v1 पर पॉइंट करें।
Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, और किसी भी OpenAI/Anthropic-संगत क्लाइंट के साथ काम करता है।
2. baseURL
एक key, तीन प्रोटोकॉल-संगत baseURL (Anthropic / OpenAI / Gemini), साथ ही एक इमेज-जनरेशन endpoint।
| सरफ़ेस | baseURL | इसके साथ उपयोग करें |
|---|---|---|
| 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
Claude के लिए Anthropic का आधिकारिक CLI। दो env vars सेट करें और यह ड्रॉप-इन प्रतिस्थापन के रूप में काम करता है।
Step 1 — एनवायरनमेंट सेट करें
अपनी shell profile में जोड़ें (~/.zshrc या ~/.bashrc):
export ANTHROPIC_BASE_URL=https://zenn.engineering/api/v1 export ANTHROPIC_API_KEY=ck_YOUR_API_KEY
Step 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 header (Anthropic SDK native) के माध्यम से API key भेजता है और baseURL में /messages जोड़ता है। दोनों anthropic-version और anthropic-beta headers अपस्ट्रीम फ़ॉरवर्ड किए जाते हैं। SSE के माध्यम से streaming समर्थित है।
4. OpenCode
मल्टी-provider AI कोडिंग एजेंट। एक JSON config आपको एक key के माध्यम से Claude, GPT-5, और Gemini देता है।
Step 1 — इंस्टॉल करें
npm i -g opencode-ai
Step 2 — config बनाएं
~/.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" }
}
}
}
}Step 3 — रन करें
opencode
5. Codex CLI
GPT-5 / Codex परिवार के लिए OpenAI का आधिकारिक CLI। दो env vars सेट करें और हमारे Codex baseURL पर पॉइंट करें।
एनवायरनमेंट सेट करें
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 shape का उपयोग करता है — दोनों समर्थित हैं।
6. Gemini CLI
Google का Gemini CLI x-goog-api-key के माध्यम से key भेजता है। प्रॉक्सी उस header को पारदर्शी रूप से स्वीकार करता है।
एनवायरनमेंट सेट करें
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" में:
| फ़ील्ड | मान |
|---|---|
| OpenAI baseURL ओवरराइड करें | https://zenn.engineering/api/v1/codex |
| OpenAI API Key | ck_YOUR_API_KEY |
| कस्टम मॉडल जोड़ें | 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 यह पुष्टि करने के लिए baseURL पर /models को हिट करेगा कि key काम करती है।
8. प्रत्यक्ष API (cURL)
तीन प्रोटोकॉल shapes, एक key। जो भी आपका क्लाइंट पहले से बोलता है उसे चुनें।
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 के माध्यम से रूट करने योग्य एकमात्र इमेज मॉडल है। Resolution tiers (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
}'Async व्यवहार
DocsPage.imageGen.asyncBody
ब्राउज़र चैट में
/chat खोलें, model picker से "GPT Image 2 — Image Generation" चुनें, एक प्रॉम्प्ट भेजें, और इमेज इनलाइन रेंडर हो जाती है। सर्वर आपके लिए अपस्ट्रीम पोल करता है और प्रति इमेज 6 क्रेडिट ($0.06) बिल करता है।
10. मॉडल और मूल्य निर्धारण
क्रेडिट-आधारित बिलिंग (1,000,000 क्रेडिट = $1.00)। LLM कीमतें प्रति मिलियन टोकन प्रदाता की आधिकारिक सूची मूल्य हैं; छवि प्रति जनरेशन। जल्द आ रहा है टैग किए गए मॉडल सूचीबद्ध हैं लेकिन सक्षम होने तक 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 keys ck_ उपसर्ग का उपयोग करती हैं। प्रॉक्सी हर मानक SDK header फ़ॉर्मेट को स्वीकार करता है ताकि क्लाइंट बिना संशोधन के काम करें।
| Header | फ़ॉर्मेट | द्वारा उपयोग |
|---|---|---|
| x-api-key | ck_... | Claude Code, Anthropic SDK |
| Authorization | Bearer ck_... | OpenCode, Codex CLI, OpenAI SDK, cURL |
| anthropic-api-key | ck_... | वैकल्पिक Anthropic header |
| x-goog-api-key | ck_... | Gemini CLI |
फ़ॉरवर्ड किए गए headers
anthropic-version (डिफ़ॉल्ट 2023-06-01) और anthropic-beta पास-थ्रू होते हैं। SSE streaming पूरी तरह से समर्थित है।
12. योजनाएं
एक बार का टॉप-अप — कोई सदस्यता नहीं। प्रत्येक टॉप-अप एक क्रेडिट गुणक लॉक करता है (Pro 1×, Max 4×, Enterprise 6×) — आपके क्रेडिट खर्च होने तक उस गुणक मूल्य को बनाए रखते हैं। अगले टॉप-अप किसी भी स्तर पर हो सकते हैं।
मानक मूल्य निर्धारण। Pay-as-you-go।
- · आधिकारिक लिस्ट कीमत पर हर फ्रंटियर LLM
- · OpenAI / Anthropic / Gemini संगत API
- · प्रति-key व्यय सीमाएं, रीयल-टाइम एनालिटिक्स
4× क्रेडिट — $100 लिस्ट कीमत पर $400 का उपयोग खरीदता है।
- · Pro में सब कुछ
- · टॉप-अप समय पर प्रति डॉलर 4× क्रेडिट
- · हर मॉडल पर वही लिस्ट कीमत
- · प्राथमिकता कतार + तेज़ रूटिंग
6× क्रेडिट — $1,000 $6,000 का उपयोग खरीदता है + प्राथमिकता Anthropic Max चैनल।
- · Max में सब कुछ
- · टॉप-अप समय पर प्रति डॉलर 6× क्रेडिट
- · हर मॉडल पर वही लिस्ट कीमत
- · प्राथमिकता Anthropic Max चैनल
- · समर्पित समर्थन, ऑडिट-अनुकूल इनवॉइसिंग
एक मूल्य निर्धारण नियम, हर मॉडल
- · हर LLM, इमेज, वीडियो, और ऑडियो मॉडल /models पर दिखाई गई आधिकारिक लिस्ट कीमत पर बर्न होता है।
- · Max ($100 → 4×) और Enterprise ($1,000 → 6×) मूल्य टॉप-अप समय पर दिए गए अतिरिक्त क्रेडिट से आता है, प्रति-मॉडल छूट tiers से नहीं।
- · कोई bucket पात्रता नहीं, कोई प्रति-मॉडल बारीक प्रिंट नहीं — आपके क्रेडिट Claude Opus, GPT-5.5, और Gemini Flash पर समान रूप से काम करते हैं।
मल्टीप्लायर प्रति टॉप-अप लागू होते हैं। मौजूदा Max क्रेडिट अपने 4× मूल्य को तब तक रखते हैं जब तक आप उन्हें खर्च नहीं करते — बाद में Pro टॉप अप करें और वह $10 1× पर 20M क्रेडिट देता है। पूर्ण विभाजन के लिए /pricing देखें।
13. रेट लिमिट और त्रुटियां
प्रति-उपयोगकर्ता रेट लिमिट
| Endpoint | अनुरोध / घंटा |
|---|---|
| /v1/messages, /v1/chat/completions, /v1/gemini | 1,000 |
| /v1/images/generations | 500 |
| /v1/responses, /v1/codex/* | 1,000 |
रेट-लिमिट स्थिति प्रतिक्रिया headers में वापस की जाती है: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset।
त्रुटि कोड
| स्थिति | अर्थ |
|---|---|
| 401 | गुम / अमान्य API key |
| 402 | अपर्याप्त क्रेडिट — /checkout पर टॉप अप करें |
| 403 | Tier अनुरोधित मॉडल को अनलॉक नहीं करता (जैसे 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 लौटाती हैं; आज उन्हें कॉल करना एक no-op है जो क्रेडिट बिल नहीं करता।
शुरू करने के लिए तैयार हैं?
एक key Claude Code, OpenCode, Codex CLI, Gemini CLI, और Cursor पर काम करती है। क्रेडिट टॉप अप करें और अपनी API key बनाएं।
