التوثيق
قم بتكوين نقطة نهاية واجهة برمجة التطبيقات (API) ومفتاحك عبر متغيرات البيئة - لا يلزم إجراء تغييرات على التعليمات البرمجية للدمج AnBoWork.
01نقاط نهاية API
02متغيرات البيئة
Windows الإعداد
صالح للجلسة الطرفية الحالية فقط. يُغلق عندما تُغلق النافذة. جيد للاختبار السريع.
macOS / Linux الإعداد
صالح للجلسة الطرفية الحالية فقط. يُغلق عندما تُغلق النافذة. جيد للاختبار السريع.
03تكامل الأداة
يمكن لأدوات ترميز الذكاء الاصطناعي السائدة الاتصال مباشرة بـ AnBoWork — ما عليك سوى تعيين متغيرات البيئة أو التكوين أدناه.
Claude Code كلي
واجهة سطر الأوامر الرسمية لـ Anthropic — اتصل بـ AnBoWork عبر متغيرات البيئة، دون الحاجة إلى تغييرات في التعليمات البرمجية.
انتقل إلى API Key Management لتنزيل البرنامج النصي للإعداد بنقرة واحدة →ثم ابدأ بـ:
Codex CLI
OpenAI الرسمي Codex CLI — يستخدم نقطة النهاية /v1/responses. ملاحظة: يجب أن يتضمن base_url /v1.
تحرير ~/.codex/config.toml:
ثم قم بتعيين مفتاح API كمتغير بيئة:
ثم ابدأ بـ:
Cursor / ركوب الأمواج
تجاوز نقطة النهاية OpenAI ومفتاح API في الإعدادات.
Cline (رمز VS)
حدد OpenAI الموفر المتوافق في Cline وأدخل نقطة النهاية والمفتاح واسم الطراز.
04أمثلة على الكود
ثَبَّتَ: pip install anthropic / openai · npm install openai
05جاري
إضافة دفق: يتوافق مع نص الطلب الخاص بك لتمكين دفق SSE - وهو مثالي لواجهات مستخدم الدردشة في الوقت الفعلي.
06تحويل التنسيق التلقائي
AnBoWork يقوم بإجراء تحويل شفاف في اتجاهين بين Anthropic الرسائل و OpenAI الدردشة على مستوى البوابة. هذا يعني أنه يمكنك استدعاء نفس النموذج إما بأسلوب Anthropic أو نمط OpenAI — قاعدة تعليمات برمجية واحدة، أي طراز.
تعيينات الحقول الرئيسية بين النمطين:
| Anthropic الاسلوب | OpenAI الاسلوب | وصف |
|---|---|---|
| system | messages[role=system] | يتم وضع موجه النظام بشكل مختلف؛ البوابة تتعامل معها تلقائيا |
| max_tokens(必填) | max_tokens(可选) | عند حذفها، تطبق البوابة الحد الافتراضي للنموذج |
| content 分块数组 | content 字符串 | تحويل كتل النص/الصورة من وإلى السلاسل |
| stop_reason | finish_reason | إنهاء سبب تعيين اسم الحقل |
07متعدد الوسائط
يستخدم إنشاء الصور نفس البوابة ومفتاح API، الذي تتم محاسبته حسب الاستخدام.
08استدعاء الوظيفة
تحديد الوظائف القابلة للاستدعاء باستخدام أدوات النمط OpenAI. يقوم النموذج بإرجاع استدعاءات الأداة عند الحاجة، ويقوم الكود الخاص بك بتنفيذها وإرجاع النتائج.
09معالجة الأخطاء
/v1/* تتبع نقاط النهاية تنسيق الخطأ OpenAI — تحتوي الاستجابات على النوع / الكود / الرسالة.
رموز الأخطاء الشائعة
| HTTP | وصف |
|---|---|
| 401 | مفتاح API غير صالح أو مفقود |
| 402 | الرصيد غير كافي - يرجى تعبئة الرصيد |
| 429 | معدل محدود أو الحصة اليومية استنفدت |
| 503 | جميع قنوات المنبع غير متاحة (الدائرة مكسورة) |