LogoZenn.CEO/
لوحة التحكمالدردشةمفاتيح APIالوثائق
التوثيق

مرجع API والإعداد

مفتاح API واحد بصيغة ck_ يعمل عبر Claude Code وOpenCode وCodex CLI وGemini CLI وCursor وHTTP المباشر. أسعار قائمة المزوّد الرسمية على فاتورة واحدة — ادفع حسب الاستخدام، بدون اشتراك.

جدول المحتويات
1. البدء2. عناوين baseURL3. Claude Code4. OpenCode5. Codex CLI6. Gemini CLI7. Cursor IDE8. API المباشر (cURL)9. توليد الصور10. النماذج والأسعار11. المصادقة12. الخطط13. حدود المعدّل والأخطاء14. قريبًا

1. البدء

Zenn.Engineering هو بوابة API بديلة جاهزة لنماذج Anthropic وOpenAI وGoogle AI، بالإضافة إلى توليد الصور. تستخدم مفتاحًا واحدًا بصيغة ck_ في كل مكان — بدون أي تعديل في الكود، فقط وجِّه أداتك إلى baseURL لدينا.

1. احصل على مفتاح API

اختر خطة من /pricing، ثم أنشئ مفتاحًا في /manage-api-keys.

2. اضبط baseURL

وجِّه أداتك إلى https://zenn.engineering/api/v1.

3. ابدأ البناء

يعمل مع Claude Code وOpenCode وCodex CLI وGemini CLI وCursor وأي عميل متوافق مع OpenAI/Anthropic.

2. عناوين baseURL

مفتاح واحد، وثلاثة عناوين baseURL متوافقة مع البروتوكولات (Anthropic / OpenAI / Gemini)، بالإضافة إلى نقطة نهاية لتوليد الصور.

الواجهةbaseURLالاستخدام مع
متوافق مع Anthropichttps://zenn.engineering/api/v1Claude Code وAnthropic SDK وOpenCode (مزوّد anthropic)
متوافق مع OpenAI (Codex)https://zenn.engineering/api/v1/codexCodex CLI وOpenAI SDK وCursor
متوافق مع Geminihttps://zenn.engineering/api/v1/geminiGemini CLI وGoogle AI SDK
توليد الصورhttps://zenn.engineering/api/v1/images/generationsgpt-image-2 (حمولة متوافقة مع OpenAI)

3. Claude Code

الـ CLI الرسمي من Anthropic لـ Claude. اضبط متغيرَي بيئة فقط ليعمل كبديل جاهز.

الخطوة 1 — اضبط البيئة

أضف إلى ملف الـ shell الخاص بك (~/.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 مفتاح API عبر ترويسة x-api-key (الأصلية في Anthropic SDK) ويُلحق /messages بـ baseURL. تُمرَّر ترويستا anthropic-version وanthropic-beta إلى المصدر. البث المباشر مدعوم عبر SSE.

4. OpenCode

وكيل برمجي متعدد المزوّدين. ملف 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

الـ CLI الرسمي من OpenAI لعائلة GPT-5 / Codex. اضبط متغيرَي بيئة ووجِّه إلى baseURL الخاص بـ Codex لدينا.

اضبط البيئة

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

يُرسل Gemini CLI من Google المفتاح عبر 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":

الحقلالقيمة
Override OpenAI Base URLhttps://zenn.engineering/api/v1/codex
OpenAI API Keyck_YOUR_API_KEY
Add custom modelsgpt-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 · 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) بسعر ثابت موحَّد — راجع قسم النماذج للتفاصيل. نماذج الصور والفيديو والصوت الأخرى مدرَجة بوسم "قريبًا".

نقطة النهاية

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)

معرّف النموذجالإدخال / 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-260000$0.06متاح

تُحتسب جميع نماذج الصور والفيديو والصوت بسعر القائمة الرسمي. نماذج الصور الأخرى (عائلة Nano Banana وGemini 3 Pro Image وSeedream) مدرَجة في الكتالوج لكنها حاليًا قيد "قريبًا" — يرفضها 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
20$ · 10,000,000 رصيد

أسعار قياسية. ادفع حسب الاستخدام.

  • · كل LLM رائد بسعر القائمة الرسمي
  • · API متوافق مع OpenAI / Anthropic / Gemini
  • · حدود إنفاق لكل مفتاح، وتحليلات لحظية
Max
200$ · 400,000,000 رصيد

4× أرصدة — 200$ تشتري 800$ من الاستخدام بسعر القائمة.

  • · كل ميزات Pro
  • · 4× أرصدة لكل دولار وقت الشحن
  • · نفس سعر القائمة على كل النماذج
  • · طابور أولوية + توجيه أسرع
Enterprise
2,000$ · 6,000,000,000 رصيد

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/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النموذج مدرَج لكنه قريبًا
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 الخاص بك.

عرض الخططإدارة مفاتيح API
Logo
Zenn.CEOذكاء متقدم للجميع
XX (Twitter)GitHubLinkedInEmail
Product
  • Chat
  • API
  • Pricing
الشركة
  • About
  • اتصل بنا
  • سياسة ملفات تعريف الارتباط
  • سياسة الخصوصية
  • شروط الخدمة
  • سياسة الاسترداد
جميع الأنظمة تعمل بشكل طبيعي
•صُنع في كاليفورنيا بحب ❤️
© حقوق النشر 2026. جميع الحقوق محفوظة.