メッセージと役割
messages配列は、順序付きシーケンスとしてコンテキストを保持します。systemはタスクのルールを定め、userはリクエストを追加し、assistantとtoolは実行履歴を保持します。
文字列を連結して履歴を作らず、各メッセージのroleと元の順序を保持します。
チャット補完
bash
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を伴うモデル応答を分けて扱います。拒否やコンテキスト上限はインターフェース上のデータであり、結果を差し替える理由にはなりません。
データ保持ルールで許される場合は、認証情報を含めず、元のリクエスト本文と正規化した応答を保存します。