# 定價 每個模型的費用完全依模型製作者以美元收取的價格計算。您從 **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}`： | 單位 | 數量 | |---|---| | `second` | 輸出影片或音訊的秒數（`duration`） | | `image` | 產生的圖像數量（`num_images`） | | `megapixel` | 輸出的寬 × 高，以百萬像素計（1 MP = 1024 × 1024 pixels） | | `video` | 一部產生的影片 | | `request` | 一次呼叫 | | `1000_characters` | 輸入文字的字元數，每 1000 個計算 | | `step` | 訓練步數 | 價格 = 數量 × 每單位 API 點數，向上取整為整數 API 點數（$0.001），且不低於 1。非常便宜的單位可能有小數單價（每秒 `0.4` API 點數）；只有一次呼叫的總額會取整。 部分模型會依輸入採用不同費率：有聲影片比無聲影片昂貴，4K 比 1K 昂貴，依此類推。這些 **規則** 列在每個模型頁面上。省略的參數會採用其預設值，因此您看到的輸入價格就是實際支付的價格。 ## 精確、測量、估算與用量價格 每個價格都有一個 `mode`： - `exact`：根據您的輸入計算價格（秒數、圖像、百萬像素、字元、步數，或每部影片或每次呼叫的固定價格）。 - `measured`：價格依您傳送的檔案而定：輸入影片或音訊的長度、輸入圖像的大小、影片的影格率或影格數。升頻、唇形同步、影片轉影片、轉錄和音訊工具都採用此方式計價。執行前，API 會讀取檔案的長度、解析度和影格率（報價也會進行相同處理），因此報價正是執行時收取的價格。模型頁面會說明計費項目（「輸入影片每秒價格」），其計算工具會使用您檔案的數值。無法讀取的檔案會以 `unmeasurable_input` 拒絕，且不會收費。 - `estimate`：模型本身的成本取決於輸入無法預先得知的因素（Token、運算時間）。此類模型會收取固定的 **每次執行估算價格**（有圖像數量時則為每張輸出圖像），價格根據該模型實際執行的平均成本設定。您仍可在執行前知道價格：報價就是您要支付的價格。 - `metered`：模型會依 **實際用量計費**，只有執行本身知道用量：語言或視覺模型讀取和寫入的 Token、語音模型產生語音的秒數，或模型的處理時間。請參閱下方的[依用量計費](#metered)。 模型頁面會顯示「每次執行價格」、「輸入影片每秒價格」（及類似文字）、「每次執行估算價格」或「依用量計費」；`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`）。 ```json 200 OK · metered 模型的報價 { "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` 會顯示保留的金額及實際用量： ```json { "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` 的完全相同本文，並回傳該輸入的價格：除了[依用量計費](#metered)的模型外，都是精確價格；對於這類模型，則是此次執行可能產生的最高費用。不需要金鑰，也不收費： ```bash 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}' ``` ```json 200 OK · 報價 { "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` 金額。 > [!TIP] > **報價就是費用。** 相同函式會同時計算兩者，因此使用此輸入執行時，費用正好是 `credits`。 > 唯一例外是[依用量計費](#metered)的模型（`mode: metered`）：其中 `credits` 是執行可能產生的最高費用，會在開始時扣除，未使用部分則在執行後退款。 ## 價格物件 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`，請參閱[依用量計費](#metered)）； - 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=`）： | | 保存時間 | 價格 | |---|---|---| | 永久（`permanent`、預設值） | 直到您刪除檔案 | 每 GB 每月 100 API 點數（$0.10） | | 7 天（`temporary`） | 7 天 | 免費 | 永久儲存空間每天從 API 餘額收費：保存的 GB 數 × 每月價格 ÷ 當月天數，並以 `storage` 類型的帳本紀錄保存。API 點數的小數部分會累計到隔天，因此一個月的總額正好是 GB × 100 API 點數（1 GB = 1024³ bytes；保存 10 GB 一個月需 1,000 API 點數）。餘額永遠不會低於零：無法支付時，當天不收費，您會收到電子郵件，並有 30 天可以儲值；逾期後，保存的檔案會變為暫存檔案，並在 7 天後刪除。詳細資訊：[檔案](https://doitong.com/developers/docs/files#storage)。 ## 目前價格 | 模型 | ID | 價格 | 起始價格 | |---|---|---|---| | [FLUX.1 \[dev\]](https://doitong.com/developers/models/flux/dev) | `flux/dev` | $0.025 / 百萬像素 | $0.025 (25 API 點數) | | [FLUX.1 \[schnell\]](https://doitong.com/developers/models/flux/schnell) | `flux/schnell` | $0.003 / 百萬像素 | $0.003 (3 API 點數) | | [FLUX.2 \[dev\]](https://doitong.com/developers/models/flux-2) | `flux-2` | $0.012 / 百萬像素 | $0.012 (12 API 點數) | | [FLUX.2 \[pro\]](https://doitong.com/developers/models/flux-2-pro) | `flux-2-pro` | $0.015 / 輸出圖像百萬像素 | $0.015 (15 API 點數) | | [GPT Image 2.5 Text to Image](https://doitong.com/developers/models/openai/gpt-image-2.5/flare/text-to-image) | `openai/gpt-image-2.5/flare/text-to-image` | 起價 $0.008 / 圖像 | $0.008 (8 API 點數) | | [Ideogram V4.5](https://doitong.com/developers/models/ideogram/v4.5) | `ideogram/v4.5` | 起價 $0.03 / 圖像 | $0.03 (30 API 點數) | | [Nano Banana 2](https://doitong.com/developers/models/nano-banana-2) | `nano-banana-2` | 起價 $0.06 / 圖像 | $0.06 (60 API 點數) | | [Nano Banana Pro](https://doitong.com/developers/models/nano-banana-pro) | `nano-banana-pro` | 起價 $0.15 / 圖像 | $0.15 (150 API 點數) | | [Qwen Image 3 Text to Image](https://doitong.com/developers/models/alibaba/qwen-image-3/text-to-image) | `alibaba/qwen-image-3/text-to-image` | 起價 $0.04 / 圖像 | $0.04 (40 API 點數) | | [Recraft V4.1 Text to Image](https://doitong.com/developers/models/recraft/v4.1/text-to-image) | `recraft/v4.1/text-to-image` | $0.035 / 圖像 | $0.035 (35 API 點數) | | [Seedream 5.0 Pro Text to Image](https://doitong.com/developers/models/bytedance/seedream/v5/pro/text-to-image) | `bytedance/seedream/v5/pro/text-to-image` | 起價 $0.068 | $0.068 (68 API 點數) | | [FLUX.1 Kontext \[pro\]](https://doitong.com/developers/models/flux-pro/kontext) | `flux-pro/kontext` | $0.04 / 圖像 | $0.04 (40 API 點數) | | [Nano Banana 2 Edit](https://doitong.com/developers/models/nano-banana-2/edit) | `nano-banana-2/edit` | 起價 $0.06 / 圖像 | $0.06 (60 API 點數) | | [Nano Banana Pro Edit](https://doitong.com/developers/models/nano-banana-pro/edit) | `nano-banana-pro/edit` | 起價 $0.15 / 圖像 | $0.15 (150 API 點數) | | [Qwen Image 3 Edit](https://doitong.com/developers/models/alibaba/qwen-image-3/edit) | `alibaba/qwen-image-3/edit` | 起價 $0.04 / 圖像 | $0.04 (40 API 點數) | | [FLUX 3 Max Text to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/text-to-video) | `blackforestlabs/flux-3-max/text-to-video` | 起價 $0.0425 / 輸出影片秒 | $0.043 (43 API 點數) | | [Grok Imagine Video 1.5 Text to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/text-to-video) | `xai/grok-imagine-video/v1.5/text-to-video` | 起價 $0.08 / 秒 | $0.48 (480 API 點數) | | [Kling 3.0 Pro Text to Video](https://doitong.com/developers/models/kling-video/v3/pro/text-to-video) | `kling-video/v3/pro/text-to-video` | 起價 $0.112 / 秒 | $0.56 (560 API 點數) | | [LTX 2.5 Pro Text to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/text-to-video/pro) | `lightricks/ltx-2.5/text-to-video/pro` | 起價 $0.12 / 秒 | $0.72 (720 API 點數) | | [MiniMax H3 Text to Video](https://doitong.com/developers/models/minimax/h3/text-to-video) | `minimax/h3/text-to-video` | 起價 $0.05 / 秒 | $0.25 (250 API 點數) | | [Seedance 2.0 Fast Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/text-to-video) | `bytedance/seedance-2.0/fast/text-to-video` | 起價 $0.113 / 秒 | $0.452 (452 API 點數) | | [Seedance 2.0 Text to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/text-to-video) | `bytedance/seedance-2.0/text-to-video` | 起價 $0.141 / 秒 | $0.564 (564 API 點數) | | [Veo 3.1](https://doitong.com/developers/models/veo3.1) | `veo3.1` | 起價 $0.20 / 秒 | $1.60 (1,600 API 點數) | | [Veo 3.1 Fast](https://doitong.com/developers/models/veo3.1/fast) | `veo3.1/fast` | 起價 $0.10 / 秒 | $0.80 (800 API 點數) | | [Wan 3.0 Text to Video](https://doitong.com/developers/models/alibaba/wan-3.0/text-to-video) | `alibaba/wan-3.0/text-to-video` | 起價 $0.05 / 秒 | $0.25 (250 API 點數) | | [FLUX 3 Max Image to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/image-to-video) | `blackforestlabs/flux-3-max/image-to-video` | 起價 $0.0425 / 輸出影片秒 | $0.043 (43 API 點數) | | [Grok Imagine Video 1.5 Image to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/image-to-video) | `xai/grok-imagine-video/v1.5/image-to-video` | 起價 $0.082 / 秒 | $0.492 (492 API 點數) | | [Kling 3.0 Pro Image to Video](https://doitong.com/developers/models/kling-video/v3/pro/image-to-video) | `kling-video/v3/pro/image-to-video` | 起價 $0.112 / 秒 | $0.56 (560 API 點數) | | [LTX 2.5 Pro Image to Video](https://doitong.com/developers/models/lightricks/ltx-2.5/image-to-video/pro) | `lightricks/ltx-2.5/image-to-video/pro` | 起價 $0.12 / 秒 | $0.72 (720 API 點數) | | [MiniMax H3 Image to Video](https://doitong.com/developers/models/minimax/h3/image-to-video) | `minimax/h3/image-to-video` | 起價 $0.05 / 秒 | $0.25 (250 API 點數) | | [Seedance 2.0 Fast Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/image-to-video) | `bytedance/seedance-2.0/fast/image-to-video` | 起價 $0.113 / 秒 | $0.452 (452 API 點數) | | [Seedance 2.0 Image to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/image-to-video) | `bytedance/seedance-2.0/image-to-video` | 起價 $0.141 / 秒 | $0.564 (564 API 點數) | | [Veo 3.1 Fast Image to Video](https://doitong.com/developers/models/veo3.1/fast/image-to-video) | `veo3.1/fast/image-to-video` | 起價 $0.10 / 秒 | $0.80 (800 API 點數) | | [Veo 3.1 Image to Video](https://doitong.com/developers/models/veo3.1/image-to-video) | `veo3.1/image-to-video` | 起價 $0.20 / 秒 | $1.60 (1,600 API 點數) | | [Wan 3.0 Image to Video](https://doitong.com/developers/models/alibaba/wan-3.0/image-to-video) | `alibaba/wan-3.0/image-to-video` | 起價 $0.05 / 秒 | $0.25 (250 API 點數) | | [Seedance 2.0 Fast Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/fast/reference-to-video) | `bytedance/seedance-2.0/fast/reference-to-video` | 起價 $0.113 / 秒 | $0.452 (452 API 點數) | | [Seedance 2.0 Reference to Video](https://doitong.com/developers/models/bytedance/seedance-2.0/reference-to-video) | `bytedance/seedance-2.0/reference-to-video` | 起價 $0.141 / 秒 | $0.564 (564 API 點數) | | [Kling AI Avatar 2.0 Pro](https://doitong.com/developers/models/kling-video/ai-avatar/v2/pro) | `kling-video/ai-avatar/v2/pro` | $0.115 / 輸入音訊秒 | $0.115 (115 API 點數) | | [Sync Lipsync 3](https://doitong.com/developers/models/sync-lipsync/v3) | `sync-lipsync/v3` | $8.00 / 輸出影片分鐘 | $8.00 (8,000 API 點數) | | [VEED Fabric 1.0](https://doitong.com/developers/models/veed/fabric-1.0) | `veed/fabric-1.0` | 起價 $0.08 / 輸入音訊秒 | $0.08 (80 API 點數) | | [Topaz Image Upscale](https://doitong.com/developers/models/topaz/upscale/image/precision) | `topaz/upscale/image/precision` | $0.08 / 輸出圖像 24 百萬像素 | $0.08 (80 API 點數) | | [Topaz Video Upscale](https://doitong.com/developers/models/topaz/upscale/video/precision) | `topaz/upscale/video/precision` | 起價 $0.00667 / 輸入影片秒 | $0.10 (100 API 點數) | | [Bria RMBG 2.0](https://doitong.com/developers/models/bria/background/remove) | `bria/background/remove` | 起價 $0.018 | $0.018 (18 API 點數) | | [Eleven v4 Text to Speech](https://doitong.com/developers/models/elevenlabs/tts/eleven-v4) | `elevenlabs/tts/eleven-v4` | $0.08 / 1000 個字元 | $0.08 (80 API 點數) | | [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | $0.10 / 1000 個字元 | $0.10 (100 API 點數) | | [MiniMax Music 3](https://doitong.com/developers/models/minimax/music-3) | `minimax/music-3` | $0.002 / 秒 | $0.12 (120 API 點數) | | [MMAudio V2](https://doitong.com/developers/models/mmaudio-v2) | `mmaudio-v2` | $0.001 / 秒 | $0.008 (8 API 點數) | 這些是精選模型。所有 1,496 個模型及其價格都列在[模型目錄](https://doitong.com/developers/models)和 `GET /models` 中（不需要金鑰）。 ## 儲值 請在 [https://doitong.com/developers/dashboard#balance](https://doitong.com/developers/dashboard#balance) 為 API 餘額儲值。餘額過低時，執行會以 `402 insufficient_credits` 回應並帶有 `top_up_url`。每個 API 金鑰也可以設定以 API 點數計算的個別預算上限（請參閱[驗證](https://doitong.com/developers/docs/authentication#credit-budgets)）。