cicora.ai
日本語
API仕様Messages形式

Messages API

トップレベルのシステム指示と明示的な出力上限を持つ会話にはMessages形式を使用します。

連携リファレンス：お使いの環境に合わせて、アカウントのAPI設定とモデルカタログからパラメーターおよび利用可能な機能を選択してください。

メッセージを構成

リクエストにはmodel、messages、max_tokensを含め、システム指示は個別のsystemフィールドで送信します。再試行時にコンテキストを再現できるよう、役割とメッセージ順を保持します。

生のHTTPでは次のURLを呼び出します：https://cicora.ai/api/v1/messages, これに対し、Messages SDKにはゲートウェイルート https://cicora.ai/api だけを渡し、SDK自身が /v1/messages を追加します。

Messages APIリクエスト
bash
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のいずれかを選び、内部履歴は一度だけ正規化します。

ツール結果と長いコンテキストを含む、保存済みの非識別化された会話を使って移行をテストします。

次に読む