تستخدم وكيل برمجة؟ انسخ هذا الموجّه والصقه قبل البدء:
- إنشاء مفتاح API
- إرسال طلب نص أو قرار منظّم
- قراءة النص المولّد أو الإجابات ذات الأنواع المحددة
- معرفة أول ما يجب التحقق منه إذا فشل الطلب
1. أنشئ مفتاح API
- افتح لوحة تحكم Phaseo.
- أنشئ مفتاحاً ضمن Gateway -> المفاتيح.
- انسخه مرة واحدة واحفظه في مكان آمن.
تعامل مع مفتاح API كما تتعامل مع كلمة المرور. لا تكشفه في التعليمات البرمجية على جانب العميل.
2. أرسل طلباً نصياً
استخدمPOST /v1/responses في طلبك الأول. هذه هي نقطة النهاية الموصى بها لعمليات إنشاء النصوص الجديدة.
الطلب
الاستجابة
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. إذا كنت تطوّر ميزة فيديو
إنشاء الفيديو غير متزامن. أنشئ مهمة أولاً، ثم استعلم عن حالتها أو اشترك لتلقّي النتيجة.- أنشئ مهمة باستخدام
POST /v1/videos. - استعلم عن الحالة باستخدام
GET /v1/videos/{video_id}حتى تكتمل المهمة. - نزّل المحتوى باستخدام
GET /v1/videos/{video_id}/content.
6. تابع البناء
التكامل مع Gateway
أنماط التكامل في بيئة الإنتاج واختيار نقطة النهاية.
مرجع API
توثيق كامل للطلبات والاستجابات لكل نقطة نهاية.
أمثلة
أمثلة طلبات أكثر اكتمالاً لسير العمل الشائع.
الدعم
احصل على مساعدة في تصحيح الأخطاء والتوجيه وسلوك النماذج.