定价

每个模型的价格都与模型制造商收取的价格完全一致，以美元计价。费用从你的 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”，目录中还会显示典型运行价格（“from”）。对于少数按处理时间计费的模型，用量就是模型的处理时间（标记为 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 积分；按用量计费的请求还会添加 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³ 字节；保留 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 积分预算上限（参见身份验证）。