メッセージを作成

Anthropic Messages API：Claude モデル専用。Base URL に /v1 を付けず、Anthropic SDK と Claude Code でそのまま使えます。

POST/v1/messages

Claude モデルは Anthropic プロトコルを使います。SDK の Base URL には https://api.hop-base.com を指定し（/v1 は付けません）、リクエストパスは /v1/messages のままです。POST /v1/messages/count_tokens にも対応しています。

下表にはゲートウェイが値を補ったり特別に処理したりする部分のみを載せています。その他の Messages API フィールドはそのまま転送され、値の範囲は Anthropic の公式仕様に従います。Claude のキーで OpenAI プロトコルのパスを呼ぶと 404「当前平台不支持该 API 路径」を返します。

メッセージを作成

curl https://api.hop-base.com/v1/messages \
  -H "x-api-key: $HOPBASE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "こんにちは"
      }
    ]
  }'

200application/json

{
  "id": "msg_EXAMPLE",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-5",
  "content": [
    {
      "type": "text",
      "text": "こんにちは！何かお手伝いできることはありますか？"
    }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 9,
    "output_tokens": 14,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

ヘッダー

Authorization:任意string

Bearer sk-…。x-api-key: sk-… でも可（どちらか一方）

anthropic-version:任意string

SDK が自動で付与し、そのまま転送されます。例：2023-06-01

anthropic-beta:任意string

Beta 機能のスイッチ。そのまま転送されます

リクエストボディJSON

model:必須string

現在のキーのグループに含まれる Claude モデル ID。グループにそのモデルがない場合は 404 model_not_found を返します

max_tokens:任意integer

ゲートウェイでは上限を設けず、最大値はモデルの公式仕様に従います。公式 API では必須ですが、HopBase は省略時に 4096 を補います。長い出力は 4096 で打ち切られる（stop_reason: "max_tokens"）ため、明示的に指定してください

デフォルト4096

messages:必須array of object

Anthropic 公式形式に従い、そのまま転送されます

個数≥ 1 個

system:任意string または array

システムプロンプト。そのまま転送されます

stream:任意boolean

true で Anthropic の SSE イベントストリームを返します

デフォルトfalse

tools:任意array of object

Anthropic のツール定義（name、description、input_schema）。そのまま転送されます

thinking:任意object

拡張思考の設定。そのまま転送され、値は Anthropic の公式仕様に従います

temperature:任意number

そのまま転送され、範囲は Anthropic の公式仕様に従います

レスポンス

200成功。非ストリーミングでは message JSON、stream: true のときは Anthropic の SSE

id:任意string

メッセージ ID

type:任意"message"

role:任意"assistant"

model:任意string

モデル ID

content:任意array of object

コンテンツブロック

stop_reason:任意string

end_turn / max_tokens / tool_use / stop_sequence

usage:任意object

トークン使用量

エラー

400Anthropic 形式：{"type":"error","error":{"type":"invalid_request_error","message":"…"}}。code はありません。キー検証段階のエラー（401、402、403）は OpenAI 形式のままです

401キー未指定、キーが無効または期限切れ（missing_api_key / invalid_api_key / api_key_expired）

402残高、またはキー・メンバー・部門のクォータを使い切った（insufficient_quota）

404モデルがこのキーのグループにない（model_not_found）、またはパスがそのグループに属さない（route_not_found）

413リクエストボディが 60 MB を超えた（request_too_large）

429アカウントまたはキーの同時実行数が上限に達した（user_concurrency_limit / apikey_concurrency_limit）。Retry-After 付き

ヘッダー

リクエストボディJSON

レスポンス

エラー

関連ページ