API エンドポイント
Tokener.ai モデル API の base URL と対応する OpenAI / Anthropic 互換パス。
対応するモデル API サーフェス(下記 base URL からの相対パス):
| 状態 | Method | Path | 用途 |
|---|---|---|---|
| 対応 | GET | /models | キーで利用可能かつ表示対象のモデル id を一覧 |
| 対応 | GET | /models?client_version=… | Codex リモートモデルピッカー |
| 対応 | GET | /models/user | Claude Code ゲートウェイモデルピッカー |
| 対応 | POST | /chat/completions | チャット / 推論モデル(主経路) |
| 対応 | POST | /embeddings | 埋め込みモデル |
| 対応 | POST | /rerank | 割り当てられたモデルでクエリに対する文書の順位を計算 |
| 対応 | POST | /audio/transcriptions | multipart フォームで送信した音声ファイルを文字に変換 |
| 対応 | POST | /audio/speech | 音声を生成し、バイナリ音声ストリームで返す |
| 対応 | POST | /messages | Anthropic Messages API 形式(Claude Code などのエージェント対応) |
| 対応 | POST | /messages/count_tokens | 生成を行わず Anthropic Messages リクエストの入力トークンを計算 |
| 対応 | POST | /responses | OpenAI Responses API(Codex などのエージェント対応) |
チャット系パスはストリーミング(stream: true)に対応します。利用可能なモデル、価格、可用性はライブの Models カタログに従い、ドキュメントには複製しません。
判定モデルは OpenAI / Anthropic 互換ではなく、/v1 の外で提供されます。判定 API を参照してください。
Rerank リクエストは model、query、documents を使用します。top_n と return_documents は省略できます。レスポンスの results は文書のインデックスと関連性スコアを含みます。割り当てられたモデル ID を指定してください。非表示モデルは、キーに権限があっても /models に表示されません。Rerank はストリーミングに対応しません。
文字起こしリクエストは multipart/form-data を使用し、model と file を含めます。音声生成リクエストは JSON を使用し、model、input、voice を含めます。音声生成に成功すると、音声バイトをストリーミングし、Content-Type を保持します。両方の音声パスは Tokener.ai API キーを使用します。モデル固有の形式と制限は引き続き適用されます。
トークン計数は Anthropic 形式の model、messages と、対応する system、
tools などを受け取ります。JSON レスポンスには input_tokens が含まれますが、
最終的な料金精算を示すものではありません。このパスはストリーミングを行わず、
/messages と同じ Tokener.ai API キーと Anthropic ヘッダーを使用します。
利用可否は選択したモデルとキーの権限に依存します。
Base URL
https://api-staging.tokener.dev/v1
上記の互換パスはこの base URL を使用します。OpenAI 互換エンドポイントと Anthropic 互換の /messages エンドポイントを提供します。ウェブサイトとコンソールは LLM をプロキシしません。Tokener.ai API キーは Bearer として、/messages では x-api-key としても送信できます。
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.TOKENER_API_KEY,
baseURL: "https://api.tokener.ai/v1",
});呼び出し前に API キー でキーを作成してください。
ネイティブ Gemini パス
同じ API オリジンに、/v1 を付けずに次のリクエストを送信できます。
POST /v1beta/models/{model}:generateContentPOST /v1beta/models/{model}:streamGenerateContent?alt=ssePOST /v1beta/models/{model}:countTokensPOST /v1beta/models/{model}:embedContentPOST /v1beta/models/{model}:batchEmbedContentsPOST /v1beta/interactions
公開モデル ID と Tokener.ai キーを Bearer または x-goog-api-key で指定し、
Google の上流キーは送信しないでください。クエリのキー、上流やデプロイの
上書きは拒否されます。Interactions はモデルの明示が必要で、エージェントと
previous interaction ID は未対応です。ネイティブ設定とキーの権限は引き続き
必要です。互換 API の利用可否はネイティブパラメーターの同等性を保証しません。
ネイティブ埋め込みは非ストリーミングで、gemini-embedding-001 のテキストと
gemini-embedding-2-preview のテキスト/PNG/JPEG に限定されます。
1リクエスト最大100項目・画像6枚で、通常のキー認可と入力のみの予算計算を使います。
これらのモデルパスはリソース管理 API を公開しません。エラーには
Google 形式を使用します。
生成レスポンスの continuationToken は不透明な値です。同じ org/キー、モデル、
生成操作とリクエスト設定で、返された値を変更せずに送信してください。
Google や別エンドポイントの token は代用できません。結果不明のリクエストを
独自に再試行しないでください。
Gemini Files リソース
Files 機能が有効な場合、同じ API オリジンで次の限定パスを利用できます。
POST /upload/v1beta/files
POST /upload/v1beta/files/{session-UUID}
GET /v1beta/files/{owned-token}
DELETE /v1beta/files/{owned-token}バイナリチャンクを含む毎回のリクエストに Tokener.ai org キーが必要です。 この API が返すアップロード URL と不透明な File 名/URI のみを使ってください。 リソースは元の org とキーに紐づきます。START は snake_case メタデータを使い、 チャンクには SDK のプロトコル、合計サイズ、MIME ヘッダーを保持します。 既知の Content-Length と identity エンコードが必要です。START は32KiB、 各チャンクは8MiBまでです。query にキーやプロバイダー URL を含めないでください。
最終アップロードは file ラッパー、GET は実際の処理状態を含む File を直接返します。 所有ファイルが無効または期限切れなら410になります。他のエラーを、再アップロードや 結果不明のモデル呼び出しの再試行許可として扱わないでください。ファイル一覧、 ダウンロード、登録、cached-content API と CountTokens のファイル参照は未対応です。
エージェントクライアント
コーディングエージェントはこれらのパスを直接利用できます。セットアップは
Codex(/responses)と
Claude Code(/messages)のガイドを参照して
ください。
すべてのレスポンス(成功・エラーいずれも)には x-request-id と
request-id ヘッダーが付与されます。サポートへ連絡する際はこの値を添えて
ください。ブラウザの CORS には対応していません。これらのパスはブラウザか
ら直接呼ばず、バックエンドから呼び出してください。エラーレスポンスの形状
と完全なエラーコード表は エラー を参照してくだ
さい。