استقبل الرد بالبث
اعرض الرد أثناء كتابته، وميّز البث المكتمل من البث المنقطع.
اضبط "stream": true وسترسل Phaseo المخرجات كأحداث مرسلة من الخادم (SSE) أثناء كتابة النموذج لها:
curl --no-buffer https://api.phaseo.app/v1/responses \
-H "Authorization: Bearer $PHASEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-6-astra",
"input": "Say hello in one sentence.",
"stream": true
}'
تحقّق من حالة HTTP أولًا. الطلب الذي يفشل قبل بدء البث يحصل على خطأ JSON العادي، لا على بث. ثم اقرأ الأحداث. لكل نقطة نهاية تنسيقها الخاص:
| نقطة النهاية | يصل النص في | النهاية الناجحة | نهاية الفشل |
|---|---|---|---|
| Responses | response.output_text.delta | response.completed | response.failed أو error |
| Chat Completions | choices[].delta | finish_reason، ثم [DONE] | إطار error دون finish_reason |
في Chat Completions، يحمل جزء أخير بقيمة choices فارغة الحقل usage، بما فيه cost للبث كله، قبل [DONE]. ولا يرسل [DONE] إلا Chat Completions. قد يحمل جزء الشبكة نصف حدث أو عدة أحداث، لذا خزّن البيانات مؤقتًا حتى يكتمل الحدث قبل تحليله، أو استخدم أداة بث من SDK.
لا يكتمل البث إلا عند وصول حدث نهايته الناجحة. إغلاق الاتصال وحده لا يعني أن الإجابة مكتملة. إذا فشل في المنتصف، فاحتفظ بالنص الجزئي مع وسمه كمنقطع واعرض إعادة المحاولة. لا تحتسب Phaseo المخرجات الجزئية لبث فشل.
للإلغاء، مرّر AbortSignal (أو ما يقابله في عميل HTTP لديك) وألغِ الطلب عندما يتوقف المستخدم. الإلغاء لا يضمن أن يتوقف المزوّد فورًا، ولا أن تكون المخرجات المولّدة بالفعل مجانية.
تحقّق من فهمك
أرسل بث Chat Completions نصًا، ثم أُغلق الاتصال. لم ترَ finish_reason ولا [DONE]. ماذا تفعل؟
طبّق ما تعلّمته
يستطيع المستخدمون الضغط على إيقاف في واجهة الدردشة لديك. يفترض مدير المنتج أن الردود الموقوفة لا تكلّف شيئًا. هل هذا صحيح؟
اعرض الإجابةأخفِ الإجابة
لا. ألغِ الطلب بـ AbortSignal كي يتوقف تطبيقك عن القراءة، لكن التوثيق يقول إن الإلغاء لا يضمن أن يتوقف المزوّد فورًا، ولا أن تكون المخرجات التي ولّدها بالفعل مجانية. توقّع أن تُحتسب الردود الموقوفة على العمل الذي أُنجز.
الخلاصة
روابط ذات صلة
آخر مراجعة: ١٧ نوفمبر ٢٠٢٦