API リファレンス

概要Copy Anchor Link

TokenLab は、OpenAI 互換エンドポイントに加え、Anthropic および Gemini のリクエスト形式をサポートしています。既存の OpenAI クライアントは /v1 を使用できます。別の形式を選択するのは、アプリケーションがその API 特有の動作を必要とする場合に限定してください。POST /v1/responses はオプションであり、モデルのサポート状況に依存します。

ベース URLCopy Anchor Link

https://api.tokenlab.sh

認証Copy Anchor Link

モデルへのリクエストには TokenLab API キーを使用します。標準的な認証ヘッダーは以下の通りです。

Authorization: Bearer sk-your-api-key

GET /v1/models、GET /v1/models/{model}、および GET /v1/pricing は公開されており、キーは不要です。Anthropic Messages は x-api-key も受け付けます。Gemini は Bearer 認証に加えて x-goog-api-key または ?key= も受け付けます。/v1/management/* には管理用トークン (mt-...) が必要です。

API キーは コンソール から取得してください。

配信ポリシーCopy Anchor Link

生成リクエストは X-TokenLab-Delivery-Policy: auto | verified | official を受け付けます。リクエストヘッダーは API キーの設定を上書きし、API キーの設定はワークスペースのデフォルト設定を上書きします。

• Auto: 利用可能な場合は TokenLab Verified を使用し、必要に応じて Official を使用します。リクエストを完了したオプションに対して料金が発生します。
• TokenLab Verified: TokenLab によって配信が検証されます。Verified 価格が適用されます。
• Official: Official 価格（モデル提供元の公開価格）で課金されます。
• リアルタイムセッションは API キーまたはワークスペース設定を使用し、クエリ文字列による上書きは受け付けません。

無効なヘッダーは 400 を返します。要求されたオプションが利用できない場合、TokenLab は 503 delivery_tier_unavailable とリクエスト ID を返します。retryable を確認してください。選択した操作に供給がない場合、値は false になります。同じリクエストをそのまま繰り返さないでください。

サポートされているエンドポイントCopy Anchor Link

チャット & テキスト生成Copy Anchor Link

エンベディング & リランクCopy Anchor Link

画像Copy Anchor Link

オーディオCopy Anchor Link

リアルタイムCopy Anchor Link

動画Copy Anchor Link

非同期タスクCopy Anchor Link

音楽Copy Anchor Link

3D 生成Copy Anchor Link

モデルCopy Anchor Link

Gemini (v1beta)Copy Anchor Link

ネイティブ Google Gemini API 形式のサポート:

レスポンス形式Copy Anchor Link

各エンドポイントはそれぞれの API 形式を保持します。以下の成功およびエラーの例では、チャット補完形式を使用しています。

成功レスポンスCopy Anchor Link

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-5.6-terra",
  "choices": [{"index": 0, "message": {"role": "assistant", "content": "Hello!"}, "finish_reason": "stop"}],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

リクエスト識別子Copy Anchor Link

公式のリクエスト拒否には、サービスが報告したエラーと公開サービス名を含む upstream が含まれる場合があります。プライベートな配信詳細や認証情報は、公開レスポンス契約の一部ではありません。API エラーの処理 を参照してください。公開されているヘッダーが存在する場合は、以下のヘッダーを使用してください。

エラーレスポンスCopy Anchor Link

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

レート制限Copy Anchor Link

レート制限はロールベースであり、管理者によって設定可能です。デフォルト値は以下の通りです。

レート制限を超過した場合、API は 429 ステータスコードと、待機時間を示す Retry-After ヘッダーを返します。

OpenAPI 仕様Copy Anchor Link