プロトコルと URL：Chat、Responses、Claude、Gemini

エンドポイント一覧

各プロトコルには、対応するチャネルとモデルが必要です。/v1/models からモデルを選び、プロトコルの対応状況を確認してください。画像入力、ツール呼び出し、構造化出力、キャッシュ、推論パラメーターもモデルとチャネルによって異なります。

Responses

curl https://api.aimirrorx.com/v1/responses \
  -H "Authorization: Bearer $AIMIRRORX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"MODEL_ID_FROM_V1_MODELS","input":"你好"}'

Responses と Chat ではレスポンスの構造が異なります。URL だけを変更して Chat 用の解析処理を流用しないでください。バックグラウンドタスクの取得、キャンセル、保存、履歴が利用できるとは限りません。GET /v1/responses/:id の利用可否はタスクプラグインの対応状況によって異なります。

Claude Messages

Claude SDK では通常 https://api.aimirrorx.com をオリジンに指定し、SDK が /v1/messages を追加します。SDK が /v1 を追加する場合に、OpenAI 用の /v1 付きベース URL を使わないでください。

curl https://api.aimirrorx.com/v1/messages \
  -H "x-api-key: $AIMIRRORX_API_KEY" \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  -d '{"model":"MODEL_ID_FROM_V1_MODELS","max_tokens":256,"messages":[{"role":"user","content":"你好"}]}'

/v1/messages/count_tokens は現在無効です。Claude のネイティブ API がすべて利用できるとは限りません。

Gemini generateContent

ネイティブ形式では /v1beta を使用します。/v1/v1beta ではありません。アクセスログへの漏えいを避けるため、キーは URL のクエリではなくリクエストヘッダーで送信してください。

curl 'https://api.aimirrorx.com/v1beta/models/MODEL_ID_FROM_V1_MODELS:generateContent' \
  -H "x-goog-api-key: $AIMIRRORX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"contents":[{"role":"user","parts":[{"text":"你好"}]}]}'

ストリーミング操作は :streamGenerateContent です。SSE の設定は SDK のバージョンとクライアントの要件に従ってください。Gemini ネイティブ形式と OpenAI 形式ではリクエスト本文が異なります。OpenAI の messages をネイティブ API にそのまま送信しないでください。