تقدم بعض نقاط نهاية واجهة برمجة التطبيقات (API) الاستجابات بشكل متدفق افتراضيًا، مثل /api/generate. يتم تقديم هذه الاستجابات بتنسيق JSON مفصول بأسطر جديدة (أي نوع المحتوى application/x-ndjson). على سبيل المثال:

{"model":"gemma4","created_at":"2025-10-26T17:15:24.097767Z","response":"That","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:15:24.109172Z","response":"'","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:15:24.121485Z","response":"s","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:15:24.132802Z","response":" a","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:15:24.143931Z","response":" fantastic","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:15:24.155176Z","response":" question","done":false}
{"model":"gemma4","created_at":"2025-10-26T17:15:24.166576Z","response":"!","done":true, "done_reason": "stop"}

تعطيل البث المتدفق

يمكن تعطيل البث المتدفق عن طريق توفير {"stream": false} في نص الطلب لأي نقطة نهاية تدعم البث المتدفق. سيؤدي هذا إلى إرجاع الاستجابات بتنسيق application/json بدلاً من ذلك:

{"model":"gemma4","created_at":"2025-10-26T17:15:24.166576Z","response":"That's a fantastic question!","done":true}

متى تستخدم البث المتدفق مقابل البث غير المتدفق

البث المتدفق (الافتراضي):

• توليد الاستجابات في الوقت الفعلي
• زمن استجابة ظاهري أقل
• أفضل للتوليدات الطويلة

البث غير المتدفق:

• أبسط في المعالجة
• أفضل للاستجابات القصيرة، أو المخرجات المنظمة
• أسهل في التعامل معه في بعض التطبيقات