计费机制 - OpenPAI Docs

OpenPAI 采用 预付费 + 按 Token 计费 模式,与 OpenAI 官方一致。本文说明每一次调用的实际扣费如何计算。

计费要素

每次成功调用都会产生以下用量项:

项	含义
`prompt_tokens`	你发送给模型的输入 Token 数(含 system / messages / tools 等所有内容)。
`completion_tokens`	模型返回的输出 Token 数(可见 content)。
`reasoning_tokens`	推理模型不可见的思考链 Token(仅 o3 / GPT-5 / Claude thinking / Gemini thinking)。
`cached_tokens`	命中提示缓存的输入 Token。

扣费公式

扣费金额 =
    (prompt_tokens     × 输入价格)
  + (completion_tokens × 输出价格)
  + (reasoning_tokens  × 输出价格)
  + (cached_tokens     × 缓存价格)
  × 用户分组倍率

其中:

输入 / 输出 / 缓存价格 来自各模型的官方定价,以 每百万 Token 美元单价 × OpenPAI 倍率 × 汇率 换算到人民币。
用户分组倍率 由账户所在分组决定,详见基础概念。
缓存价格 通常为输入价格的 0.1× ~ 0.5×,详见缓存计费。

控制台日志示例

调用一次后,日志页面会展示 Token 与扣费明细(不含 prompt / 响应内容):

字段	示例
模型	`gpt-5.5`
输入 / 输出 / 缓存 / 推理 Token	`1024 / 512 / 800 / 0`
倍率	`1.0×`
实际扣费	`¥0.0034`
请求 ID	`req_01ab...`

不同类型模型的计费

对话(Chat / Responses)

按 prompt_tokens + completion_tokens 扣费。若使用提示缓存,缓存命中部分按缓存价格结算。

推理(o3 / GPT-5 / Claude thinking)

reasoning_tokens 按输出价格额外计费(虽不可见但消耗算力)。控制台日志会拆分展示思考与回答 Token。

嵌入(Embeddings)

仅按 prompt_tokens(输入)计费,无输出。

图像生成(DALL·E / gpt-image-1)

按 生成图数量 + 尺寸 计费,每次调用一笔固定扣费。

音频(TTS / Whisper)

TTS 按 输入字符数 计费;Whisper 按 音频时长(秒) 计费。

Midjourney / Suno

异步任务模式,按 任务次数 + 操作类型 计费。失败任务不扣费。

Rerank

按 (query + 所有 documents)的 Token 总和 计费。

失败请求是否扣费

情况	是否扣费
4xx 客户端错误(参数错误、鉴权失败)	❌ 不扣费
5xx 上游错误并自动重试成功	✅ 按成功的那次扣费
全部通道失败,客户端最终拿到 5xx	❌ 不扣费
流式响应中途断连	扣费按实际已生成 Token
客户端 abort	扣费按上游已生成 Token

余额耗尽

账户余额 ≤ 0 时,所有 付费模型 调用立即返回 insufficient_quota(HTTP 403)。部分免费模型(如内容审核 Moderations)仍可继续使用。

查询消耗

控制台 → 日志:逐条调用明细。
控制台 → 使用统计:按日 / 模型 / 令牌聚合的消耗图表。
API:
- GET /v1/dashboard/billing/usage — 时间段消耗
- GET /v1/dashboard/billing/subscription — 当前余额
响应头:每个 API 响应包含 X-OpenPAI-Quota-Consumed 与 X-OpenPAI-Remaining-Quota。

价格调整

新增模型:以接入时官方价格折算上线。
官方调价:OpenPAI 跟随上游调整,提前 24 小时在控制台公告。
降价 / 优惠活动:不定期推送,以控制台 Banner 公告为准。

额度与令牌

账户额度、令牌额度、过期与转移。

缓存计费

OpenAI / Claude / DeepSeek 提示缓存细则。

​计费要素

​扣费公式

​控制台日志示例

​不同类型模型的计费

​失败请求是否扣费

​余额耗尽

​查询消耗

​价格调整

​更多