كيفية تبديل مفتاح واجهة برمجة تطبيقات Claude الخاص بك ours

لwhy يغير المطورون مفتاحهم إلى نقطة نهاية غير مقيدة

تواجه بعض الأحمال القانونية المسموح بها رفضًا من قبل مساعد قياسي، على سبيل المثال الخيال للكبار، الأسئلة الطبية المباشرة أو أبحاث الأمن. نقطة النهاية غير المقيدة تجيب على تلك الطلبات مباشرة، والحد الصارم الوحيد هو المحتوى الجنسي الذي يتضمن قاصرين.

قرر مسبقًا أي الطلبات يقبلها منتجك، لأن النموذج لن يتخذ هذا القرار نيابة عنك.

الخطوة 1: استرداد مفتاح API غير الخاضع للرقابة الجديد الخاص بك

سجّل باستخدام Google أو بريد إلكتروني وكلمة مرور في صفحة الحصول على مفتاح API. يظهر المفتاح على الشاشة مرة واحدة. يبدأ الحساب برصيد تجريبي بقيمة $0.50 صالح لمدة 7 أيام، ولا يلزم بطاقة.

• احفظ المفتاح في متغير بيئة، وليس أبداً في كود العميل.
• قم بتدوير المفتاح في أي وقت؛ سيتوقف المفتاح القديم عن العمل على الفور.

الخطوة 2: تحديث عنوان URL الأساسي في الكود

اضبط عنوان URL الأساسي إلى https://mistralgetapikey.com/v1 ونقل المفتاح الجديد في رأس المصادقة كرمز حامل. احتفظ بعنوان URL الأساسي في التكوين بحيث يمكنك تغييره دون نشر.

اترك بقية العميل كما هو. تبقى الرسائل والأدوار ومحلل الاستجابة كما هي.

الخطوة 3: التحقق من التبديل بطلب اختبار

أرسل طلباً قصيراً واحداً بمعرف النموذج uncensored. تأكيد الرد مع كتلة الاستخدام يؤكد المفتاح، وعنوان URL الأساسي ومعرف النموذج معاً.

إذا فشل الاتصال، اقرأ رمز الحالة أولاً. يعني 401 أن المفتاح خاطئ، ويعني 402 أن الرصيد استُنفد.

معالجة استجابات التدفق في كودك الحالي

تعيين stream: true if your product already streams. Each server-sent event carries a piece of the answer, and the last event carries the usage numbers.

جرّب التدفق على اتصال بطيء أيضاً، لأنه يجب أن ينتهي التدفق المقطوع برسالة خطأ واضحة في الواجهة وليس بجزء من الرد.

فحص توافق استدعاء الوظائف

إذا كان تطبيقك يستخدم الأدوات، عرّف دالة واحدة بمخطط JSON واسمح للنموذج باستدعائها. أعد نتيجة، ثم تحقق من أن الإجابة النهائية تستخدمها بشكل صحيح.

1. اختبر أداة تتطلب حجتين مطلوبتين.
2. جرّب أداة واحدة تليها أخرى.
3. التحقق من الحجج قبل اتخاذ إجراء بشأنها.

مراقبة استخدام الرموز والتكاليف

احفظ عدد رموز الإدخال والإخراج من كل استجابة مع معرف الطلب. اضربها في $0.15 و $0.50 لكل مليون رمز للحصول على تكلفة كل استدعاء.

استكشاف الأخطاء الشائعة في الاتصال

تنشأ معظم مشاكل التبديل من ثلاثة أسباب: مفتاح يحتوي على مسافات زائدة أو سطر جديد، أو عنوان URL الأساسي لا يزال يشير إلى الخدمة القديمة، أو مفتاح مفقود /v1 في نهاية URL.

يتيح كل مفتاح 300 طلب في الدقيقة و8 طلبات في نفس الوقت. يعني 429 إبطاء الوتيرة، وتصلح إعادة المحاولة مع زيادة الأثر ذلك.

التحقق النهائي والتشغيل

شغّل كلا الطرفين على نفس المطالبات لبضعة أيام وقارن الإجابات، وزمن الاستجابة والتكلفة. حوّل حركة المرور تدريجياً، راقب معدل الخطأ بعد كل خطوة واحتفظ بالمفتاح القديم في التكوين حتى يعمل المفتاح الجديد بنجاح.

عندما تتطابق الأرقام مع توقعاتك، قم بإزالة المفتاح القديم من البيئة ومن قائمة مراجعة الكود.