TokenMark 开发者文档

常见问题

充值与到账

充值后多久到账? 通过 Stripe 收银台完成支付后实时到账。若长时间未到账,请检查浏览器是否被拦截(Stripe 收银台弹窗),或联系平台运营核对订单号。

为什么余额是积分不是元? 平台以积分展示余额(1 积分 = 0.01 元),充值档位与赠送均按积分计算;财务结算仍以人民币精确金额为准。

发票与退款

能否开具发票? 可以。对已支付的充值订单,可在门户「账单」页申请电子发票(自动生成的 HTML 电子发票,含票号与计税);平台管理员可开具与作废。

如何申请退款? 联系平台运营提交退款申请,经审核后原路退回或转为余额。退款仅针对未消费的余额部分。

密钥与安全

密钥泄露了怎么办? 在门户「API 密钥」页轮换密钥:新密钥立即生效,旧密钥进入 24 小时宽限期(宽限期内仍可用,便于平滑切换),随后作废。

IP 白名单怎么配? 在密钥设置中填写来源 IP(支持精确 IPv4 与 IPv4-CIDR)。设置后仅白名单内 IP 可调用,白名单外的请求返回 403。

一个账户能建几个密钥? 不限。建议按环境(开发/生产/内网)分别建密钥,并各自设置用量上限与白名单。

限流与错误

为什么返回 429? 单密钥存在并发与速率上限(防止误用)。降低并发、对重试做指数退避即可。

返回 402 但余额明明够? 检查是否为密钥级用量上限或账户日消费上限命中(错误信息会区分),可在门户「用量」页查看明细。

返回 400 校验失败? 确认 model 存在(GET /v1/models 查看该账户可用模型)且 messages 结构合法;不同账户等级的可用模型范围不同。

账户与隐私

平台会保存我的对话内容吗? 平台为 API 转售模式:转发请求时仅做费用预估与处理,不存储请求/响应内容;计费审计仅保留 model / tokens / 延迟 / 状态 / 费用等元数据。

如何注销账户? 在门户「设置」页可提交账户注销(合规删除),处理后相关数据将按隐私政策处理。

忘记密码? 门户登录页点「忘记密码」,验证码将发送至注册邮箱。