メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
概要

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

​
リクエストヘッダー

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

​
リクエストボディ

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

​
レスポンス

​
id
string
一意のメッセージ識別子。
​
type
string
常に message。
​
role
string
常に assistant。
​
content
array
content block（text、thinking、tool_use）の配列。
​
model
string
使用されたモデル。
​
stop_reason
string
生成が停止した理由（end_turn、max_tokens、tool_use）。
​
usage
object
input_tokens と output_tokens を含む token 使用量。
curl -X POST "https://api.tokenlab.sh/v1/messages" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "system": "You are a helpful assistant.",
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

{
  "id": "msg_abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I help you today?"
    }
  ],
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 15,
    "output_tokens": 10
  }
}

​
ビジョン入力の例

画像対応の Claude モデルでは、画像を messages[].content 内に構造化された画像ブロックとして配置してください。 
{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Please describe this image."
        },
        {
          "type": "image",
          "source": {
            "type": "url",
            "url": "https://example.com/demo.jpg"
          }
        }
      ]
    }
  ]
}

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Please describe this image."
        },
        {
          "type": "image",
          "source": {
            "type": "base64",
            "media_type": "image/jpeg",
            "data": "/9j/4AAQSkZJRgABAQ..."
          }
        }
      ]
    }
  ]
}

​
Extended Thinking の例

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=16000,
    thinking={
        "type": "enabled",
        "budget_tokens": 10000
    },
    messages=[{"role": "user", "content": "Solve this math problem..."}]
)

for block in message.content:
    if block.type == "thinking":
        print(f"Thinking: {block.thinking}")
    elif block.type == "text":
        print(f"Response: {block.text}")

​
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 側で内部の精算ライフサイクルを追跡します。