# 价格 每个模型的价格与模型制造商收取的价格完全一致，以美元计价。费用从你的 **API 余额**中扣除，余额以 **API 积分**计算：**1,000 API 积分 = $1**。API 余额独立于 Doitong 应用的积分。没有套餐、最低消费或按模型收取的费用：调用按其价格计费，请求被接受时从 API 余额中扣除。 在俄罗斯（doitong.ru、api.doitong.ru 或 `?currency=rub`），价格也会以卢布显示：美元价格 × USD/RUB 汇率 × 1.3。 ## 单位 每个模型都有一个计费单位，该单位会显示在模型页面和 `GET https://api.doitong.ru/v1/models/{model_id}` 中： | 单位 | 数量 | |---|---| | `second` | 输出视频或音频的秒数（`duration`） | | `image` | 生成的图像数量（`num_images`） | | `megapixel` | 输出的宽度 × 高度，以百万像素计（1 MP = 1024 × 1024 像素） | | `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.ru/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 余额中扣除，余额和密钥预算必须能够覆盖该金额。 2. 运行成功后，系统会将请求结算为模型报告的实际用量：用量 × 用量价格，向上取整为整数 API 积分。**最大价格中剩余的部分会自动退款**，并在 API 余额中作为一条 `refund` 记录退回一次。 3. 即使实际用量会超过最大价格，运行费用也不会超过最大价格。失败或取消的运行始终全额退款。 大多数运行的费用远低于最大价格；模型页面会针对构建器输入显示“每次运行最高 $X”，目录中显示典型运行价格（“起价”）。少数按处理时间计费的模型，其用量就是模型的处理时间（标记为 `approximate`）。 ```json 200 OK · 按用量计费模型的报价 { "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.ru/v1/quote/{model_id}` 接受你发送给 `run` 的完全相同的请求正文，并返回该输入的价格：对于按[用量计费](#metered)的模型，返回确切价格；对于其他模型，返回运行可能产生的最高价格。它无需密钥且不收费： ```bash curl -X POST "https://api.doitong.ru/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 中的每个价格都具有相同结构： - 模型：`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`； - 请求：`cost: { "credits": 560, "usd": "0.56", "charged": 560, "refunded": 0 }`（API 积分；按用量计费的请求还会添加 `mode`、`held`、`typical` 和 `settled`，参见[按用量计费](#metered)）； - 账户：`GET https://api.doitong.ru/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³ 字节；保留 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.ru/developers/dashboard#balance](https://doitong.ru/developers/dashboard#balance) 为 API 余额充值。余额过低时，运行会返回 `402 insufficient_credits` 和 `top_up_url`。每个 API 密钥还可以设置自己的 API 积分预算上限（参见[身份验证](https://doitong.com/developers/docs/authentication#credit-budgets)）。