コア
API リファレンス
エンドポイント、認証、レスポンスヘッダー、およびエラー
概要
TokenLab は、OpenAI 互換エンドポイントに加え、Anthropic および Gemini のリクエスト形式をサポートしています。既存の OpenAI クライアントは /v1 を使用できます。別の形式を選択するのは、アプリケーションがその API 特有の動作を必要とする場合に限定してください。POST /v1/responses はオプションであり、モデルのサポート状況に依存します。
ベース URL
https://api.tokenlab.sh認証
モデルへのリクエストには TokenLab API キーを使用します。標準的な認証ヘッダーは以下の通りです。
Authorization: Bearer sk-your-api-keyGET /v1/models、GET /v1/models/{model}、GET /v1/models/{model}/pricing、および GET /v1/pricing は公開されており、キーは不要です。Anthropic Messages は x-api-key も受け付けます。Gemini は Bearer 認証に加えて x-goog-api-key または ?key= も受け付けます。/v1/management/* には管理用トークン (mt-...) が必要です。
API キーは コンソール から取得してください。
配信ポリシー
生成リクエストは 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 になります。同じリクエストをそのまま繰り返さないでください。
リクエストフォームを備えた API ページは、お客様の TokenLab API キーを受け付け、実際のリクエストを送信します。これらのリクエストは、お客様のアカウント残高と制限を使用します。cURL、Postman、または SDK を使用することも可能です。
サポートされているエンドポイント
チャットおよびテキスト生成
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/chat/completions | POST | OpenAI 互換チャット補完 |
/v1/messages | POST | Anthropic 互換メッセージ |
/v1/messages/count_tokens | POST | Messages リクエストの入力トークン数をカウント |
/v1/messages/batches | POST, GET | メッセージバッチの作成 および 一覧表示 |
/v1/messages/batches/{message_batch_id} | GET, DELETE | メッセージバッチの取得 または 削除 |
/v1/messages/batches/{message_batch_id}/results | GET | 結果の読み取り |
/v1/messages/batches/{message_batch_id}/cancel | POST | メッセージバッチのキャンセル |
/v1/responses | POST | OpenAI Responses API |
/v1/responses/{id} | GET, DELETE | 保存されたレスポンスの取得 または 削除 |
/v1/responses/compact | POST | Responses 会話のコンテキストを圧縮 |
/v1/translations | POST | テキスト間翻訳 |
エンベディングおよびリランク
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/embeddings | POST | テキストエンベディングの作成 |
/v1/multimodal/embeddings | POST | マルチモーダルエンベディングモデルによるエンベディング作成 |
/v1/rerank | POST | ドキュメントのリランク |
意思決定
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/systemone | POST | 型指定された意思決定の質問を評価 |
ファイルおよびバッチ
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/files | POST, GET | ファイルのアップロード および 一覧表示 |
/v1/files/{file_id} | GET, DELETE | ファイルの取得 または 削除 |
/v1/files/{file_id}/content | GET | ファイルコンテンツのダウンロード |
/v1/batches | POST, GET | バッチの作成 および 一覧表示 |
/v1/batches/{batch_id} | GET | バッチの取得 |
/v1/batches/{batch_id}/cancel | POST | バッチのキャンセル |
画像
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/images/generations | POST | テキストから画像を生成 |
/v1/images/edits | POST | 画像を編集 |
/v1/images/variations | POST | 画像のバリエーションを作成 |
/v1/images/generations/{id} | GET | タスクベースの画像レスポンス用互換性ステータスパス |
画像モデルは、完成した画像または非同期タスクを返す場合があります。レスポンスに status: "pending" またはタスク ID が含まれている場合は、GET /v1/tasks/{id} をポーリングしてください。
音声
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/audio/speech | POST | テキスト読み上げ (TTS) |
/v1/audio/transcriptions | POST | 音声認識 (STT) |
/v1/audio/translations | POST | 音声を英語テキストに翻訳 |
リアルタイム
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/realtime?model={model} | WS | リアルタイム WebSocket セッション |
WebSocket アップグレードには /v1/realtime を使用してください。通常の GET /v1/realtime はエンドポイントのメタデータを返します。これは OpenAI Realtime REST サーフェスではありません。client-secret、Calls、およびレガシーなベータセッションエンドポイントは利用できません。
動画
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/videos/generations | POST | 動画生成タスクの作成 |
/v1/videos/generations/{id} | GET | 互換性ステータスパス |
/v1/videos/assets | POST, GET | Seedance マテリアルアセットの作成および一覧表示 |
/api/v3/contents/generations/tasks | POST, GET | Volcengine リクエスト形式による Seedance タスク |
タスク id を指定して GET /v1/tasks/{id} をポーリングしてください。/v1/videos/generations/{id} は既存の統合のために引き続き利用可能です。
非同期タスク
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/tasks/{id} | GET | あらゆる非同期タスクのステータス |
/v1/tasks/{id} | DELETE | 非同期タスクのキャンセル |
画像、動画、音楽、3D、Worlds、および非同期音声文字起こしなど、すべての非同期タスクに対して GET /v1/tasks/{id} をポーリングしてください。作成レスポンスに含まれる id または task_id を使用します。Worlds の作成レスポンスは /v1/worlds/generations/{id} 配下に poll_url を返します。そこでも /v1/tasks/{id} をポーリングしてください。このページにあるモダリティごとのステータスパスは、既存の統合のための互換性エンドポイントです。
音楽
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/music/generations | POST | 音楽生成タスクの作成 |
/v1/music/generations/{id} | GET | 互換性ステータスパス |
3D 生成
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/3d/generations | POST | 3D モデル生成タスクの作成 |
/v1/3d/generations/{id} | GET | 互換性ステータスパス |
Worlds
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/worlds/generations | POST | ワールド生成タスクの作成 |
/v1/worlds/list | POST | ワールドの一覧表示 |
/v1/worlds/{id} | GET, DELETE | ワールドの取得または削除 |
/v1/worlds/media-assets/prepare-upload | POST | メディアアセットアップロードの準備 |
モデルおよび価格
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1/models | GET | 利用可能な全モデルの一覧表示 |
/v1/models/{model} | GET | 特定のモデル情報の取得 |
/v1/models/{model}/pricing | GET | 1つのモデルの価格取得 |
/v1/pricing | GET | モデル価格の一覧表示 |
Gemini (v1beta)
ネイティブ Google Gemini API 形式のサポート:
| エンドポイント | メソッド | 説明 |
|---|---|---|
/v1beta/models | GET | Gemini リクエストを受け付けるモデルの一覧表示 |
/v1beta/models/{model} | GET | モデルの取得 |
/v1beta/models/{model}:generateContent | POST | コンテンツの生成 |
/v1beta/models/{model}:streamGenerateContent | POST | コンテンツのストリーム生成 |
/v1beta/models/{model}:countTokens | POST | トークン数のカウント |
/v1beta/files, /v1beta/cachedContents | POST, GET, DELETE | Gemini ファイルおよびキャッシュされたコンテンツ |
Gemini エンドポイントは、標準の Bearer トークンに加え、?key= クエリパラメータ認証をサポートしています。
管理
/v1/management/* は、管理用トークンを使用して残高、API キー、および Webhook を管理します。管理 API を参照してください。
レスポンス形式
各エンドポイントはそれぞれの API 形式を保持します。以下の成功およびエラーの例では、Chat Completions 形式を使用しています。
成功レスポンス
{
"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
}
}レスポンスヘッダー
これらのヘッダーが存在する場合は使用してください。
| ヘッダー | 説明 |
|---|---|
X-Request-ID | サポートおよびデバッグ用のリクエスト識別子 |
X-Routing-Time-MS | 非ストリーミング: アップストリームが応答するまでの合計時間(ミリ秒、アップストリームのキューイングと推論を含む)。ストリーミング: 常に 0。キューイングやルーティングの判断には使えません。 |
X-Task-ID | タスクベースのレスポンス用の公開非同期タスク識別子 |
X-Billing-Transaction-ID | 最終請求後の請求トランザクション識別子 |
公式のリクエスト拒否には、サービスが報告したエラーと公開サービス名を含む upstream が含まれる場合があります。API エラーの処理 を参照してください。
エラーレスポンス
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}レート制限
制限はアカウント階層に依存し、API キーごとに適用されます。429 レスポンスには Retry-After、X-RateLimit-Limit、X-RateLimit-Remaining、および X-RateLimit-Reset が含まれます。階層と再試行方法については レート制限 を参照してください。
OpenAPI 仕様
OpenAPI Spec
完全な OpenAPI 3.1 仕様をダウンロード