概要
TokenLab は native-first かつ OpenAI 互換 です。ネイティブな挙動が必要な場合は、Anthropic ではPOST /v1/messages のような provider-native のルートを、Gemini では /v1beta/models/...:generateContent を使用してください。既存の OpenAI 形式の SDK やツールを移行している場合は、OpenAI 互換 な /v1 エンドポイントを使用してください。POST /v1/responses は、Responses 固有の動作向けの上級者向けオプション経路のままです。
ベースURL
認証
すべてのAPIエンドポイントは Bearer トークンによる認証が必要です:サポートされているエンドポイント
チャットとテキスト生成
埋め込み & 再ランク
画像
一部の画像モデルは結果をインラインで返す場合があり、また別のものはタスクベースのレスポンスを返します。ルーティングされたプロバイダパスによってはどちらの挙動もあり得ます。create レスポンスに
poll_url が含まれている場合は、それに従ってください。音声
リアルタイム
/v1/realtime は WebSocket アップグレード要求に使用します。通常の GET /v1/realtime は、WebSocket ルートを直接確認できないクライアント向けにエンドポイントメタデータを返します。これは OpenAI Realtime REST 面ではありません。client secret、translation client secret、Calls、legacy beta session エンドポイントは現在公開していません。動画
新しいクライアントの場合は
/v1/tasks/{id} を優先し、create レスポンスで返される poll_url に従ってください。/v1/videos/generations/{id} は後方互換性のために残してください。非同期タスク
このエンドポイントは動画、音楽、3D に限定されません。一部の画像タスクも標準的なポーリングパスとして
/v1/tasks/{id} を使用する場合があります。音楽
新しいクライアントの場合は、まず返却された
poll_url を優先してください。固定のタスクステータスエンドポイントが必要な場合は /v1/tasks/{id} を使用し、音楽専用の互換パスとして /v1/music/generations/{id} を維持してください。3D生成
新しいクライアントの場合は、まず返却された
poll_url を優先してください。固定のタスクステータスエンドポイントが必要な場合は /v1/tasks/{id} を使用し、3D専用の互換パスとして /v1/3d/generations/{id} を維持してください。モデル
Gemini (v1beta)
ネイティブな Google Gemini API フォーマットのサポート:Gemini エンドポイントは、標準の Bearer トークンに加え
?key= クエリパラメータによる認証をサポートします。レスポンス形式
すべてのレスポンスは一貫した形式に従います:成功レスポンス
ルーティングの透明性
すべてのレスポンスにはチャンネル情報を含む_routing フィールドが含まれます:
エラーレスポンス
レート制限
レート制限はロールベースで、管理者により設定可能です。デフォルト値:カスタムのレート制限についてはサポートにお問い合わせください。正確な値はアカウント設定により異なる場合があります。
429 ステータスコードを返し、待機時間を示す Retry-After ヘッダーが付与されます。
OpenAPI 仕様
OpenAPI仕様
OpenAPI 3.0 の完全な仕様をダウンロード