本文へスキップ
本文へスキップ

ドキュメント / ガイド

機械翻訳されたページ

このページは自動翻訳のため、誤りや不自然な表現が含まれている可能性があります。正式な内容は英語版です。英語の原文を読む。

実行前に費用を見積もる

費用をかける前に翻訳の実行規模を見積もります。ドライランでキー数を数え、verbatra にリクエスト数、トークン、金額へ換算させ、承認した実行に上限を設けます。

実際のプロジェクトで初めて実行する前や、誰かの承認が必要な実行の前に使います。verbatra は価格を公開しません。単価はプロバイダーのものであり、予告なく変わるためです。verbatra が数えるのは課金の対象になる量で、プロバイダーの現在の単価を渡すと、それを金額に換算します。

一般的なプロジェクトで費用がかかるのは最初の実行だけです。次回以降は、変更されたキーしか送られないため、費用はほとんどかかりません。

作業量を数える

verbatra translate --dry-run
出力
verbatra translate (dry run)
  de: 400 would translate, 0 unchanged
  es: 400 would translate, 0 unchanged
  fr: 400 would translate, 0 unchanged
3 succeeded, 0 partial, 0 failed (dry run: nothing written)

would translate は、実際の実行が送るキーの数です。ターゲットファイルに欠落しているキーと、ソーステキストが変更されたキーの合計になります。ドライランはプロバイダーを生成せず、API キーも読み取らず、何も書き込みません。この数は上限として扱ってください。ドライランは、実際の実行なら重複する文字列を無料で返すキャッシュを使わず、同一のソース文字列も統合しません。実際の実行では、同一の文字列は 1 回だけ送られます。

費用を見積もる

verbatra translate --estimate
出力
verbatra translate (estimate)
  de: 400 would translate, 0 unchanged
  es: 400 would translate, 0 unchanged
  fr: 400 would translate, 0 unchanged
  estimate: 1200 keys in 24 requests, ~40944 input + ~30720 output tokens
  estimated spend: no rate on file for gemini/gemini-2.5-flash; add rates.table["gemini/gemini-2.5-flash"] to your config to see a currency figure
  estimate excludes: cache hits, duplicate source strings, provider-side retries, translation length, tokenizer differences, repair requests
3 succeeded, 0 partial, 0 failed (dry run: nothing written)

--estimate は --dry-run も有効にするため、費用はかかりません。プロバイダーの課金単位で報告します。LLM ではトークン、DeepL と Google Cloud Translation ではソース文字数、セルフホストの openai-compatible や libretranslate のサーバーでは 「API の費用なし」と報告します。--json を付けると、同じ数値がロケールごと、および合計として result.estimate に入るため、スクリプトでゲート条件にできます。

金額を確認するには、使うモデルの現在の単価を、プロバイダー自身の料金ページで調べます。

プロバイダー課金単位料金
Gemini入力トークンと出力トークン(無料枠あり)Gemini API pricing
Anthropic入力トークンと出力トークンAnthropic pricing
OpenAI入力トークンと出力トークンOpenAI API pricing
OpenCode入力トークンと出力トークンOpenCode Zen pricing
DeepLソース文字数DeepL API pricing
Google Cloud Translationソース文字数Cloud Translation pricing
openai-compatible、LibreTranslateなし(自分のサーバー)API の費用なし

次に、確認した日付とともに設定へ追加します。

verbatra.config.ts
export default defineConfig({
  // ...
  rates: {
    asOf: "2026-01-15",
    currency: "USD",
    table: {
      // placeholders: copy the current rates from https://ai.google.dev/gemini-api/docs/pricing
      "gemini/gemini-2.5-flash": { inputPerMillionTokens: 1, outputPerMillionTokens: 2 },
    },
  },
});

上の単価はダミー値であり、実際の価格ではありません。この単価から出力される数値にはすべて asOf の日付が付くため、古い料金表は古いとひと目でわかります。verbatra は、ない単価を作り出したり、価格を付けられないモデルに 0.00 を出力したりしません。代わりに、欠落しているエントリを示します。キーの形式と単位は、rates を参照してください。

見積もりに含まれるものを知る

見積もりは、本来なら手で計算する内容を代わりに計算します:

  • リクエスト:各ロケールのキーは、最大 maxBatchSize(デフォルトは 50)件ずつのバッチに分けられ、1 バッチにつき 1 リクエストになります。ここに、generatePlurals が送るバッチも加わります。
  • 入力:LLM のリクエストにはすべて、固定のシステムルール(約 700 トークン)とレスポンススキーマ(約 100 トークン)、続いてキー、その説明、トーン、ターゲットロケールの用語集全体が含まれます。プロンプトは、送信されるペイロードをシリアライズして測るため、大きな用語集は、それを載せるリクエストのたびに数えられます。
  • 出力:訳文はまだ存在しないため、ソーステキストの 1.5 倍の大きさとして見積もります。ドイツ語、フランス語、ロシア語は、英語より 3 分の 1 から半分ほど長くなることが多いためです。
  • トークン:文字は、1 トークンあたり約 4 文字で換算します。これは英語の文章に合う値で、ほかの文字体系ではもっと密になります。

実際の実行は、たいてい見積もりより安くなります。ドライランの件数が上限である 2 つの理由と同じです。高くなることもあり、estimate excludes の行にその要因が示されます。特に重要なのは次の 2 つです。

  • 再試行:失敗したリクエストは再試行されます。追加の試行は、Anthropic、OpenAI、OpenCode、openai-compatible、Gemini で最大 2 回、DeepL で 5 回、Google Cloud Translation と LibreTranslate ではありません。モデルに届いた試行は課金されます。
  • 修復:キーが返ってこなかった場合、verbatra は修復リクエストを 1 回送ります。これには、システムルール、用語集、トーンがもう一度すべて含まれます。

見積もりは計画に使うものであり、上限として約束しないでください。また、見積もりの対象は translate だけです。Studio やエージェントツールで 1 つのエントリを再翻訳する場合は、別の経路で費用が発生します。

実行に上限を設ける

承認した実行には、見積もりの入力トークンと出力トークンの合計より少し大きい値で、厳格な停止ラインを設けます。

verbatra translate --max-tokens 80000

上限を超えるリクエストは、送られずに保留され、そのキーは次回の実行まで未処理のままです。設定にも maxTokens がある場合は、小さいほうの値が適用されます。DeepL、Google Cloud Translation、LibreTranslate はトークンを報告しないため、これらでは verbatra 自身の予測に対して上限が適用されます。トークンの上限と、すべての実行に適用される予算については maxTokens と budgetBehavior を参照してください。

1 つのロケールで調整する

正確な数値は、実際の実行から得られます。ロケールを 1 つだけ翻訳して、使用量を確認します。

verbatra translate --locales de
出力
verbatra translate
  de: 400 translated, 0 unchanged, 18400 tokens (10800 in, 7600 out)
  total: 18400 tokens (10800 in, 7600 out)
1 succeeded, 0 partial, 0 failed

この値に、残りのロケール数を掛けます。--json では、usage.inputTokens と usage.outputTokens が該当します。この実行には実際に費用がかかりますが、作業は残ります。そのロケールは完了しています。

過去の実行の費用を確認する新機能

Studio の Overview(概要)には、記録された実行が費用とともに一覧表示されます。費用は実行が終わった時点で固定されるため、あとから rates を変更しても書き換わりません。金額は、プロバイダーが報告したトークン数に、その時点の単価を掛けたものです。Estimated(見積もり値)は、使用量を報告しないプロバイダーのソース文字数に基づく値です。At least(下限値)は、トークンを報告しなかったロケールがあるため、下限であることを示します。No rate(単価なし)は、そのモデルに一致する単価がないことを、unknown(不明)は、キーは送られたもののトークンが返らなかったことを意味し、どちらも無料ではありません。セルフホストのプロバイダーは not billed(課金なし)と表示されます。記録については runHistory に説明があり、画面は Studio でレビューするで確認できます。

機械翻訳プロバイダー

DeepL と Google Cloud Translation はトークンではなくソース文字数で課金し、LibreTranslate はソース文字数を数えますが課金はしません。verbatra がこれらに送るのは、プレースホルダーを短い番号付きマーカーにしたソーステキストで、システムルール、キー名、周りの JSON は付きません。見積もりが数えるのは、ソース文字数だけです。DeepL は、マーカーを囲むタグを課金しません。Google がマーカーを囲む span のマークアップを課金するかどうかは、明記されていません。これらのプロバイダーが保留する値(PLACEHOLDER_UNSUPPORTED)は送られないため、送られる文字数は、元の合計より少なくなることがあります。

Google Cloud Translation

Google Cloud Translation は DeepL と同じように数えます。見積もりではソース文字数で、maxTokens の予算にはトークン数の予測値で数え、実行サマリーでは見積もりとして示されます。

エージェントから見積もる

2 つのエージェントツールが、translate --estimate --json が出力するのと同じ内容を、すべてのロケール、または一部のロケールについて返します。プロバイダーは呼び出しません。

ツール場所
translation.estimateMCP サーバー
verbatra_translation_estimateStudio のエージェントツール

見積もりの範囲内で費用をかける

そのあと translation.translatePending に、同じ locales と maxTokens の上限を渡します。見積もってから費用をかけるを参照してください。

次回の実行が安くなる理由

ここまでの数値は、最初の実行の費用です。それ以降、verbatra が送るのは、欠落しているキーと、ロックファイルのベースラインからソースが変更されたキーだけで、キャッシュが同一の文字列の以前の訳文を再利用します。日々の費用は、編集した文字列の分だけです。無料で試すには、Gemini の無料枠を使うか、openai-compatible をローカルモデルに向けます。プロバイダーを参照してください。

関連項目

GitHub で編集

このページの内容