常见问题
一、计价与余额
算粒和人民币是什么关系？
算粒是本站唯一的计价单位，1 元 = 1,000,000 算粒。模型单价按「算粒 / 千 Token」标价，人民币只是同一价格的折算显示。
算粒会过期吗？
不会。钱包算粒永不过期。只有模型权益套餐按天计算有效期。
买了模型权益套餐，调用还扣算粒吗？
不扣。包期内该模型调用免扣算粒。
套餐里的额度用完了会自动转按量扣费吗？
不会。计费来源是二选一，不是先套餐后按量的瀑布：
- 命中覆盖该模型的有效权益套餐 → 免扣算粒（本次调用算粒消耗为 0）；
- 没有命中套餐 → 直接按算粒从钱包扣费。
套餐到期后，该模型恢复按量计费。
套餐里含多少算粒？
模型权益套餐不发放任何额度。它决定的是「能不能用某个模型」。算粒只能通过充值获得。
为什么账单上算粒和人民币对不上小数位？
算粒按调用结束后向上取整到整数，人民币是按同一比例折算显示，两者口径一致，只是取整时机不同。
二、接入与调用
已有 OpenAI 代码怎么接？
请求体与响应格式沿用 OpenAI Chat Completions 的约定，改三处：
- 请求地址换成
https://www.hgzscloud.fun/admin-api/ai/chat/completions（这是完整端点，不是 OpenAI SDK 约定的 {base_url}/chat/completions，官方 SDK 直接指向会 404，需覆写请求路径）； - Authorization 换成
Bearer <你的 API Key>； - 请求体补上
stream: true与stream_options: { include_usage: true }。
API Key 和网站登录令牌是一回事吗？
不是。调用模型接口必须用控制台创建的 API Key，网站登录令牌只用于登录控制台。
支持流式输出吗？
支持，且这是必需方式。接口固定按流式返回，把 stream 设为 true， 并带上 stream_options.include_usage 才能拿到本次用量； 响应是 SSE 分片，以 data: [DONE] 结束。
密钥泄露了怎么办？
到控制台把该密钥禁用，再创建一枚新的。密钥只在创建时完整展示一次，丢失后只能重建。
调价会影响历史账单吗？
不会。每次调用都会保存当时的价格快照，历史账单按当时的单价计算。
有并发限制吗？
有。单个 API Key 的并发请求数受套餐与模型共同约束，超出后会返回限流错误。
- 遇到 429 时不要立刻重试，建议做指数退避重试（例如 1s、2s、4s 依次递增），并设置最大重试次数。
- 批量任务请在客户端侧排队并发控制，不要把所有请求一次性打出去。
- 需要更高并发时，联系商务确认当前密钥的并发上限，可按业务线申请调整。
模型不可用（报错或返回空）怎么办？
先在模型广场确认模型状态，常见原因与处理如下：
| 现象 | 常见原因 | 处理 |
|---|---|---|
| 返回 404 / model not found | model 值写错，或模型已下架 | 核对模型广场展示的 model 值，换成在售模型 |
| 返回 503 / 暂时不可用 | 上游通道临时维护或拥塞 | 退避后重试；持续失败时查看模型广场的可用状态 |
| 调用被拒绝，无计费记录 | 该密钥没有覆盖该模型的调用权限 | 检查密钥的模型范围，或购买覆盖该模型的权益套餐 |
| 返回空内容 | 输入为空，或参数（如 max_tokens）过小 | 检查请求体，给足输出预算 |
模型下架或维护不会影响已产生的账单，历史用量记录按当时的模型与价格快照保留。
三、套餐与订单
支持哪些支付方式？
微信扫码、支付宝扫码；模型权益套餐还可以直接用钱包算粒支付。
套餐能退款吗？
可以按订单实际支付渠道原路退回。退款会同步扣回已发放的算粒，扣回后余额不足的订单无法完成退款。
可以开发票吗？
企业用户联系商务获取对公结算与发票支持。
续费是怎么算的？
续费是在原套餐上延长有效期，不会产生第二份权益记录。
四、算力节点
什么样的设备可以接入？
带独立显卡的 PC 或工作站都可以。客户端会自动做设备体检并给出评分，评分决定这台设备能承接哪些模型。
接入后有收益吗？
有。设备上线后自动领取推理任务，贡献的 token 计入收益，按平台周期结算。
会不会影响我日常使用电脑？
客户端支持设置显存占用上限，建议在闲置时段运行。