定價

每個模型的費用完全依模型製作者以美元收取的價格計算。您從 API 餘額 支付，餘額以 API 點數 計算：1,000 API 點數 = $1。API 餘額獨立於 Doitong 應用程式的點數。沒有方案、最低消費或每模型費用：請求接受時，會從 API 餘額扣除該次呼叫的價格。

在俄羅斯（doitong.ru、api.doitong.ru 或 ?currency=rub），也會以盧布顯示價格：美元價格 × USD/RUB 匯率 × 1.3。

單位#

每個模型都有一個計費單位，顯示於其頁面和 GET https://api.doitong.com/v1/models/{model_id}：

價格 = 數量 × 每單位 API 點數，向上取整為整數 API 點數（$0.001），且不低於 1。非常便宜的單位可能有小數單價（每秒 0.4 API 點數）；只有一次呼叫的總額會取整。

部分模型會依輸入採用不同費率：有聲影片比無聲影片昂貴，4K 比 1K 昂貴，依此類推。這些 規則 列在每個模型頁面上。省略的參數會採用其預設值，因此您看到的輸入價格就是實際支付的價格。

精確、測量、估算與用量價格#

每個價格都有一個 mode：

• exact：根據您的輸入計算價格（秒數、圖像、百萬像素、字元、步數，或每部影片或每次呼叫的固定價格）。
• measured：價格依您傳送的檔案而定：輸入影片或音訊的長度、輸入圖像的大小、影片的影格率或影格數。升頻、唇形同步、影片轉影片、轉錄和音訊工具都採用此方式計價。執行前，API 會讀取檔案的長度、解析度和影格率（報價也會進行相同處理），因此報價正是執行時收取的價格。模型頁面會說明計費項目（「輸入影片每秒價格」），其計算工具會使用您檔案的數值。無法讀取的檔案會以 unmeasurable_input 拒絕，且不會收費。
• estimate：模型本身的成本取決於輸入無法預先得知的因素（Token、運算時間）。此類模型會收取固定的 每次執行估算價格（有圖像數量時則為每張輸出圖像），價格根據該模型實際執行的平均成本設定。您仍可在執行前知道價格：報價就是您要支付的價格。
• metered：模型會依 實際用量計費，只有執行本身知道用量：語言或視覺模型讀取和寫入的 Token、語音模型產生語音的秒數，或模型的處理時間。請參閱下方的依用量計費。

模型頁面會顯示「每次執行價格」、「輸入影片每秒價格」（及類似文字）、「每次執行估算價格」或「依用量計費」；GET https://api.doitong.com/v1/models?mode=measured、?mode=estimate 和 ?mode=metered 會列出相應模型。

依用量計費#

metered 模型具有用量價格（「每 1000 個 Token $0.01」、「每秒產生音訊 $0.002」、「每秒處理時間 $0.00111」）以及 每次執行上限：依您的請求內容（max_tokens、文字長度、解析度、輸出數量）和模型公布的限制，計算一次執行可能產生的最高費用。它不會依 URL 後方檔案的內容而變動。對於依處理時間或語音工作階段長度計費的模型，上限是請求可執行的最長時間（圖像 15 分鐘、音訊 30 分鐘、影片 60 分鐘），因此遠高於一般執行費用。若輸入的最高費用會超過模型的每次執行限制（例如非常長的文字），會以 422 invalid_input 拒絕：

1. 報價會將此上限回傳為 credits（含 hold 和一般執行所需的 typical）。執行開始時，會從 API 餘額扣除上限金額；API 餘額和您的金鑰預算都必須足以支付該金額。
2. 執行成功後，請求會依模型回報的用量結算：用量 × 用量價格，向上取整為整數 API 點數。上限中未使用的部分會自動退款，退款一次，並以 API 餘額中的 refund 紀錄表示。
3. 執行費用永遠不會超過上限，即使用量計算結果會超過上限。失敗或取消的執行一律全額退款。

大多數執行的費用遠低於上限；模型頁面會針對建立器的輸入顯示「每次執行最高 $X」，目錄則顯示一般執行價格（「起價」）。少數依處理時間計費的模型，其用量就是模型的處理時間（標記為 approximate）。

{
  "object": "quote",
  "credits": 621,
  "usd": "0.621",
  "mode": "metered",
  "label": "Charged by usage",
  "hold": { "credits": 621, "usd": "0.621" },
  "typical": { "credits": 10, "usd": "0.01" },
  "settlement": "usage",
  "display": "$0.01 / 1000 tokens",
  "breakdown": "up to 62.035 × 1000 tokens × $0.01"
}

執行後，請求的 cost 會顯示保留的金額及實際用量：

{
  "cost": { "credits": 621, "usd": "0.621", "charged": 621, "refunded": 611, "mode": "metered", "held": 621,
            "typical": 10, "settled": { "status": "settled", "credits": 10, "usd": "0.01", "quantity": 1,
            "unit": "1000_tokens", "unit_usd": "0.01", "source": "billed_usage", "approximate": false } }
}

charged − refunded 就是此次執行的費用。從產生結果到結算的短暫期間，settled.status 為 pending；在模型完全沒有回報用量的罕見情況下為 no_usage（此時上限會作為價格）。

執行前報價#

POST https://api.doitong.com/v1/quote/{model_id} 接受您要傳送給 run 的完全相同本文，並回傳該輸入的價格：除了依用量計費的模型外，都是精確價格；對於這類模型，則是此次執行可能產生的最高費用。不需要金鑰，也不收費：

curl -X POST "https://api.doitong.com/v1/quote/flux/schnell" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "A lighthouse at dusk", "num_images": 2}'

{
  "object": "quote",
  "model": "flux/schnell",
  "credits": 6,
  "usd": "0.006",
  "unit": "megapixel",
  "quantity": 2,
  "unit_credits": 3,
  "mode": "exact",
  "label": "Price per run",
  "display": "$0.003 / megapixel",
  "breakdown": "2 MP (2 images) × 3 API credits",
  "input": { "prompt": "A lighthouse at dusk", "num_images": 2 },
  "warnings": []
}

使用金鑰時，報價也會回傳 balance_credits 和 balance_usd（您的 API 餘額）、affordable 和 key_budget_remaining。加入 ?currency=rub 可取得 rub 金額。

價格物件#

API 中的每個價格都有相同結構：

• models：price: { "credits": 112, "usd": "0.112", "unit": "second", "display": "$0.112 / second", "credits_display": "112 API credits / second", "from_credits": 560, "from_usd": "0.56", "mode": "exact" } — 在俄羅斯或使用 ?currency=rub 時，另外包含 rub、rub_display 和 from_rub；
• requests：cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 }（API 點數；metered 請求會加入 mode、held、typical 和 settled，請參閱依用量計費）；
• account：GET https://api.doitong.com/v1/account 會回傳 credits（API 餘額）、balance: { "credits", "usd" } 和 storage（檔案儲存空間的價格、用量及每月估算）。

退款#

• 無效請求（執行開始前的任何 4xx）永遠不會收費。
• 以 failed 結束的請求（包括 timeout）會自動全額退回 API 餘額。
• 在執行開始前取消的請求會全額退款。模型開始產生後，取消只是一項請求：若模型完成，結果會傳送並收費。
• 成功的 metered 請求會退回其上限中未使用的部分。

請求物件會顯示所有資訊：cost.credits、cost.charged 和 cost.refunded。

檔案儲存空間#

輸出檔案會保存在我們的儲存空間中。您可以在帳戶層級或每次執行時選擇（?storage=）：

永久儲存空間每天從 API 餘額收費：保存的 GB 數 × 每月價格 ÷ 當月天數，並以 storage 類型的帳本紀錄保存。API 點數的小數部分會累計到隔天，因此一個月的總額正好是 GB × 100 API 點數（1 GB = 1024³ bytes；保存 10 GB 一個月需 1,000 API 點數）。餘額永遠不會低於零：無法支付時，當天不收費，您會收到電子郵件，並有 30 天可以儲值；逾期後，保存的檔案會變為暫存檔案，並在 7 天後刪除。詳細資訊：檔案。

目前價格#

這些是精選模型。所有 1,496 個模型及其價格都列在模型目錄和 GET /models 中（不需要金鑰）。

儲值#

請在 https://doitong.com/developers/dashboard#balance 為 API 餘額儲值。餘額過低時，執行會以 402 insufficient_credits 回應並帶有 top_up_url。每個 API 金鑰也可以設定以 API 點數計算的個別預算上限（請參閱驗證）。