クレジットと使用量
請求対象のサービスはアカウントクレジットで決済されます。金額はミリクレジット(millicredits)単位で表記され、1000ミリクレジットが1クレジットに相当します。リクエストで指定する金額は整数である必要がありますが、残高や記録に表示される金額は小数点以下1桁(0.1ミリクレジット)まで許容されます。レスポンスに含まれるcredit_precisionは4であり、クレジットに換算した際には小数点以下最大4桁となります。
残高を確認する
Section titled “残高を確認する”GET /api/v1/billing/credits/balancecurl https://omnidoc.top/api/v1/billing/credits/balance \ -H "X-API-Key: $OMNIDOC_API_KEY"主要なフィールド:
| フィールド | 意味 |
|---|---|
available | 負債後の現在のミリクレジット残高。負債時はマイナス表示。 |
debt | ミリクレジット単位の債務:完了したジョブの実際のコストが残高を上回った部分。後から入金されるクレジット(チャージ、日次補助金、コードによる償還、返金など)は、まず債務を充当します。 |
spent | 決済されたミリクレジットの合計 |
expired | 期限切れまたは取り消されたミリクレジット |
today_charged | 本日決済されたミリクレジット |
lots | 現在有効なクレジットロットとその有効期限 |
クレジットパック
Section titled “クレジットパック”GET /api/v1/billing/credits/plansサインイン不要で、販売中のパック(purchase_plans、プランコードをキーとする)を返すパブリックエンドポイント。ただ今販売中:
| プランコード | クレジット | 価格 | ボーナス |
|---|---|---|---|
credits_3000_v4 | 3,000 | ¥9.90 | — |
credits_10000_v4 | 10,000 | ¥29.90 | — |
credits_25000_v4 | 25,000 | ¥69 | 8% |
credits_50000_v4(推奨) | 50,000 | ¥129 | 16% |
credits_125000_v4 | 125,000 | ¥299 | 25% |
credits_450000_v4 | 450,000 | ¥999 | 35% |
- 「ボーナス」は、10,000クレジットの価格に対して¥29.90で算出され、
bonus_percentフィールドに含まれます。推奨パックにはrecommended: trueが含まれます。いずれのフィールドも、設定されていない場合は表示されません。 - 価格は
price_fen(分、1/100元)が基準となり、クレジットはtotal_millicredits(ミリクレジット)が基準です。購入したクレジットの有効期限はなく、パックは再購入可能で、毎回一度に届きます。
充電ライフサイクル
Section titled “充電ライフサイクル”- ジョブが開始される前に、残高がしきい値と比較されます :残高(負債を差し引いたもの)は、ジョブのしきい値を超えている必要があります。例えば、PDF 翻訳では「ページ数 × 2 クレジット」、他のファイルでは原文テキストの長さ(少なくとも 2 クレジット)、音声・動画・スピーチではサーバーが測定した時間または文字数から算出されるコスト(価格は 音声・動画・音声 で指定されます)。予算が設定された API キーの場合、そのキーの残り予算もしきい値を超えている必要があります。そうでない場合、レスポンスは
402となり(ファイル翻訳ジョブはquota_exceeded=trueで失敗として終了し、メディアジョブはerror_code=insufficient_creditsで終了します)、料金は一切請求されません。ジョブの開始は残高に影響を与えません。 - 実際の使用量は、処理が完了した時点で課金されます :ファイル変換(画像を含む)、バッチ処理されたリッチテキスト、ドキュメント操作、オーディオ、ビデオおよび音声は、処理完了後の実際の使用量に対して全額課金されます。APIキーの予算は開始前の確認にのみ関与し、完了したジョブの料金を減額することはありません。もし予算超過によりキーが新たなジョブを開始できなくなった場合、上限が引き上げられるまで新しいジョブを開始することはできません。失敗またはキャンセルされたジョブには課金されません.
- 残高がマイナスになることがあります :実際のコストのうち残高を超える部分は負債として記録され、残高はマイナス値を示します。後から入金されたクレジットはまず負債を返済するために充当されます。残高がマイナスの間は新しいジョブを開始できず、残高を補充する必要があります。
クライアントは「いくら請求すべきか」を提示することはなく、サーバーは提供された内容に基づいて確定金額を算出します。
GET /api/v1/billing/credits/operations?limit=20GET /api/v1/billing/credits/operations/{operation_id}GET /api/v1/billing/credits/jobs/{job_id}レコードには、操作ID、ステータス、請求基準、および請求額と返金額が含まれます。APIキーで絞り込む場合、対象となる操作はそのキーで開始されたものに限られます。
GET /api/v1/usage?limit=50GET /api/v1/usage/summary使用状況エンドポイントは、アカウントのファイル数、文字数、トークン数および処理時間を返します。
クエリは無料です
Section titled “クエリは無料です”残高、ジョブステータス、使用状況、決済記録、結果リストおよびダウンロードアドレスの確認にはクレジットはかかりません。