コア

API リファレンス

エンドポイント、認証、レスポンスヘッダー、およびエラー

概要

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

ベース URL

https://api.tokenlab.sh

認証

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

Authorization: Bearer sk-your-api-key

GET /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/completionsPOSTOpenAI 互換チャット補完
/v1/messagesPOSTAnthropic 互換メッセージ
/v1/messages/count_tokensPOSTMessages リクエストの入力トークン数をカウント
/v1/messages/batchesPOST, GETメッセージバッチの作成 および 一覧表示
/v1/messages/batches/{message_batch_id}GET, DELETEメッセージバッチの取得 または 削除
/v1/messages/batches/{message_batch_id}/resultsGET結果の読み取り
/v1/messages/batches/{message_batch_id}/cancelPOSTメッセージバッチのキャンセル
/v1/responsesPOSTOpenAI Responses API
/v1/responses/{id}GET, DELETE保存されたレスポンスの取得 または 削除
/v1/responses/compactPOSTResponses 会話のコンテキストを圧縮
/v1/translationsPOSTテキスト間翻訳

エンベディングおよびリランク

意思決定

エンドポイントメソッド説明
/v1/systemonePOST型指定された意思決定の質問を評価

ファイルおよびバッチ

エンドポイントメソッド説明
/v1/filesPOST, GETファイルのアップロード および 一覧表示
/v1/files/{file_id}GET, DELETEファイルの取得 または 削除
/v1/files/{file_id}/contentGETファイルコンテンツのダウンロード
/v1/batchesPOST, GETバッチの作成 および 一覧表示
/v1/batches/{batch_id}GETバッチの取得
/v1/batches/{batch_id}/cancelPOSTバッチのキャンセル

画像

エンドポイントメソッド説明
/v1/images/generationsPOSTテキストから画像を生成
/v1/images/editsPOST画像を編集
/v1/images/variationsPOST画像のバリエーションを作成
/v1/images/generations/{id}GETタスクベースの画像レスポンス用互換性ステータスパス

画像モデルは、完成した画像または非同期タスクを返す場合があります。レスポンスに status: "pending" またはタスク ID が含まれている場合は、GET /v1/tasks/{id} をポーリングしてください。

音声

エンドポイントメソッド説明
/v1/audio/speechPOSTテキスト読み上げ (TTS)
/v1/audio/transcriptionsPOST音声認識 (STT)
/v1/audio/translationsPOST音声を英語テキストに翻訳

リアルタイム

エンドポイントメソッド説明
/v1/realtime?model={model}WSリアルタイム WebSocket セッション

WebSocket アップグレードには /v1/realtime を使用してください。通常の GET /v1/realtime はエンドポイントのメタデータを返します。これは OpenAI Realtime REST サーフェスではありません。client-secret、Calls、およびレガシーなベータセッションエンドポイントは利用できません。

動画

エンドポイントメソッド説明
/v1/videos/generationsPOST動画生成タスクの作成
/v1/videos/generations/{id}GET互換性ステータスパス
/v1/videos/assetsPOST, GETSeedance マテリアルアセットの作成および一覧表示
/api/v3/contents/generations/tasksPOST, GETVolcengine リクエスト形式による 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/generationsPOST音楽生成タスクの作成
/v1/music/generations/{id}GET互換性ステータスパス

3D 生成

エンドポイントメソッド説明
/v1/3d/generationsPOST3D モデル生成タスクの作成
/v1/3d/generations/{id}GET互換性ステータスパス

Worlds

エンドポイントメソッド説明
/v1/worlds/generationsPOSTワールド生成タスクの作成
/v1/worlds/listPOSTワールドの一覧表示
/v1/worlds/{id}GET, DELETEワールドの取得または削除
/v1/worlds/media-assets/prepare-uploadPOSTメディアアセットアップロードの準備

モデルおよび価格

エンドポイントメソッド説明
/v1/modelsGET利用可能な全モデルの一覧表示
/v1/models/{model}GET特定のモデル情報の取得
/v1/models/{model}/pricingGET1つのモデルの価格取得
/v1/pricingGETモデル価格の一覧表示

Gemini (v1beta)

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

エンドポイントメソッド説明
/v1beta/modelsGETGemini リクエストを受け付けるモデルの一覧表示
/v1beta/models/{model}GETモデルの取得
/v1beta/models/{model}:generateContentPOSTコンテンツの生成
/v1beta/models/{model}:streamGenerateContentPOSTコンテンツのストリーム生成
/v1beta/models/{model}:countTokensPOSTトークン数のカウント
/v1beta/files, /v1beta/cachedContentsPOST, GET, DELETEGemini ファイルおよびキャッシュされたコンテンツ

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 仕様をダウンロード

このページの内容