مرجع API والإعداد
مفتاح API واحد بصيغة ck_ يعمل عبر Claude Code وOpenCode وCodex CLI وGemini CLI وCursor وHTTP المباشر. أسعار قائمة المزوّد الرسمية على فاتورة واحدة — ادفع حسب الاستخدام، بدون اشتراك.
1. البدء
Zenn.Engineering هو بوابة API بديلة جاهزة لنماذج Anthropic وOpenAI وGoogle AI، بالإضافة إلى توليد الصور. تستخدم مفتاحًا واحدًا بصيغة ck_ في كل مكان — بدون أي تعديل في الكود، فقط وجِّه أداتك إلى baseURL لدينا.
اختر خطة من /pricing، ثم أنشئ مفتاحًا في /manage-api-keys.
وجِّه أداتك إلى https://zenn.engineering/api/v1.
يعمل مع Claude Code وOpenCode وCodex CLI وGemini CLI وCursor وأي عميل متوافق مع OpenAI/Anthropic.
2. عناوين baseURL
مفتاح واحد، وثلاثة عناوين baseURL متوافقة مع البروتوكولات (Anthropic / OpenAI / Gemini)، بالإضافة إلى نقطة نهاية لتوليد الصور.
| الواجهة | baseURL | الاستخدام مع |
|---|---|---|
| متوافق مع 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
الـ CLI الرسمي من Anthropic لـ Claude. اضبط متغيرَي بيئة فقط ليعمل كبديل جاهز.
الخطوة 1 — اضبط البيئة
أضف إلى ملف الـ shell الخاص بك (~/.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 مفتاح API عبر ترويسة x-api-key (الأصلية في Anthropic SDK) ويُلحق /messages بـ baseURL. تُمرَّر ترويستا anthropic-version وanthropic-beta إلى المصدر. البث المباشر مدعوم عبر SSE.
4. OpenCode
وكيل برمجي متعدد المزوّدين. ملف 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
الـ CLI الرسمي من OpenAI لعائلة GPT-5 / Codex. اضبط متغيرَي بيئة ووجِّه إلى baseURL الخاص بـ Codex لدينا.
اضبط البيئة
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
يُرسل Gemini CLI من Google المفتاح عبر 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 /models على الـ baseURL للتأكد من أن المفتاح يعمل.
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) بسعر ثابت موحَّد — راجع قسم النماذج للتفاصيل. نماذج الصور والفيديو والصوت الأخرى مدرَجة بوسم "قريبًا".
نقطة النهاية
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)
| معرّف النموذج | الإدخال / 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
| معرّف النموذج | الإدخال / 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)
| معرّف النموذج | الإدخال / 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
| معرّف النموذج | الإدخال / 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 | متاح |
صورة (متاح)
| معرّف النموذج | أرصدة / صورة | السعر / صورة | الحالة |
|---|---|---|---|
| gpt-image-2 | 60000 | $0.06 | متاح |
تُحتسب جميع نماذج الصور والفيديو والصوت بسعر القائمة الرسمي. نماذج الصور الأخرى (عائلة Nano Banana وGemini 3 Pro Image وSeedream) مدرَجة في الكتالوج لكنها حاليًا قيد "قريبًا" — يرفضها 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 رائد بسعر القائمة الرسمي
- · API متوافق مع OpenAI / Anthropic / Gemini
- · حدود إنفاق لكل مفتاح، وتحليلات لحظية
4× أرصدة — 200$ تشتري 800$ من الاستخدام بسعر القائمة.
- · كل ميزات Pro
- · 4× أرصدة لكل دولار وقت الشحن
- · نفس سعر القائمة على كل النماذج
- · طابور أولوية + توجيه أسرع
6× أرصدة — 2,000$ تشتري 12,000$ من الاستخدام + قناة أولوية إلى Anthropic Max.
- · كل ميزات Max
- · 6× أرصدة لكل دولار وقت الشحن
- · نفس سعر القائمة على كل النماذج
- · قناة أولوية إلى Anthropic Max
- · دعم مخصَّص، وفوترة ملائمة للتدقيق
قاعدة تسعير واحدة، لكل نموذج
- · كل نموذج LLM وصورة وفيديو وصوت يُحتسب بسعر القائمة الرسمي المعروض على /models.
- · قيمة Max (200$ ← 4×) وEnterprise (2,000$ ← 6×) تأتي من أرصدة إضافية تُمنح وقت الشحن، وليس من مستويات خصم لكل نموذج.
- · لا أهلية للسلال، ولا شروط مكتوبة بحروف صغيرة لكل نموذج — أرصدتك تعمل بنفس الطريقة على Claude Opus وGPT-5.5 وGemini Flash.
تُطبَّق المضاعفات لكل عملية شحن. تحتفظ أرصدة Max الموجودة بقيمتها 4× حتى تنفقها — اشحن Pro بعدها وسيمنحك 20$ مبلغ 20 مليون رصيد بمعدّل 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 | النموذج مدرَج لكنه قريبًا |
| 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. ترجع إدخالات "قريبًا" رمز HTTP 503 من API؛ استدعاؤها اليوم لا يفعل شيئًا ولا يستهلك أرصدة.
هل أنت جاهز للبدء؟
مفتاح واحد يعمل عبر Claude Code وOpenCode وCodex CLI وGemini CLI وCursor. اشحن أرصدة وأنشئ مفتاح API الخاص بك.
