# 价格 每个模型的价格都与模型制造商收取的价格完全一致，以美元计价。费用从你的 **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 像素） | | `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 余额中扣除；余额和密钥预算必须能够覆盖该金额。 2. 运行成功后，请求会按模型报告的用量结算：用量 × 用量价格，并向上取整为整数 API 积分。**最大值中未使用的部分会自动退款**，仅退款一次，并作为 API 余额中的一条 `refund` 记录。 3. 即使实际用量可能更高，运行费用也不会超过最大值。失败或取消的运行一律全额退款。 大多数运行的费用远低于最大值；模型页面会针对构建器输入显示“每次运行最高 $X”，目录中还会显示典型运行价格（“from”）。对于少数按处理时间计费的模型，用量就是模型的处理时间（标记为 `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.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 积分；按用量计费的请求还会添加 `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³ 字节；保留 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` | 输出图像每 24 百万像素 $0.08 | $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` | 每 1000 个字符 $0.08 | $0.08 (80 API 积分) | | [MiniMax Speech 2.8 HD](https://doitong.com/developers/models/minimax/speech-2.8-hd) | `minimax/speech-2.8-hd` | 每 1000 个字符 $0.10 | $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)）。