Messages API

編寫訊息

請求包含 model、messages 與 max_tokens；系統指示會放在獨立的 system 欄位中傳送。請保留角色與訊息順序，讓重試能重現脈絡。

原始 HTTP 呼叫使用 https://cicora.ai/api/v1/messages, 而 Messages SDK 只接收閘道根目錄 https://cicora.ai/api 並自行附加 /v1/messages。

curl --request POST https://cicora.ai/api/v1/messages \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "anthropic/claude-sonnet-5",
    "max_tokens": 500,
    "system": "Answer with a compact checklist.",
    "messages": [{"role": "user", "content": "Prepare a release plan."}]
  }'

工具與串流

• 只有在模型支援時，才加入 tools 與 tool_choice。
• 將串流模式當作事件序列處理，而非單一 JSON 物件。
• 執行動作前先確認工具引數的結構。

選擇格式

請勿在同一請求中混用兩種格式的欄位。在用戶端邊界選擇 chat 或 messages，並只將內部記錄標準化一次。

使用已儲存且已去識別化的對話測試移轉，其中應包含工具結果與長脈絡。