コアガイド
請求と価格
料金、見積もり、残高、制限の仕組み
TokenLabの残高は、すべてのモデルで共通して使用できます。サブスクリプションや最低利用料金はありません。チャージ(入金)は5ドルから可能です。料金は、各リクエストで記録されたモデルと使用量に基づいて計算されます。
配信オプション
同一のモデルとAPIは、2つのルートを通じて利用可能です。Verifiedは低コストで、Officialはより信頼性が高いという特徴があります。配信オプションによって、どのルートでリクエストを実行し、どの価格を支払うかが決まります。
| オプション | ルート | 価格 | ルートが利用できない場合 |
|---|---|---|---|
Verified | Verifiedのみ:TokenLabがテストしたルート | Verified価格(ほとんどのモデルでOfficial価格より安価) | リクエストは失敗し、課金されません |
Official | Officialのみ:モデル作成者または主要プラットフォーム | Official価格(モデル作成者が公開している価格) | リクエストは失敗し、課金されません |
Auto (デフォルト) | まずVerifiedを試行。Verifiedに供給がない、または出力前に失敗した場合はOfficialで1回実行 | リクエストを完了したルートの価格 | Officialでリクエストを実行 |
Modelsページでは、各モデルの双方の価格を確認できます。
- 完了した各リクエストに対して1回課金されます。
- Autoは、出力が開始された後やタスクが受け付けられた後にルートを切り替えることはありません。
- 実行前、Autoは2つの可能な金額のうち高い方を確保します。残高がVerifiedの見積もり分しかない場合、Autoはそのリクエストに対してVerifiedのみを実行し、Officialへのフォールバックは行いません。実行後、実際の料金が差し引かれ、残額は解放されます。
- リクエストヘッダー
X-TokenLab-Delivery-PolicyはAPIキーの設定を上書きし、APIキーの設定はワークスペースのデフォルト設定を上書きします。APIの紹介を参照してください。
有料生成の場合、Consoleでは確認前に最大見積額が表示されます。完了後、RunsおよびUsageにて最終的な請求額とリクエストを完了したオプションが表示されます。
価格モデル
モデルの価格は変更される可能性があります。現在の価格については、Console、Modelsページ、GET /v1/models/:model/pricing、またはPricing APIを確認してください。
Modelsページにおいて、Verified価格または割引列のダッシュ(-)は、現在Verifiedの提供がないことを意味します(無料という意味ではありません)。Officialの供給があるモデルは、引き続きOfficialまたはAutoを通じて利用可能です。APIにおいて、そのようなモデルのVerified価格フィールドは null または省略され、official_* 価格フィールドに支払額が表示されます。配信ラベルはサポートされているオプションを表し、可用性は各リクエストの実行時にチェックされます。シリーズ価格は、関連する配信オプションで供給があるモデルをまとめ、異なる課金単位を個別に管理します。
トークンベースの価格設定
ほとんどのチャット、推論、埋め込み(embedding)、再ランク(rerank)、および一部の画像モデルは、入力、出力、キャッシュ、または画像出力トークンに基づいて価格が設定されます。
| 価格体系 | 例 | 現在の価格の確認方法 |
|---|---|---|
| チャット / 回答 | gpt-5.4, claude-sonnet-4-6, gemini-3.6-flash | ModelsページまたはPricing API |
| 埋め込み / 再ランク | text-embedding-3-small, qwen3-vl-rerank | モデルの価格詳細 |
| トークン課金型画像 | gpt-image-2 | GET /v1/models/gpt-image-2/pricing |
コピーした価格表をハードコードしないでください。アプリケーションでコストを表示または比較する必要がある場合は、その都度現在の価格を取得してください。
ツール利用料
一部の組み込みツールは、トークン料金に加えて追加料金が発生します。TokenLabは、モデルがツールを使用し、その旨がレスポンスで報告された場合にのみツール利用料を請求します。ツールを提供してもモデルがそれを使用しなかったリクエストには、ツール利用料は発生しません。
| ツール | モデル | 料金 |
|---|---|---|
| Web検索 | OpenAI、Claude、Grokモデル、およびGoogle検索グラウンディングを備えたGemini 3モデル | モデルが実行する検索ごと。Gemini 3の場合は、一意の検索クエリごと |
| 検索グラウンディング | Google検索グラウンディングを備えたGemini 2.5モデル | 検索がグラウンディングされたリクエストごとに1回 |
- 各モデルには、トークン価格と同様に、VerifiedとOfficialそれぞれのツール利用料が設定されています。モデルの価格詳細には、Web search または Search grounding として表示されます。
- モデルが読み取った検索結果は、モデルの価格に基づいた入力トークンとして課金されます。
- モデル上で価格が設定されていないツールには課金されません。
- ConsoleのRunsでリクエストを開くと、Tool fees に呼び出し回数と各呼び出しの価格が表示されます。APIキーの使用状況レコードには、
charged_price_basis内に同じ値が記録されます(measure.dimensions.webSearchCallsまたはgroundedPromptsに回数、effectiveUnitPrices.webSearchまたはeffectiveUnitPrices.groundedPromptに各呼び出しの価格)。
プロンプトキャッシュ
モデルは、プロンプトの繰り返し部分をキャッシュから読み取ることができます。キャッシュから読み取られたトークンは、通常の入力トークンよりも低コストです。
- GPT、Gemini、およびその他のいくつかのモデルは、長く繰り返されるプロンプトを自動的にキャッシュします。設定は不要です。
- Claudeモデルは、要求した場合のみキャッシュします。Chat Completionsリクエストで
"anthropic_options": {"prompt_caching": true}を送信してください。TokenLabは、システムプロンプトの末尾と最新のユーザーメッセージをキャッシュポイントとしてマークします。Messages APIを使用する場合は、ブロックにcache_controlを自身で追加してください。
| 料金 | 入力価格との比較 |
|---|---|
| キャッシュ書き込み、5分(デフォルト) | 高い |
キャッシュ書き込み、1時間 ("prompt_caching_ttl": "1h") | 5分書き込みより高い |
| キャッシュ読み取り | 低い |
- キャッシュ価格はモデルや配信オプションによって異なります。比率に依存する前に、ModelsページまたはPricing APIでモデルのキャッシュ価格を確認してください。
- 決して繰り返されないプロンプトは、キャッシュ書き込みが発生するため、キャッシュを有効にするとわずかにコストが高くなります。
- モデルの最小キャッシュ可能長より短いプロンプトはキャッシュされず、キャッシュ書き込み料金も発生しません。
- 1時間のキャッシュはすべてのモデルで利用できるわけではありません。モデルに記載がない場合は、5分キャッシュを使用してください。
- レスポンスには結果が表示されます。
usage.prompt_tokens_details.cached_tokensはキャッシュから読み取られたトークン数です。usage.cache_creation_input_tokensは書き込まれたトークン数であり、ゼロより大きい場合にのみ表示されます。
サービスティア
TokenLabは標準サービスティアでリクエストを実行・課金します。service_tier の値として auto および default が受け入れられます。flex、priority、fast、ultrafast などの他の値は無視され、リクエストは標準ティアで実行され、標準価格が適用されます。
リクエストおよびタスクの価格設定
画像、動画、音楽、3D、音声、およびワールドモデルは、リクエスト、画像、秒、分、またはタスク単位で価格が設定される場合があります。モデルページに課金単位が表示されます。
| 体系 | 例 |
|---|---|
| 画像 | flux-pro-1.1 |
| 動画 | veo3.1, seedance-2.0 |
| 音楽 | suno-music |
| 3D | tripo-h3.1 |
| 音声 | grok-tts, whisper-large-v3 |
非同期タスクの課金
一部のタスクは、作成時に見積もりコストを予約します。完了したタスクは1回課金され、失敗したタスクは保留中の金額を解放または返金します。
動画、音楽、3D、およびタスクベースの画像生成は、タスクIDと poll_url を返します。最終的な金額は、タスクが completed または failed になった後に記録されます。完了したタスクには課金後に billing_transaction_id が含まれます。失敗したタスクには課金されません。
タスク終了後もUsageに最終的な請求額や解放額が表示されない場合は、リクエストIDとタスクIDを添えて hello@tokenlab.sh までお問い合わせください。
課金トランザクションID
ストリーミングではないOpenAI互換のレスポンスには、レスポンス送信前に課金が完了した場合、billing_transaction_id が含まれます。同じ値が X-Billing-Transaction-ID に表示される場合があります。Geminiやその他のネイティブ形式では、このヘッダーでのみ公開されることがあります。
非同期タスクには、完了後に billing_transaction_id が含まれます。ストリーミングは課金完了前に終了する場合があるため、ヘッダーがない場合はUsageを使用してください。
トークンカウント
テキストモデルは通常、usage 内に入力、出力、および合計トークン数を報告します。トークン化はモデル、言語、メディア入力によって異なるため、文字数計算式は信頼できる課金見積もりにはなりません。モデルの現在の価格と最終的なUsageレコードを使用してください。
使用状況の確認
Usage を開いて以下を確認できます:
- リアルタイム残高
- モデル別の使用履歴
- コストの内訳
- APIキーの使用状況
APIレスポンス
トークンベースのレスポンスには、通常、使用状況情報が含まれます:
{
"usage": {
"prompt_tokens": 50,
"completion_tokens": 100,
"total_tokens": 150
}
}コスト削減
残高不足アラート
Console → Settings でしきい値を設定してください。残高がそれを下回ると、TokenLabからメールが送信されます。
残高の追加
Console → Billing を開き、金額を選択して、チェックアウト時に表示される支払い方法のいずれかを使用してください。支払いプロバイダーが支払いを確定すると、残高が更新されます。
トライアルクレジットの提供期間中、対象となる新規アカウントは、最大10回の呼び出しに対して1回限りの 0.25ドル のトライアルクレジットを受け取ります。未使用のトライアルクレジットは7日後に失効します。
残高不足でリクエストが停止しないようにするには、Billingで Automatic funding を有効にしてください。これにより、残高が設定した金額を下回った場合に、月間上限まで自動的に資金が追加されます。
APIキーの制限
Console → API Keys でAPIキーを作成または編集する際に、利用制限を設定できます。
制限に達すると、そのキーを使用したリクエストは 402 コード quota_exceeded を返します。継続するには、制限を引き上げるか削除してください。
課金に関するヘルプ
課金に関するお問い合わせは hello@tokenlab.sh までご連絡ください。