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

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.

​
APIキー

すべての TokenLab API リクエストには API key が必要です。 OpenAI 互換エンドポイントでは、次のように送信します: 
Authorization: Bearer sk-your-api-key
Anthropic 互換の /v1/messages リクエストでは、次も使用できます: 
x-api-key: sk-your-api-key

​
API Key の取得

  1. TokenLab Dashboard にログインします
  2. API Keys を開きます
  3. 新しい key を作成します
  4. わかりやすい名前を付けます
  5. 表示されるのは一度だけなので、すぐにコピーします
  • API key をクライアントサイドのコードに決して公開しないでください
  • API key をバージョン管理に決してコミットしないでください
  • 環境変数または secret manager を使用してください
  • 定期的に key をローテーションしてください
  • 使用していない key は削除してください

​
API Key の使用

curl https://api.tokenlab.sh/v1/responses \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "Hello!"
  }'

​
API Key の機能

​
使用制限

各 API key に使用制限を設定できます:
設定説明
No Limit制限なしで アカウント balance を使用して key が動作します
Fixed Limit指定した金額に達すると key は動作を停止します

​
キープレフィックス

すべての TokenLab API key は sk- で始まります。

​
Anthropic 互換性

/v1/messages エンドポイントでは、Anthropic スタイルのヘッダーは想定どおりに動作します: 
curl 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,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
/v1/responses、/v1/chat/completions、/v1/models、およびその他のほとんどの TokenLab ルートなどの OpenAI 互換エンドポイントでは、Authorization: Bearer ... を使用してください。

​
エラーレスポンス

ステータスコード型コード説明
401invalid_api_keyinvalid_api_keyAPI key が存在しないか無効です
401expired_api_keyexpired_api_keyAPI key は失効しています
402insufficient_balanceinsufficient_balanceアカウント balance が不足しています
402quota_exceededquota_exceededAPI key の使用制限に達しました
例: 
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}