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
একটি কী, তিনটি প্রোটোকল-সামঞ্জস্যপূর্ণ বেস 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
Claude-এর জন্য Anthropic-এর অফিসিয়াল CLI। দুটি env vars সেট করুন এবং এটি একটি ড্রপ-ইন প্রতিস্থাপন হিসেবে কাজ করে।
ধাপ 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 হেডারের মাধ্যমে API কী পাঠায় (Anthropic SDK নেটিভ) এবং বেস 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
GPT-5 / Codex পরিবারের জন্য OpenAI-এর অফিসিয়াল CLI। দুটি env vars সেট করুন এবং আমাদের 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"-এ:
| ফিল্ড | মান |
|---|---|
| OpenAI বেস URL ওভাররাইড করুন | https://zenn.engineering/api/v1/codex |
| OpenAI API কী | 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 বেস URL-এ /models হিট করে নিশ্চিত করবে কী কাজ করছে কিনা।
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 হিসেবে তালিকাভুক্ত।
এন্ডপয়েন্ট
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" বাছাই করুন, একটি প্রম্পট পাঠান, এবং ইমেজ ইনলাইন রেন্ডার হবে। সার্ভার আপনার জন্য আপস্ট্রিম পোল করে এবং প্রতি ইমেজে 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 কী 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-এর সবকিছু
- · টপ-আপের সময় প্রতি ডলারে 4× ক্রেডিট
- · প্রতিটি মডেলে একই লিস্ট মূল্য
- · অগ্রাধিকার সারি + দ্রুত রাউটিং
6× ক্রেডিট — $1,000 $6,000 ব্যবহার কেনে + অগ্রাধিকার Anthropic Max চ্যানেল।
- · Max-এর সবকিছু
- · টপ-আপের সময় প্রতি ডলারে 6× ক্রেডিট
- · প্রতিটি মডেলে একই লিস্ট মূল্য
- · অগ্রাধিকার Anthropic Max চ্যানেল
- · ডেডিকেটেড সাপোর্ট, অডিট-বান্ধব ইনভয়েসিং
একটি মূল্য নিয়ম, প্রতিটি মডেল
- · প্রতিটি LLM, ইমেজ, ভিডিও, এবং অডিও মডেল /models-এ দেখানো অফিসিয়াল লিস্ট মূল্যে বার্ন হয়।
- · Max ($100 → 4×) এবং Enterprise ($1,000 → 6×) মূল্য টপ-আপের সময় দেওয়া অতিরিক্ত ক্রেডিট থেকে আসে, প্রতি-মডেল ছাড় টিয়ার থেকে নয়।
- · কোনো বাকেট যোগ্যতা নেই, প্রতি-মডেল ফাইন প্রিন্ট নেই — Claude Opus, GPT-5.5, এবং Gemini Flash-এ আপনার ক্রেডিট একইভাবে কাজ করে।
মাল্টিপ্লায়ার প্রতি টপ-আপে প্রযোজ্য। বিদ্যমান Max ক্রেডিট খরচ না হওয়া পর্যন্ত তাদের 4× মূল্য রাখে — পরে Pro টপ-আপ করলে সেই $10 1×-এ 20M ক্রেডিট দেয়। সম্পূর্ণ বিভাজনের জন্য /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 দেখুন। কামিং-সুন এন্ট্রি API থেকে HTTP 503 ফেরত দেয়; আজ এগুলো কল করা একটি নো-অপ যা ক্রেডিট বিল করে না।
শুরু করতে প্রস্তুত?
একটি কী Claude Code, OpenCode, Codex CLI, Gemini CLI, এবং Cursor-এ কাজ করে। ক্রেডিট টপ আপ করুন এবং আপনার API কী তৈরি করুন।
