ドキュメントAPI リファレンスMessages API

Messages API

Anthropic 互換の Messages エンドポイントと count_tokens。

POST/v1/messages

Anthropic Messages API のリクエストボディと互換の対話エンドポイントです。認証は x-api-key を推奨（Authorization: Bearer も可）。SDK が自動付与する anthropic-version などのヘッダーはそのまま転送されます。

リクエストボディ

フィールド型必須説明
modelstringはいモデル id。モデル一覧を参照。
max_tokensintegerはい出力トークンの上限（Anthropic 形式では必須）。
messagesarrayはい対話メッセージ。role は user/assistant、content は文字列またはコンテンツブロック配列（画像可）。
systemstring | arrayいいえシステムプロンプト。
streambooleanいいえtrue の場合、SSE でストリーミング返却します。ストリーミング参照。
temperature / tools / …—いいえその他の公式フィールドはそのまま転送され、対応可否は対象モデルに依存します。
request.sh
curl https://api.soleapi.com/v1/messages \
  -H "x-api-key: $SOLEAPI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Write a haiku about the sea"}]
  }'

レスポンス

response.json
{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "model": "claude-fable-5",
  "content": [
    { "type": "text", "text": "Waves fold into foam..." }
  ],
  "stop_reason": "end_turn",
  "usage": { "input_tokens": 14, "output_tokens": 23 }
}

トークンカウント

POST/v1/messages/count_tokens

送信前にメッセージの入力トークン数を見積もります。リクエストボディは Messages と同じです（max_tokens は不要）。カウント自体にモデル利用料はかかりません。

count_tokens.sh
curl https://api.soleapi.com/v1/messages/count_tokens \
  -H "x-api-key: $SOLEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "messages": [{"role": "user", "content": "Write a haiku about the sea"}]
  }'

# => { "input_tokens": 14 }