定价

每个模型的价格与模型制造商收取的价格完全一致，以美元计价。费用从你的 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 余额中扣除，余额和密钥预算必须能够覆盖该金额。
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 中的每个价格都具有相同结构：

• 模型：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，参见按用量计费）；
• 账户：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³ 字节；保留 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 积分预算上限（参见身份验证）。