POST /v1/messages

Anthropic と互換性のあるメインのエンドポイント。選択したモデルでサポートされている場合、ストリーミング、プロンプト キャッシュ、ビジョン、ツールの使用、および拡張思考をサポートします。

認証

x-api-key: mg_live_...\nanthropic-version: 2023-06-01\ncontent-type: application/json

最低限のお願い

curl https://api.model-gate.com/v1/messages \
  -H "x-api-key: mg_live_..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4.8",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

事前リクエスト

{
  "model": "claude-opus-4.8",
  "max_tokens": 4096,
  "system": "You are a coding assistant.",
  "thinking": {"type": "enabled", "budget_tokens": 8000},
  "messages": [{"role": "user", "content": "Find the bug in this code."}],
  "tools": [{
    "name": "search_files",
    "description": "Search project files",
    "input_schema": {"type": "object", "properties": {"q": {"type": "string"}}}
  }]
}

ビジョン

{
  "model": "claude-opus-4.8",
  "max_tokens": 1024,
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "What is shown in this image?"},
      {"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": "..."}}
    ]
  }]
}

即時キャッシュ

{
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Large reusable context...", "cache_control": {"type": "ephemeral"}},
      {"type": "text", "text": "New question"}
    ]
  }]
}

ストリーミング

セット "stream": true。応答はサーバー送信イベントとして返されます。

応答

{
  "id": "msg_...",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-4.8",
  "content": [{"type": "text", "text": "Hello!"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 12, "output_tokens": 8}
}

リクエストとレスポンスの構造は Anthropic Messages API に従います。既存の Anthropic SDK には通常、 base_url 変化。