使用量
適切な単位、期間、実行記録に基づいて、処理で消費したリソースとアカウントの支出を把握します。
使用量は、支出とそのもとになった処理を結び付けます。アカウント履歴では、組織が一定期間に何を消費したかを確認できます。モデルとトークンの記録からは生成処理の内容が、個々の実行記録からは、どの操作が完了し、再試行され、以前の出力を保持したかがわかります。これらの記録は互いに関連していますが、それぞれの合計値を同じものとして扱うことはできません。
まず、会計上の確認事項を明確にする #
照合する組織と期間を選び、支出履歴を確認します。その支出につながった処理を調べるにはモデル費用とトークンの時系列データを、特定の実行を調べるには実行記録や費用を参照してください。合計値を比較するときは、フィルター、日付範囲、タイムゾーンをそろえます。
対象ロケールの追加、新たな出力の生成、再試行、再利用状況の変化によって、モデルのトークン数が増えることがあります。ただし、その増加だけで請求額全体の変化を説明できるわけではありません。差額の原因を特定のモデルに結び付ける前に、実際に確認された処理と、その課金区分を照合してください。
実測した費用と出力トークン数は、今後、同程度の処理にかかる費用を見積もる際に役立ちます。ただし、プロバイダーの料金表や請求書、保証された単価を示すものではありません。残高、購入、支払い、プランの状態については、請求で説明しています。
単位を混同しない #
| 数量 | 表すもの |
|---|---|
| 入力トークンと出力トークン | プロバイダーが報告する定義に基づくモデルの処理量。 |
| キャッシュ読み取りトークンとキャッシュ書き込みトークン | 入力トークンの合計と重複する場合がある、プロバイダーのキャッシュ処理量。 |
| クレジットと通貨 | 現在の商用契約に基づく会計上の数量。 |
| リクエスト数、単語数、リポジトリの行数 | 集計対象がそれぞれ異なる、処理量の指標。 |
キャッシュのカウントと入力トークンの合計に重複がないとみなして加算したり、入力全体を新規入力のみと表示したりしないでください。重複するこれらの数量の読み解き方は、プロンプトキャッシュで説明しています。
プロバイダー費用、ローカライゼーション料金、専門家によるレビュー、独立した測定、プラットフォームのプランは、それぞれ別の構成要素です。決定論的なチェックでは、モデルのトークンを使わなくても、従量課金対象の測定使用量が発生することがあります。翻訳を再利用すれば生成を省けますが、関連するすべての操作が無料になるわけではありません。
費用を比較するときは、コンテンツ、対象言語の範囲、レビューの範囲、受け入れ要件をそろえてください。トークン数の差を総費用の確実な削減額として示すのではなく、出力の確認や対応に必要な作業も含めて比較します。
確認したい事項に合ったレポートを使う #
処理量レポートは、生成量と、言語別・ソース別の分布を示します。リポジトリの変更記録は連携の仕組みに依存しており、すべてのコンテンツシステムを網羅するものではありません。
品質レポートでは、結果とともに評価基準と分母を示す必要があります。適用対象外の記録からは、その基準に対する回答は得られません。「判定不能」は、評価は完了したものの、品質が維持されたか、変化したかを確定できなかったことを意味します。評価が完了していない記録は、それとも異なる状態です。合格率と完了状況に加え、判定が確定した対象の割合も報告してください。
用語とルールについては、候補やサンプルと、実際の使用状況や遵守状況を区別してください。関連する集計値については、評価結果で説明しています。
再実行の前に、進められない処理や一部だけ完了した処理を調べる #
再試行やクレジットの購入を行う前に、実際のエラーを確認してください。検証、認証、認可、リソースの欠落、クレジット上限、割り当て上限では、それぞれ原因が異なります。該当するAPIでの一般的なコードは、順に400、401、403、404、402、429ですが、対処方法はその操作で定義されたエラーとメッセージに基づいて判断します。ローカライゼーションエンジンが無効化されている場合、必須の識別子がない場合、モデル設定がない場合、上流プロバイダーの上限に達した場合も、それぞれ異なる対応が必要です。
安全に再試行できるかどうかは、操作とその冪等性によって異なります。一般的なサーバーエラーが発生しても、最初のリクエストで何も実行されなかったとは限りません。その操作が再試行可能であることと、それまでにどの処理が受け付けられたかを確認したうえで、上限を設けたバックオフを使って再試行してください。
翻訳ジョブは、作成時には保留中のジョブとして保存されます。開始リクエストが成功すると処理が始まりますが、その応答だけでは翻訳の完了までは確認できません。一部だけ完了した処理を置き換える前に、翻訳対象ごとの結果、警告、保持されたテキストを確認し、実行された内容と課金された内容を照合してください。