计费与回执
你的工作区有一份美元余额,模型调用、沙盒和云主机都从这里扣钱。这份余额来自你 Yi Labs 账号里的付费额度。每次调用、每个资源开始前都先预扣它最多可能花的钱,实际扣费不会超过预扣。余额不会变成负数。
当前价格见控制台的价格页。模型价格也在 GET https://cloud.theyilabs.com/v1/catalog,沙盒和云主机的规格价格在 GET https://cloud.theyilabs.com/v1/compute/classes。
余额
「账单」页显示:
| 数字 | 含义 |
|---|---|
| 「Yi Labs 钱包」 | 你的 Yi Labs 钱包里 Yi Cloud 能用的钱,旁边有按钮去 Yi Labs 账号充值或换套餐。 |
| 「可用余额」 | 新的调用和资源能用的钱,等于工作区余额减去已预扣的部分。 |
| 「余额」 | 工作区所有入账减去所有扣费。 |
| 「已预扣」 | 还没结算的调用和资源占着的预扣。 |
「概览」页显示可用余额、已预扣的金额和本月用量。
为 Yi Cloud 付费
Yi Cloud 的费用从你 Yi Labs 账号里的付费额度扣。要加钱,请在 Yi Labs 账号里充值或选一个付费套餐:https://account.theyilabs.com/billing。
- 付费额度可以用:充值,以及付费套餐包含的额度。
- 免费额度不能用在 Yi Cloud:每月的 $5 和新用户的 $20 都不行。
你不用自己把钱转到 Yi Cloud。调用或资源需要的钱超过工作区余额时,Yi Cloud 会从你的 Yi Labs 钱包里取一小笔,流水里记作「人工调整」。没用完的会退回你的 Yi Labs 钱包,同样记作「人工调整」。Yi Labs 账号只按你实际用掉的扣钱。工作区原本就有余额的话,先用这部分。
工作区和 Yi Labs 钱包都付不起预扣时,请求返回 402 insufficient_funds,提示里会写明原因:钱不够(免费额度不算),或者 Yi Labs 账号有欠款。Yi Labs 账号被暂停时返回 403 forbidden。
预扣与结算
| 项目 | 开始前预扣 | 扣费 |
|---|---|---|
| 模型调用 | 估算的输入 token 加最大输出 token,按模型价格算 | 调用结束时,按模型报告的 token 扣 |
| 沙盒 | 每小时价格 × timeout_s | 结束时,从可用到删除按秒扣,最低 60 秒 |
| 云主机租期 | 每小时价格 × hours | 云主机第一次运行起来时全额扣 |
| 云主机续费 | 每小时价格 × hours | 当场扣 |
| 停机的云主机 | 停机时长对应的保留费用 | 每满一小时扣一次,启动或删除时不足一小时的部分按秒扣 |
调用或资源结束时,按实际费用扣款,预扣剩下的部分释放。如果实际费用超过了预扣,你只付预扣的金额,超出部分由我们承担。模型请求失联后留下的预扣,会在 30 分钟内释放。
不收费的情况
- 还没有任何输出就失败的模型调用。
- 一直没有变成可用的沙盒。
- 一直没有运行起来的云主机。
没有月度上限
没有月度消费上限,唯一的限制是钱:余额够就能用 Yi Cloud。
- 只有付费额度算数,见为 Yi Cloud 付费。
- 余额付不起下一笔预扣时,新的工作返回
402 insufficient_funds。已经预扣好的工作可以做完。 - Yi Labs 账号有欠款时,新的工作会被拒绝,提示里会写明原因。
- Yi Labs 账号被暂停后,几秒内(最多约一分钟)新的工作返回
403 forbidden。已经跑过的照常收费,其余的钱退回 Yi Labs 钱包。 - 「账单」页显示本 UTC 月已消费和已预扣的金额。
key 还可以有自己的花费上限,见 API Key 与限额。
各项怎么计费
- 模型:按 token。输入、缓存输入和输出分别按每百万 token 定价。每次调用向上取整到微美元。模型没有报告用量时会估算,并标为「估算」。见模型 API。
- 沙盒:按秒,最低 60 秒,从可用到删除。见沙盒。
- 云主机:租期按整小时预付,停机不退。停机后磁盘和 IP 按停机保留费用计费,停机满 24 小时后删除。见云主机。
价格在调用或资源开始时固定。沙盒和云主机一直按创建时的每小时价格和停机保留费用计费,续费也一样。
流水与回执
| 在哪里 | 内容 |
|---|---|
| 「账单」页的「流水」 | 每一笔记录,带 UTC 时间、类型、金额和之后的余额。类型有「预扣」「结算」「释放预扣」「人工调整」「充值」和「退款冲销」。 |
| 「账单」页的「导出 CSV」 | 最近 500 条流水,列为 time_utc、kind、amount_usd、balance_after_usd、held_after_usd、ref。 |
| 「账单」页的「每日模型 API 回执」 | 某个 UTC 日期里,按模型和 key 统计的请求数、token 数和金额。「下载 CSV」可以保存。 |
| 「模型 API」页的「下载用量 CSV」 | 最近 30 天的模型用量,按日期、模型和 key 统计。 |
| 「模型 API」页的「最近请求」 | 最近的每次调用,带模型、状态、费用和耗时。 |
| 「沙盒」和「云主机」页的「下载用量回执」 | 单个资源的每一笔扣费。 |
GET /v1/sandboxes/{id}/receipt、GET /v1/vms/{id}/receipt | 同上,按资源返回 JSON,加 ?format=csv 返回 CSV。 |
资源的 JSON 回执里有 rows(每一笔扣费的 kind、quantity、amount_micro 和时间)、total_micro、资源的每小时价格和停机保留费用,以及 final。资源删除、不会再有扣费之后,final 为 true。
流水只会追加,不会被修改或删除。
API 里的金额
API 里的金额都是以微美元为单位的整数,1 美元 = 1,000,000。例如 2500000 是 2.50 美元。表示金额的字段以 _micro 结尾,比如 price_micro_per_hour 和 total_micro。