FAQ — 计费与额度

Credits 怎么换算 USD？

控制台展示使用 USD 作为参考币种
实际扣减以 Credits 为单位
不同套餐的「Credits ↔ USD」比例不一样，购买时以套餐价为准

通用公式：

\text{USD} = \text{Credits} \times \frac{\text{package.price}}{\text{package.amount}}

当前主流套餐的换算比例约为 $0.095215 / Credit。

什么时候扣费？

调用类型	扣费时机
同步 API（Chat / Embedding 等）	响应返回时即按 token / 字符 / 次数扣
异步任务（图像 / 视频 / 音频）	任务最终 success 时扣费
任务 failed	一般不扣费（以服务详情页约定为准）
网关 5xx / 上游超时	不扣费
4xx 认证 / 参数错误	不扣费
内容审核拒绝（`forbidden` / `403`）	不扣费

实例余额和通用余额谁先扣？

实例余额（Dedicated）：在某服务下创建的应用所分配的额度，仅用于该服务
通用余额（General Balance）：所有服务通用
默认扣减实例余额；如果实例应用开启了「允许使用通用余额」，实例余额耗尽后会自动落到通用余额扣费。

余额耗尽时 API 会返回什么？

{
  "error": {
    "code": "used_up",
    "message": "Your balance is not sufficient for current request, please buy more in XHuoAPI https://api.xhuoapi.ai"
  },
  "trace_id": "..."
}

HTTP 状态码是 403（不是 402）。请在控制台续费后再调用。

失败请求会扣费吗？

不会扣费的情况：

网关层 4xx（bad_request、invalid_token、used_up 等）
上游 5xx
网关 / 上游超时
内容审核拒绝（forbidden）
异步任务最终 failed

会扣费的情况：

任务最终 success
同步成功响应

怎么退款？

按量套餐通常不支持已使用的退款。具体以购买时的套餐条款 / 控制台公告为准。如确有特殊情况（例如服务长时间不可用），请通过 [email protected] 反馈，并附上凭证 ID（不要发送 Token 全文）、受影响时段、相关请求的 trace_id 列表。

用量怎么查？

控制台「Usage」页可以按服务、时间区间、凭证维度查看用量。每条记录都带 trace_id，方便定位具体调用。

可以共享 Token 吗？

不建议。原因：

出问题时无法定位是哪个使用方
一旦泄漏需要撤销整个 Token
用量按 Token 归集，无法分账

请为每个使用方 / 环境创建独立凭证。

价格总览

按量计费规则

响应格式

所有错误码与状态码

Documentation Index

​Credits 怎么换算 USD？

​什么时候扣费？

​实例余额和通用余额谁先扣？

​余额耗尽时 API 会返回什么？

​失败请求会扣费吗？

​怎么退款？

​用量怎么查？

​可以共享 Token 吗？

​相关