البرنامج التعليمي لواجهة برمجة التطبيقات

دليل البدء السريع مع API لنموذج Claude Fable 5.2

موصلان بلون الغرافيت تربطهما قضبان كهرمانية

إذا كنت تقوم بتوصيل Fable 5.2 بمسار المراجعة، فابدأ بطلب صغير يمكنك فحص نتيجته. لقد اتبعنا مرجع Anthropic's Claude API والملاحظات النموذجية لهذه البداية السريعة. يستخدم المثال نقطة نهاية الطرف الأول وملخصًا خياليًا.

الخطوات السريعة

اضبط بيانات اعتماد Claude API خارج الشيفرة، واستدعِ Messages باستخدام claude-fable-5-2، ثم افحص كتل النص وstop_reason وusage. أضف الصور أو الأدوات بعد نجاح الطلب الأساسي والتحقق من نتيجته.

1. قم بإعداد الوصول وإدخال اختبار صغير

استخدم مفتاح Claude Platform API واجعله متاحًا كمتغير بيئة ANTHROPIC_API_KEY في غلافك المحلي. استخدم ملخصًا خياليًا أثناء التحقق من صحة التكامل. ينتمي المفتاح إلى مخزن بيانات الاعتماد الخاص بك ويجب أن يظل خارج سجلات الطلبات.

2. أرسل الرسالة الأولى

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

الحد الأدنى من طلب الطرف الأول
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-fable-5-2","max_tokens":1024,"messages":[{"role":"user","content":"يحتاج مخبز خيالي إلى تصميم لإطلاق منتج. اذكر ثلاثة تفاصيل يجب تأكيدها قبل كتابة موجز التصميم."}]}'

3. فحص الاستجابة الفعلية

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

4. أضف قدرة واحدة في كل مرة

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

5. اجعل عملية التسليم قابلة للقراءة

بالنسبة لمسار التصميم، قم بإنتاج ملخص قصير يحتوي على معرفات المصدر والنسخة المطلوبة والمجهولات. اطلب من أحد الأشخاص التحقق منه قبل نسخ الملخص المعتمد إلى Ciyo للعمل المرئي. احفظ النتيجة المقبولة ومعرفات الصور المصدر حتى تتمكن المراجعة اللاحقة من إعادة بناء القرار.

شخّص الطلب الصغير قبل إضافة خط إنتاج

عند فشل المصادقة، تحقق من بيانات الاعتماد والمؤسسة المحددة. وعند وجود خطأ في بنية الطلب، اقرأ رسالة الخطأ ووثائق النموذج. سجّل الحالة ومعرّف الطلب ورسالة منقحة من الأسرار؛ لا تضع المفتاح في ملاحظة الدعم.

إذا توقف الرد عند حد الرموز، فتحقق من وجود العناصر الثلاثة المطلوبة. نجاح HTTP لا يعني اكتمال الموجز. قلّص المخرج المطلوب أو عدّل الحد، ثم راجع النتيجة التالية قبل إضافة أدوات أخرى.

أسئلة شائعة

هل معرف نموذج Claude API هو نفسه الموجود على Bedrock؟

تستخدم واجهة برمجة تطبيقات الطرف الأول claude-fable-5-2. يسرد Anthropic معرفًا منفصلاً لنموذج Bedrock. اتبع مسار المزود الخاص بك وتعليمات النشر.

كيف يمكنني التحقيق في خطأ المصادقة؟

تأكد من أن البيئة تحتوي على المفتاح المقصود وأنها تنتمي إلى المؤسسة التي تنوي استخدامها. احتفظ ببيانات الاعتماد بعيدًا عن أي لقطات شاشة أو سجلات مشتركة.

العمل من الملخص المعتمد

استخدم وكيل تصميم Ciyo بمجرد أن تصبح تفاصيل المصدر والمهمة المرئية جاهزة لتمرير التصميم الحقيقي.