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

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.

​
概要

TokenLab は native-first かつ OpenAI 互換 です。ネイティブな挙動が必要な場合は、Anthropic では POST /v1/messages のような provider-native のルートを、Gemini では /v1beta/models/...:generateContent を使用してください。既存の OpenAI 形式の SDK やツールを移行している場合は、OpenAI 互換 な /v1 エンドポイントを使用してください。POST /v1/responses は、Responses 固有の動作向けの上級者向けオプション経路のままです。

​
ベースURL

https://api.tokenlab.sh

​
認証

すべてのAPIエンドポイントは Bearer トークンによる認証が必要です: 
Authorization: Bearer sk-your-api-key
APIキーはダッシュボードから取得してください。
Interactive Playground について: このドキュメントサイト上のプレイグラウンドはデモ目的のみで提供されており、APIキーの入力には対応していません。APIをテストするには、次のいずれかを使用してください:
  • cURL - サンプルコマンドをコピーし、sk-your-api-key を実際のキーに置き換えてください
  • Postman - 当社のOpenAPI仕様をインポートしてください
  • SDK - 当社のベースURLを使用して OpenAI/Anthropic SDK を利用してください

​
サポートされているエンドポイント

​
チャットとテキスト生成

エンドポイントメソッド説明
/v1/chat/completionsPOSTOpenAI互換のチャット補完
/v1/messagesPOSTAnthropic互換のメッセージAPI
/v1/responsesPOSTOpenAI Responses API

​
埋め込み & 再ランク

エンドポイントメソッド説明
/v1/embeddingsPOSTテキスト埋め込みを作成
/v1/rerankPOSTドキュメントを再ランク

​
画像

エンドポイントメソッド説明
/v1/images/generationsPOSTテキストから画像を生成
/v1/images/editsPOST画像を編集
/v1/images/generations/{id}GETタスクベースの画像レスポンス向けの画像タスクステータスパス
一部の画像モデルは結果をインラインで返す場合があり、また別のものはタスクベースのレスポンスを返します。ルーティングされたプロバイダパスによってはどちらの挙動もあり得ます。create レスポンスに poll_url が含まれている場合は、それに従ってください。

​
音声

エンドポイントメソッド説明
/v1/audio/speechPOSTテキスト読み上げ（TTS）
/v1/audio/transcriptionsPOST音声からテキスト（STT）

​
動画

エンドポイントメソッド説明
/v1/videos/generationsPOST動画生成タスクを作成
/v1/tasks/{id}GET動画ジョブの非同期タスクステータスを取得
/v1/videos/generations/{id}GETレガシー互換の動画タスクステータスパス
新しいクライアントの場合は /v1/tasks/{id} を優先し、create レスポンスで返される poll_url に従ってください。/v1/videos/generations/{id} は後方互換性のために残してください。

​
非同期タスク

エンドポイントメソッド説明
/v1/tasks/{id}GET統一された非同期タスクステータスのエンドポイント。返された poll_url をたどる場合に推奨
このエンドポイントは動画、音楽、3D に限定されません。一部の画像タスクも標準的なポーリングパスとして /v1/tasks/{id} を使用する場合があります。

​
音楽

エンドポイントメソッド説明
/v1/music/generationsPOST音楽生成タスクを作成
/v1/music/generations/{id}GET音楽専用のステータスパス
新しいクライアントの場合は、まず返却された poll_url を優先してください。固定のタスクステータスエンドポイントが必要な場合は /v1/tasks/{id} を使用し、音楽専用の互換パスとして /v1/music/generations/{id} を維持してください。

​
3D生成

エンドポイントメソッド説明
/v1/3d/generationsPOST3Dモデル生成タスクを作成
/v1/3d/generations/{id}GET3D専用のステータスパス
新しいクライアントの場合は、まず返却された poll_url を優先してください。固定のタスクステータスエンドポイントが必要な場合は /v1/tasks/{id} を使用し、3D専用の互換パスとして /v1/3d/generations/{id} を維持してください。

​
モデル

エンドポイントメソッド説明
/v1/modelsGET利用可能なモデルをすべて一覧表示
/v1/models/{model}GET特定モデルの情報を取得

​
Gemini (v1beta)

ネイティブな Google Gemini API フォーマットのサポート:
エンドポイントメソッド説明
/v1beta/models/{model}:generateContentPOSTコンテンツを生成（Geminiフォーマット）
/v1beta/models/{model}:streamGenerateContentPOSTストリームでコンテンツを生成（Geminiフォーマット）
Gemini エンドポイントは、標準の Bearer トークンに加え ?key= クエリパラメータによる認証をサポートします。

​
レスポンス形式

すべてのレスポンスは一貫した形式に従います:

​
成功レスポンス

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [...],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 20,
    "total_tokens": 30
  }
}

​
ルーティングの透明性

すべてのレスポンスにはチャンネル情報を含む _routing フィールドが含まれます: 
{
  "id": "chatcmpl-abc123",
  ...,
  "_routing": {
    "channel": {
      "id": "ch_xxx",
      "name": "channel-name",
      "provider": "openai",
      "channelType": "PLATFORM"
    },
    "cached": false,
    "retryCount": 0
  }
}
フィールド説明
channel.id使用されたチャンネルの識別子
channel.provider上流プロバイダー（openai、anthropic など）
channel.channelTypePLATFORM（TokenLab）または PRIVATE（BYOK）
cachedレスポンスがキャッシュから提供されたかどうか
retryCountリトライ試行回数（存在する場合）

​
エラーレスポンス

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

​
レート制限

レート制限はロールベースで、管理者により設定可能です。デフォルト値:
ロールリクエスト/分
ユーザー60
パートナー300
VIP1,000
カスタムのレート制限についてはサポートにお問い合わせください。正確な値はアカウント設定により異なる場合があります。
レート制限を超えた場合、API は 429 ステータスコードを返し、待機時間を示す Retry-After ヘッダーが付与されます。

​
OpenAPI 仕様

OpenAPI仕様

OpenAPI 3.0 の完全な仕様をダウンロード