cicora.ai
מפרט APIאירועים שנשלחים מהשרת

הזרמה

קבלו אסימונים ומקטעים מובנים דרך SSE בלי להמתין לתשובה המלאה.

מדריך שילוב: בחרו פרמטרים ויכולות זמינות בהגדרות ה-API של החשבון ובקטלוג המודלים של הסביבה שלכם.

פתיחת זרם SSE

הפעילו stream: true והשביתו אגירה בצד הלקוח. השרת שולח אירועי נתונים כשחלקי התשובה נעשים זמינים.

עבדו את הזרם בהדרגה: אירוע יחיד אינו חייב להכיל טקסט שלם או קריאת כלי מלאה.

זרם SSE
bash
curl --no-buffer --request POST https://cicora.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "stream": true,
    "stream_options": {"include_usage": true},
    "messages": [{"role": "user", "content": "Write a three-line poem."}]
  }'

הרכבת מקטעי העדכון

  • צברו טקסט לפי choice/index או מזהה פריט.
  • אספו ארגומנטים לכלי כזרם של מקטעי JSON ונתחו אותם לאחר ההשלמה.
  • כאשר המדדים הסופיים חשובים, הפעילו במפורש בזרם את האפשרות הזמינה לקבלת נתוני שימוש.

סיום וביטול

ראו בזרם שלם רק לאחר אירוע סופי. סגירת חיבור בלעדיו היא נתיב כשל נפרד.

חברו AbortController או רכיב מקביל לניווט המשתמש, כדי שבקשה שאינה נחוצה לא תישאר פתוחה.