Skip to main content
استخدم هذا الدليل لإرسال طلب Phaseo ناجح، بنص مولّد أو قرار منظّم، وتأكد من موضع ظهور الاستجابة.
تستخدم وكيل برمجة؟ انسخ هذا الموجّه والصقه قبل البدء:
ستتعلّم في هذا الدليل كيفية:
  • إنشاء مفتاح API
  • إرسال طلب نص أو قرار منظّم
  • قراءة النص المولّد أو الإجابات ذات الأنواع المحددة
  • معرفة أول ما يجب التحقق منه إذا فشل الطلب

1. أنشئ مفتاح API

  1. افتح لوحة تحكم Phaseo.
  2. أنشئ مفتاحاً ضمن Gateway -> المفاتيح.
  3. انسخه مرة واحدة واحفظه في مكان آمن.
استخدم التنسيق التالي:
تعامل مع مفتاح API كما تتعامل مع كلمة المرور. لا تكشفه في التعليمات البرمجية على جانب العميل.

2. أرسل طلباً نصياً

استخدم POST /v1/responses في طلبك الأول. هذه هي نقطة النهاية الموصى بها لعمليات إنشاء النصوص الجديدة.

الطلب

الاستجابة

عند استدعاء Responses API مباشرةً، اقرأ رد المساعد من output[].content[] حيث تكون قيمة type هي output_text. إذا كنت تستخدم Vercel AI SDK، فاقرأ الرد من result.text.

3. اتخاذ قرار منظّم

استخدم POST /v1/decisions عندما يحتاج تطبيقك إلى إجابات ذات أنواع محددة بدل النص المولّد. يوفّر Phaseo نموذج Jev 1.13 من TypeSafe بمعرّف typesafe/jev-1.13.0. أرسل قيمة state وسؤالًا مسمّى أو أكثر؛ تُعاد كل إجابة بالاسم نفسه.
Decisions قدرة تجريبية وقد تتطلب تفعيلًا لمساحة العمل. تبلغ تكلفة Jev 1.13 مقدار $0.042 لكل مليون رمز إدخال؛ رموز الإخراج مجانية.
شغّل الأمثلة على خادمك مع تعيين PHASEO_API_KEY. لا تكشف مفتاح API للبوابة في كود المتصفح أبدًا. أنواع الأسئلة الثلاثة هي:
  • يختار choice خيارًا من خريطة معايير ويعيد الاحتمالات والثقة.
  • يعيد noul احتمال نعم/لا بين 0 و1.
  • يقيّم score مصفوفة معايير مرتبة ويعيد نتيجة موزونة بالاحتمالات.
يمكنك الجمع بين أنواع الأسئلة في الطلب نفسه.

الطلب

الاستجابة

اقرأ القيمة ذات النوع المحدد من الإجابة المطابقة لمعرّف سؤالك، مثل answers.department.choice أوanswers.is_urgent.noul أوanswers.customer_impact.score. استخدم confidence وprobabilities لتحديد عتبة للتطبيق بدل اتخاذ القرار على أساس القيمة وحدها. راجع مرجع Decisions API لعقد الطلب والاستجابة الكامل، ومرجع نموذج Jev من TypeSafe لسلوك النموذج وحدود المزوّد.

4. استكشاف أخطاء الطلب الأول وإصلاحها

  • 401: تحقّق من مفتاح API وترويسة Authorization.
  • 400: تحقّق من محتوى الطلب ومعرّف النموذج.
  • 402: انتقل إلى نموذج :free أو أضف رصيداً قبل استخدام نموذج مدفوع.
  • 429 أو 5xx: أعد المحاولة مع زيادة مدة الانتظار تدريجياً.
استخدم مرجع معالجة الأخطاء لتحديد المشكلة بسرعة.

5. إذا كنت تطوّر ميزة فيديو

إنشاء الفيديو غير متزامن. أنشئ مهمة أولاً، ثم استعلم عن حالتها أو اشترك لتلقّي النتيجة.
  1. أنشئ مهمة باستخدام POST /v1/videos.
  2. استعلم عن الحالة باستخدام GET /v1/videos/{video_id} حتى تكتمل المهمة.
  3. نزّل المحتوى باستخدام GET /v1/videos/{video_id}/content.

6. تابع البناء

التكامل مع Gateway

أنماط التكامل في بيئة الإنتاج واختيار نقطة النهاية.

مرجع API

توثيق كامل للطلبات والاستجابات لكل نقطة نهاية.

أمثلة

أمثلة طلبات أكثر اكتمالاً لسير العمل الشائع.

الدعم

احصل على مساعدة في تصحيح الأخطاء والتوجيه وسلوك النماذج.
آخر تعديل في ٢ أكتوبر ٢٠٢٦