Chat Completions

הודעות ותפקידים

המערך messages נושא הקשר כרצף מסודר. system קובע את כללי המשימה, user מוסיף בקשה, ו-assistant ו-tool משמרים את היסטוריית הביצוע.

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

curl --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",
    "messages": [
      {"role": "system", "content": "Be concise and cite assumptions."},
      {"role": "user", "content": "Draft a release checklist."}
    ],
    "temperature": 0.2
  }'

שליטה בפלט

• model מזהה משפחת מודלים וגרסה.
• temperature, top_p ומגבלת פלט שולטים בשונות ובגודל התשובה.
• שלחו רק פרמטרים שמסומנים כנתמכים במודל שנבחר.

לולאה מהימנה

הפרידו כשל תעבורה מתשובת מודל בעלת finish_reason. סירוב או גבול הקשר הם נתוני ממשק, ולא סיבה להחליף את התוצאה.

כאשר כללי שמירת הנתונים מאפשרים זאת, שמרו את גוף בקשת המקור ואת התשובה המנורמלת ללא פרטי גישה.