الانتقال إلى المحتوى الرئيسي
احتفظ بـ Anthropic SDK واستدعاء Messages. وجّه العميل إلى https://api.phaseo.app، ومرّر مفتاح Phaseo بوصفه authToken، وامنح كل نموذج معرّفه في Phaseo.

تبديل العميل

أنشئ مفتاحًا في مفاتيح API، واجعله متاحًا للتطبيق بوصفه PHASEO_API_KEY.
ثلاث تفاصيل تُفشل هذه الخطوة في أغلب الأحيان:
  • استخدم المضيف الجذر. يؤدي baseURL: "https://api.phaseo.app/v1" إلى /v1/v1/messages. أما عملاء OpenAI المتوافقون في المستودع نفسه فيظلون يستخدمون /v1.
  • أرسل المفتاح كرمز bearer. لا تقرأ البوابة إلا Authorization: Bearer؛ وتحصل ترويسة x-api-key على 401 missing_or_invalid_authorization_header. يرسل authToken ترويسة Bearer في كل إصدارات SDK. أما apiKey فلا يفعل ذلك إلا بدءًا من @anthropic-ai/sdk 1.0 وanthropic 2.0.
  • أزل ANTHROPIC_API_KEY من البيئات التي تستدعي Phaseo الآن. يمنع apiKey: null إصدارات TypeScript SDK الأقدم من قراءته، وتقرؤه إصدارات Python SDK السابقة لـ 0.98 حتى عند ضبط auth_token.
تستخدم الأدوات التي تُضبط عبر متغيرات البيئة، مثل Claude Code، القيمة ANTHROPIC_BASE_URL=https://api.phaseo.app، وANTHROPIC_AUTH_TOKEN مضبوطًا على مفتاح Phaseo، وANTHROPIC_API_KEY فارغًا.

مطابقة معرّفات النماذج

تحقّق من كل نموذج إنتاجي مقابل data[].id من GET /v1/models?format=openai. تستخدم معرّفات Phaseo النقاط في الإصدار: يصبح claude-sonnet-5-5 هو anthropic/claude-sonnet-5.5. إذا كان النموذج يتغير أيضًا، فاقرأ دليل ترحيل النموذج الخاص به.

ما الذي يعمل بشكل مختلف

الاختبار والنشر

اختبر مطالبات النظام والبث واستخدام الأدوات والتفكير والمخرجات المنظّمة باستخدام معرّفات النماذج نفسها التي يستخدمها التطبيق. ثم قارن مجموعة مطالبات تمثيلية عبر الإعدادين من حيث شكل المخرجات وزمن الاستجابة واستخدام الرموز والأخطاء والتكلفة. قبل نقل الحركة، تأكد من أن:
  • مفتاح Phaseo مضبوط في كل بيئة نشر؛
  • كل معرّف نموذج إنتاجي موجود في GET /v1/models?format=openai؛
  • مسارات البث واستخدام الأدوات تنجح في بيئة الاختبار المرحلية؛
  • كل ترويسة anthropic-beta وكل حقل تجريبي فقط قد أُزيل أو استُبدل؛
  • التراجع لا يزال مجرد تغيير لعنوان URL الأساسي والمفتاح.
آخر تعديل في ٧ نوفمبر ٢٠٢٦