POST /v1/responses، واقرأ الرد من output_text.
ابدأ مع وكيل البرمجة
انسخ هذا الموجّه إلى وكيل البرمجة. يحدد لغة مشروعك، ويثبّت حزمة SDK، ويوجّه الوكيل إلى وثائق Phaseo، ويُبقي مفتاحك خارج الشيفرة، ويرسل أول طلب. يعمل إذا كان مشروعك يستخدم Phaseo بالفعل، فإنه يراجع ذلك الإعداد بدلًا من البدء من جديد.phaseo/free من دون رصيد، ويمكنك استبداله بأي معرّف نموذج نصي من النماذج.
موجّه الإعداد لوكيل البرمجة. انسخه أو افتحه في Cursor.
1. أنشئ مفتاح API
أنشئ مفتاحًا من لوحة التحكم ضمن الإعدادات -> مفاتيح API، ثم صدّره:تعامل مع مفتاح API كما تتعامل مع كلمة المرور. أبقِه في شيفرة الخادم ولا تضمّنه أبدًا في متصفح أو تطبيق جوال.
أضف رصيدًا للنماذج المدفوعة
يعملphaseo/free دون رصيد. أما النماذج المدفوعة مثل openai/gpt-6-astra فتحتاج إلى رصيد في المحفظة:
2. أرسل طلبًا نصيًا
POST /v1/responses هي نقطة النهاية الموصى بها لأعمال النصوص الجديدة. تستخدم الأمثلة openai/gpt-6-astra، وهو نموذج مدفوع. للتجربة دون رصيد، استبدله بـ phaseo/free، الذي يختار نموذجًا مجانيًا متاحًا؛ راجع ابدأ باستخدام الموجّه المجاني.
لا يحتاج cURL وfetch إلى تثبيت أي شيء. لاستخدام حزمة SDK، ثبّتها أولًا:
3. اقرأ الرد
بثّ الرد
استخدم البث لطباعة الرد أثناء توليده. يحتوي الحقلtext في كل حدث response.output_text.delta على النص الجديد فقط، لذلك تطبع هذه الحلقة الإجابة مرة واحدة. أما أحداث الإغلاق مثل response.output_text.done فتكرّر نصًا سبق بثّه. راجع البث للاطلاع على قائمة الأحداث الكاملة.
4. استكشف أخطاء الطلب الأول وأصلحها
يسرد مرجع الأخطاء كل رمز خطأ وما يجب فعله حياله.
احصل على إجابات ذات أنواع محددة بدل النص
عندما تحتاج شيفرتك إلى قيمة لا إلى نص نثري، أرسل الأسئلة إلىPOST /v1/decisions (تجريبي). تعود كل إجابة بنوع محدد مع الاحتمالات، وبترتيب الأسئلة نفسه. أنواع الأسئلة هي predicate (نعم/لا)، وchoice (أحد خياراتك)، وscore (مستوى على مقياسك).
answers[0].choice أو answers[1].probability، واستخدم confidence أو probabilities لتحديد عتبتك الخاصة. يسرد مرجع Decisions كل نماذج القرارات وحدودها وأسعارها، وإدخال الصور، والتنسيق الأقدم state مع خرائط الأسئلة المسمّاة (noul وcriteria)، الذي لا يزال يعمل وتتطلبه بعض النماذج.
ولّد فيديو
توليد الفيديو غير متزامن: أنشئ مهمة، واستعلم عن حالتها، ثم نزّل الملف.تابع البناء
التكامل مع Gateway
اختر نقطة نهاية وجهّز تكاملًا للإنتاج.
مرجع API
كل حقول الطلب والاستجابة لكل نقطة نهاية.
أمثلة
تطبيقات مبدئية لسير العمل الشائع.
الدعم
احصل على مساعدة في تصحيح الأخطاء والتوجيه وسلوك النماذج.