查询调用账单与有效价格

估算调用费用

在模型目录查看所选模型的单价和计费单位。目录报价与调用后的实际扣费分别用于预算估算和账单核对。

图像计费项

图像模型可以按输入、输出 Token 分项计费，也可以合并为“综合用量”。分项计费中的“图像输出”只代表输出图像的原厂 Token；“综合用量”使用计费 Token，代表按照模型规则折算的多种用量。

若响应中的用量为 usage.billing.tokenhub_tokens，使用“综合用量”对应的单价，不再叠加输入或输出 Token 费用。用量字段示例见生成与编辑图像。

综合用量与费用

“综合用量”不限定图片。任何已接入综合计量的模型都使用这一展示方式。视频模型如果按秒、条或原厂输出 Token 计价，仍按对应的单位结算；显示名称通用不代表所有模型采用同一计费规则。

目录单价以 Credits（ℂ）表示，注意每项标明的数量单位。按百万计费 Token 报价时：

费用（ℂ）= 实际计费 Token 数量 ÷ 1,000,000 × 单价（ℂ / 百万计费 Token）

计费 Token 已按该模型的规则折算，使用响应中的数量即可，不需要再次乘换算系数。不同模型的系数可能不同，不能直接套用原厂图片或视频输出 Token 单价。最终金额还受适用折扣和结算精度影响，以调用明细的实际扣费为准。保留 x-cr-usage-id 可查询该次请求的账单。

费用示例

无需登录即可查看公开单价和下面的计算方法。以下假设单价仅用于演示算法；选择具体模型时，请在模型目录核对当前单价、单位和适用规格。

人民币等值按 1 ℂ = ¥0.20 换算。若适用折扣为 80%，20 ℂ 的标价对应 20 × 80% = 16 ℂ，即 ¥3.20。实际扣费还取决于结算精度，以调用账单为准。

“按生成规格计费”表示需要先选择与请求匹配的价格档位，例如分辨率、输入类型以及是否使用参考视频，再按该档位的计费单位和实际用量计算。使用参考视频时，输入、输出都应匹配参考视频档位，不能把无参考视频的输出单价直接套入。按秒计费使用模型返回的计费时长，计费时长可能包含最低时长或取整规则，不能只用文件播放时长推算。

尺寸、质量、提示词、参考图和缓存命中情况也可能影响图片用量。一次请求的费用只能作为对应条件下的样本。公开示例用于预算；查询自己的实际扣费，请按下文保存用量 ID，并使用有权限的管理 Token 查账。

从模型调用到查账

模型调用和管理查询使用两种不同凭据：API_KEY 调用模型，YOUR_MANAGEMENT_TOKEN 查询账单。管理 Token 必须具有 usage:read，不能拿模型 API Key 调用管理接口。

模型请求使用生产 API https://api.creative-reasoning.com，管理查询使用 https://creative-reasoning.com。在 API Key 页面复制完整 API Key，填入下方的 API_KEY；将 YOUR_MODEL 替换为模型目录中支持 Chat Completions 的模型名称。向管理员申请有权查询目标团队账单的管理 Token，将其完整值填入 YOUR_MANAGEMENT_TOKEN。

第一步，调用模型并保存响应头中的 x-cr-usage-id。下面使用 --include 显示响应头；正式客户端应直接从响应对象读取该字段：

curl -i \
  -H "Authorization: Bearer API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"model":"YOUR_MODEL","messages":[{"role":"user","content":"Hello"}]}' \
  "https://api.creative-reasoning.com/unified/v1/chat/completions"

响应会包含两个用途不同的 ID：

x-cr-request-id: 018f1000-0000-7000-8000-000000000004
x-cr-usage-id: 018f1000-0000-7000-8000-000000000004

x-cr-request-id 标识这一次 HTTP 请求，用于排障；x-cr-usage-id 标识账单记录，用于查账。同步推理请求中两者通常相同。异步任务的每次轮询、以及受支持的幂等重试都有新的 request ID，但 usage ID 仍指向原始账单；任务 ID 用于查询生成状态。业务查账只需保存 usage ID，不要用轮询的 request ID 替代它。拿到 usage ID 不代表账单立即可查或计费已完成；普通推理重发不因此获得幂等保证。

流式调用也从初始响应头读取这两个 ID，并继续读取流中的结果。

第二步，将下方的 USAGE_ID 替换为响应头 x-cr-usage-id 中的 UUID，再使用管理 Token 查询。

curl \
  -H "Authorization: Bearer YOUR_MANAGEMENT_TOKEN" \
  "https://creative-reasoning.com/api/v1/management/usage/USAGE_ID"

先检查 billing_status。为 pending 时，按 Retry-After 有限重试；此时 credits 为 null，不是零费用。为 final 时，读取 credits.after_discount 作为已记录费用。final 不代表生成成功，执行结果需从模型响应或任务查询核对。

新调用可能短暂返回 404。仅对自己刚提交的调用有限重试；不存在和无权访问也返回 404。

读取费用和用量

金额单位为 Credits（ℂ），与控制台一致。成功响应通过 X-CRR-Credit-Unit: credits 标明该单位。以 9 个输入 token、14 个输出 token、无组织折扣的调用为例：

{
  "usage_id": "018f1000-0000-7000-8000-000000000004",
  "billing_status": "final",
  "created_at": "2026-09-16T13:52:56.621Z",
  "usage_items": [
    {
      "name": "input:prompt_tokens",
      "usage": 9
    },
    {
      "name": "output:completion_tokens",
      "usage": 14
    }
  ],
  "credits": {
    "before_discount": "0.00553",
    "after_discount": "0.00553"
  }
}

• usage_items 是各计费维度的实际数量，例如输入和输出 token 数。
• credits.before_discount 是按公开标价计算的 Credits。
• credits.after_discount 是应用组织折扣后的最终 Credits，也是本次调用应读取的消费金额。
• created_at 是账单记录的创建时间，不表示计费完成时间。
• 如需展示优惠金额，使用十进制运算计算折前与折后的差值。查账响应只返回上述五个顶层字段。

本例的 "0.00553" 表示消费 0.00553 ℂ，按 1 ℂ = ¥0.20 对应 ¥0.001106。金额是十进制字符串，计算费用时使用十进制运算以保留精度。

批量核对调用

把最多 100 个用量 UUID 放入 usage_ids。下面使用同一个 ID 两次，展示重复项保持不变的行为：

curl \
  -X POST \
  -H "Authorization: Bearer YOUR_MANAGEMENT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"usage_ids":["USAGE_ID","USAGE_ID"]}' \
  "https://creative-reasoning.com/api/v1/management/usage/batch"

HTTP 200 返回按输入顺序排列的 items，不代表每项均已查到或计费完成。对每项先检查 lookup_status：not_found 的 usage 为 null；found 时继续检查 usage.billing_status。批量响应没有逐项的 Retry-After 头，客户端需自行设置有截止时间的退避。

非法 UUID 会拒绝整批。合法但不在 Token 范围内的 ID 与不存在的 ID 均为 not_found。团队 Token 只查本团队，组织 Token 只查本组织；重复 ID 也消耗限流单位。

批量请求被拒绝时，先检查 Content-Type。400 JSON 错误表示 UUID 或批量大小无效。JSON 语法错误返回 400 纯文本；字段类型错误、未知字段或缺少 usage_ids 返回 422 纯文本。遇到 415，设置 Content-Type: application/json；遇到 413，缩小请求体。修正请求后再发送，不将纯文本措辞当作稳定错误码。

查询调用前的有效价格

另外申请独立的 pricing:read。在管理控制台打开目标团队，点击团队名称下方的编号，用复制值替换 TEAM_CODE，例如 T-TU214G，不是团队 UUID：

curl \
  -H "Authorization: Bearer YOUR_MANAGEMENT_TOKEN" \
  "https://creative-reasoning.com/api/v1/management/teams/TEAM_CODE/models/pricing"

读取 effective_pricing 展示当前组织折后单价。pricing 是标价；discount: 7500 表示收取标价的 75%，不是减免 75%。单价单位为 Credits/单个计费单位，保留十进制字符串及阶梯结构。每百万 token 的 Credits 单价等于接口单价乘以 1,000,000；阶梯 up_to 表示对应计费维度的数量上限。

当前价格不能用于重算历史账单，模型在价格列表中也不代表某个 Key 有调用权。历史费用使用上面的查账结果，区间统计按查询 API Key 额度与用量操作。

完整请求、响应字段和权限要求见管理 API。