コンテンツにスキップ

クレジットと使用量

請求対象のサービスはアカウントクレジットで決済されます。金額はミリクレジット(millicredits)単位で表記され、1000ミリクレジットが1クレジットに相当します。リクエストで指定する金額は整数である必要がありますが、残高や記録に表示される金額は小数点以下1桁(0.1ミリクレジット)まで許容されます。レスポンスに含まれるcredit_precisionは4であり、クレジットに換算した際には小数点以下最大4桁となります。

GET /api/v1/billing/credits/balance
Terminal window
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

主要なフィールド:

フィールド意味
available負債後の現在のミリクレジット残高。負債時はマイナス表示。
debtミリクレジット単位の債務:完了したジョブの実際のコストが残高を上回った部分。後から入金されるクレジット(チャージ、日次補助金、コードによる償還、返金など)は、まず債務を充当します。
spent決済されたミリクレジットの合計
expired期限切れまたは取り消されたミリクレジット
today_charged本日決済されたミリクレジット
lots現在有効なクレジットロットとその有効期限
GET /api/v1/billing/credits/plans

サインイン不要で、販売中のパック(purchase_plans、プランコードをキーとする)を返すパブリックエンドポイント。ただ今販売中:

プランコードクレジット価格ボーナス
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4(推奨)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • 「ボーナス」は、10,000クレジットの価格に対して¥29.90で算出され、bonus_percentフィールドに含まれます。推奨パックにはrecommended: trueが含まれます。いずれのフィールドも、設定されていない場合は表示されません。
  • 価格はprice_fen(分、1/100元)が基準となり、クレジットはtotal_millicredits(ミリクレジット)が基準です。購入したクレジットの有効期限はなく、パックは再購入可能で、毎回一度に届きます。
  1. ジョブが開始される前に、残高がしきい値と比較されます :残高(負債を差し引いたもの)は、ジョブのしきい値を超えている必要があります。例えば、PDF 翻訳では「ページ数 × 2 クレジット」、他のファイルでは原文テキストの長さ(少なくとも 2 クレジット)、音声・動画・スピーチではサーバーが測定した時間または文字数から算出されるコスト(価格は 音声・動画・音声 で指定されます)。予算が設定された API キーの場合、そのキーの残り予算もしきい値を超えている必要があります。そうでない場合、レスポンスは 402 となり(ファイル翻訳ジョブは quota_exceeded=true で失敗として終了し、メディアジョブは error_code=insufficient_credits で終了します)、料金は一切請求されません。ジョブの開始は残高に影響を与えません。
  2. 実際の使用量は、処理が完了した時点で課金されます :ファイル変換(画像を含む)、バッチ処理されたリッチテキスト、ドキュメント操作、オーディオ、ビデオおよび音声は、処理完了後の実際の使用量に対して全額課金されます。APIキーの予算は開始前の確認にのみ関与し、完了したジョブの料金を減額することはありません。もし予算超過によりキーが新たなジョブを開始できなくなった場合、上限が引き上げられるまで新しいジョブを開始することはできません。失敗またはキャンセルされたジョブには課金されません.
  3. 残高がマイナスになることがあります :実際のコストのうち残高を超える部分は負債として記録され、残高はマイナス値を示します。後から入金されたクレジットはまず負債を返済するために充当されます。残高がマイナスの間は新しいジョブを開始できず、残高を補充する必要があります。

クライアントは「いくら請求すべきか」を提示することはなく、サーバーは提供された内容に基づいて確定金額を算出します。

GET /api/v1/billing/credits/operations?limit=20
GET /api/v1/billing/credits/operations/{operation_id}
GET /api/v1/billing/credits/jobs/{job_id}

レコードには、操作ID、ステータス、請求基準、および請求額と返金額が含まれます。APIキーで絞り込む場合、対象となる操作はそのキーで開始されたものに限られます。

GET /api/v1/usage?limit=50
GET /api/v1/usage/summary

使用状況エンドポイントは、アカウントのファイル数、文字数、トークン数および処理時間を返します。

残高、ジョブステータス、使用状況、決済記録、結果リストおよびダウンロードアドレスの確認にはクレジットはかかりません。