LogoZenn.CEO/
Dashboardচ্যাটAPI KeysDocs
ডকুমেন্টেশন

API রেফারেন্স ও সেটআপ

একটি ck_ API কী Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, এবং সরাসরি HTTP-এ কাজ করে। একটি বিলে অফিসিয়াল প্রোভাইডার লিস্ট মূল্য — যত খরচ তত পেমেন্ট, কোনো সাবস্ক্রিপশন প্রয়োজন নেই।

সূচিপত্র
1. শুরু করা2. বেস URL3. Claude Code4. OpenCode5. Codex CLI6. Gemini CLI7. Cursor IDE8. সরাসরি API (cURL)9. ইমেজ জেনারেশন10. মডেল ও মূল্য11. প্রমাণীকরণ12. প্ল্যান13. রেট লিমিট ও ত্রুটি14. শীঘ্রই আসছে

1. শুরু করা

Zenn.Engineering হলো Anthropic, OpenAI, এবং Google AI মডেলের জন্য একটি ড্রপ-ইন API গেটওয়ে, সাথে ইমেজ জেনারেশন। আপনি সর্বত্র একটি ck_-প্রিফিক্সড কী ব্যবহার করেন — কোনো কোড পরিবর্তন নয়, শুধু আপনার টুলকে আমাদের বেস URL-এ পয়েন্ট করুন।

1. একটি API কী নিন

/pricing-এ একটি প্ল্যান বাছাই করুন, তারপর /manage-api-keys-এ একটি কী তৈরি করুন।

2. বেস URL সেট করুন

আপনার টুলকে https://zenn.engineering/api/v1-এ পয়েন্ট করুন।

3. বিল্ড করুন

Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor, এবং যেকোনো OpenAI/Anthropic-সামঞ্জস্যপূর্ণ ক্লায়েন্টের সাথে কাজ করে।

2. বেস URL

একটি কী, তিনটি প্রোটোকল-সামঞ্জস্যপূর্ণ বেস URL (Anthropic / OpenAI / Gemini), সাথে একটি ইমেজ-জেনারেশন এন্ডপয়েন্ট।

সারফেসবেস URLএর সাথে ব্যবহার করুন
Anthropic-সামঞ্জস্যপূর্ণhttps://zenn.engineering/api/v1Claude Code, Anthropic SDK, OpenCode (anthropic প্রোভাইডার)
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-সামঞ্জস্যপূর্ণ পেলোড)

3. Claude Code

Claude-এর জন্য Anthropic-এর অফিসিয়াল CLI। দুটি env vars সেট করুন এবং এটি একটি ড্রপ-ইন প্রতিস্থাপন হিসেবে কাজ করে।

ধাপ 1 — এনভায়রনমেন্ট সেট করুন

আপনার শেল প্রোফাইলে যোগ করুন (~/.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 x-api-key হেডারের মাধ্যমে API কী পাঠায় (Anthropic SDK নেটিভ) এবং বেস URL-এ /messages যোগ করে। anthropic-version এবং anthropic-beta উভয় হেডার আপস্ট্রিমে ফরওয়ার্ড করা হয়। SSE-এর মাধ্যমে স্ট্রিমিং সমর্থিত।

4. OpenCode

মাল্টি-প্রোভাইডার 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

GPT-5 / Codex পরিবারের জন্য OpenAI-এর অফিসিয়াল CLI। দুটি env vars সেট করুন এবং আমাদের Codex বেস 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

Google-এর Gemini CLI 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"-এ:

ফিল্ডমান
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 · 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 হিসেবে তালিকাভুক্ত।

এন্ডপয়েন্ট

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" বাছাই করুন, একটি প্রম্পট পাঠান, এবং ইমেজ ইনলাইন রেন্ডার হবে। সার্ভার আপনার জন্য আপস্ট্রিম পোল করে এবং প্রতি ইমেজে 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-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 স্ট্রিমিং সম্পূর্ণরূপে সমর্থিত।

12. প্ল্যান

একবারের টপ-আপ — কোনো সাবস্ক্রিপশন নেই। প্রতিটি টপ-আপ একটি ক্রেডিট গুণক লক করে (Pro 1×, Max 4×, Enterprise 6×) — আপনার ক্রেডিট ব্যয় না হওয়া পর্যন্ত সেই গুণক মান বজায় রাখে। পরবর্তী টপ-আপগুলি যেকোনো স্তরে হতে পারে।

Pro
$10 · 10,000,000 ক্রেডিট

স্ট্যান্ডার্ড মূল্য। যত খরচ তত পেমেন্ট।

  • · প্রতিটি ফ্রন্টিয়ার LLM অফিসিয়াল লিস্ট মূল্যে
  • · OpenAI / Anthropic / Gemini সামঞ্জস্যপূর্ণ API
  • · প্রতি-কী খরচের সীমা, রিয়েল-টাইম অ্যানালিটিক্স
Max
$100 · 400,000,000 ক্রেডিট

4× ক্রেডিট — $100 লিস্ট মূল্যে $400 ব্যবহার কেনে।

  • · Pro-এর সবকিছু
  • · টপ-আপের সময় প্রতি ডলারে 4× ক্রেডিট
  • · প্রতিটি মডেলে একই লিস্ট মূল্য
  • · অগ্রাধিকার সারি + দ্রুত রাউটিং
Enterprise
$1,000 · 6,000,000,000 ক্রেডিট

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/gemini1,000
/v1/images/generations500
/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 কী তৈরি করুন।

প্ল্যান দেখুনAPI কী পরিচালনা করুন
Logo
Zenn.CEOসবার জন্য ফ্রন্টিয়ার ইন্টেলিজেন্স
XX (Twitter)GitHubLinkedInEmail
Product
  • Chat
  • API
  • Pricing
কোম্পানি
  • About
  • যোগাযোগ
  • Cookie Policy
  • Privacy Policy
  • Terms of Service
  • Refund Policy
সব সিস্টেম স্বাভাবিক
•California থেকে ভালোবাসা সহকারে তৈরি ❤️
© Copyright 2026। সর্বস্বত্ব সংরক্ষিত।