Skip to main content

概要

このエンドポイントは、Anthropic Messages API とのネイティブ互換性を提供します。extended thinking などの機能を備えた Claude モデルにはこれを使用してください。 このエンドポイントは Anthropic のネイティブ契約を維持します。messagesuser / assistant メッセージの配列である必要があり、system はトップレベルの system フィールドに置き、max_tokens は必須です。messages 内で OpenAI の systemdevelopertool などの role を使う payload は /v1/chat/completions に送ってください。
Anthropic SDK の Base URL: https://api.tokenlab.sh/v1 サフィックスなし)

リクエストヘッダー

string
必須
あなたの TokenLab API key です。Bearer token の代替として使用できます。
string
必須
Anthropic API version。2023-06-01 を使用してください。

リクエストボディ

string
必須
Claude モデル ID(例: claude-sonnet-4-6 または claude-opus-4-6)。
array
必須
rolecontent を持つ message object の配列。
integer
必須
生成する最大 token 数。
string
System prompt(messages 配列とは別)。
number
デフォルト:"1"
Sampling temperature(0-1)。
boolean
デフォルト:"false"
ストリーミングレスポンスを有効にします。
object
Extended thinking の設定(Claude Opus 4.5)。
  • type (string): 有効化するには "enabled"
  • budget_tokens (integer): thinking 用の token 予算
array
モデルで利用可能なツール。
object
モデルがツールをどのように使用すべきか。オプション: autoanytool(特定のツール)。
number
Nucleus sampling パラメータ。temperature または top_p のいずれか一方のみを使用し、両方は使用しないでください。
integer
各 token について上位 K 個の選択肢からのみサンプリングします。
array
モデルの生成を停止させるカスタム stop sequence。
object
トラッキング目的でリクエストに付加する metadata。

レスポンス

string
一意のメッセージ識別子。
string
常に message
string
常に assistant
array
content block(text、thinking、tool_use)の配列。
string
使用されたモデル。
string
生成が停止した理由(end_turnmax_tokenstool_use)。
object
input_tokensoutput_tokens を含む token 使用量。

ビジョン入力の例

画像対応の Claude モデルでは、画像を messages[].content 内に構造化された画像ブロックとして配置してください。

Extended Thinking の例

Anthropic メッセージバッチ

TokenLab では /v1/messages に加えて、Anthropic Message Batches のネイティブフローも提供しています。 利用できるルート:
  • POST /v1/messages/batches
  • GET /v1/messages/batches
  • GET /v1/messages/batches/:message_batch_id
  • GET /v1/messages/batches/:message_batch_id/results
  • POST /v1/messages/batches/:message_batch_id/cancel
  • DELETE /v1/messages/batches/:message_batch_id
運用メモ:
  • 同じ TokenLab API key と Anthropic ネイティブヘッダーを使用してください。
  • batch item が file_id を参照する場合は、anthropic-beta: files-api-2025-04-14 も付けてください。
  • Batch job は Anthropic ネイティブのリクエスト/レスポンス形式を維持しつつ、TokenLab 側で内部の精算ライフサイクルを追跡します。