快速入门：获取 API 密钥

您的个人中心：一份共用余额、最多 3 个 API 密钥、交易平台兑换码，以及逐条请求的用量记录。可在 Telegram 机器人和 app.oneprovider.dev 使用。

运作方式

• 余额和密钥都在您的个人中心里。机器人和网站使用的是同一个个人中心。
• 您为一份共用余额充值，并自行签发 API 密钥（默认 3 个，客服可以提高上限）。每个密钥在各自的限额内消耗这份余额。
• 当您打开机器人时，旧密钥会连同剩余余额一起转入个人中心。

打开个人中心

登录个人中心与 API 密钥是两回事：调用 API 时凭据仍然是 API 密钥，登录只用于管理余额和密钥。

为余额充值

1. 机器人：“个人中心” → “为个人中心充值”。网站：“余额” → “充值”。
2. 选择充值套餐，或自定义 $100 到 $5000 的金额，再选择支付方式：加密货币、国际银行卡 / Apple Pay / Google Pay、SBP / 二维码。支付前会显示最终金额和手续费。
3. 通过链接或账单支付。余额会自动到账，通常不超过 1–3 分钟。

• SBP/二维码。客户承担 3.5% 的手续费；OneProvider 另外补贴 3.5%。
• 加密货币。收取 3% 的服务商手续费，另加由客户承担的网络费用。

套餐价格见价格页面 ；支付方式见支付方式 。余额不会过期，也没有订阅或自动扣款。已付款但余额没有变化？请把付款凭证发给 @Oneproviderhelpbot 。

交易平台兑换码

在 G2A、Plati、G2G 或类似平台购买？您的订单会附带形如 OP-XXXX-XXXX 的兑换码。机器人：“更多” → “激活兑换码”。网站：“余额” → “OP 兑换码”输入框。订单金额会直接充入个人中心余额；密钥由您自己签发（见下一步）。

签发密钥

1. 机器人：“个人中心” → “签发密钥”。网站：“密钥” → “签发密钥”。
2. 设置名称（例如客户端的名称）、消费限额（或“无限额”）和有效期：最长 90 天，之后可以延长。
3. 请立即复制密钥：完整密钥只显示一次，之后只能在重新登录后通过“显示”查看。

每个客户端或项目使用单独的密钥：您能看到各自的花费，也可以只停用某一个密钥而不影响其他密钥。默认可以有 3 个密钥（客服可按请求提高上限）；如果已达上限，请删除一个，它的余额已经在个人中心里，不会损失任何金额。

密钥格式

密钥以 sk- 开头，后接 64 位小写十六进制字符，例如 sk-50e20199...f837fca1。请把它当作不透明的字符串：其中没有任何可解析的信息。

存放位置

• 本地开发：放在 shell 配置文件里的环境变量，或已加入 .gitignore 的 .env 文件。
• CI：平台的密钥存储（GitHub Actions secrets、GitLab CI variables 等）。
• 生产环境：正规的密钥管理工具，例如 1Password、AWS Secrets Manager、Doppler、Vault。
• 移动端 / 浏览器：绝对不要。密钥必须放在由您控制的服务器代理后面。

用量与余额

个人中心的“用量”页面会列出每一次请求的模型、token 数和价格，并可按密钥筛选。API 也能返回余额：GET /v1/dashboard/balance 。

赠送

新用户赠送和首次充值赠送属于促销优惠：可能仅在限定时间内提供，不可提现，也不予退款（见服务条款 ）。当前可用的优惠会显示在个人中心；优惠过期后，将无法再领取相应赠送。

推荐

个人中心的“推荐”标签页里有您的专属链接。邀请他人即可按个人中心里显示的条款获得奖励。通过您自己的链接注册不会获得奖励。

合并个人中心

如果您有两个个人中心（例如一个在 Telegram，一个在网站），请联系 @Oneproviderhelpbot ：在您证明两者都属于您之后，我们会将它们合并，余额和密钥会汇集到同一个个人中心。

暂停、删除与泄露

• 暂停会停用密钥但不删除它；点击“恢复”即可重新启用。
• 删除会立即停用密钥，且无法撤销。余额仍保留在个人中心。

激活交易平台兑换码：常见问题

OP-XXXX-XXXX 兑换码要在哪里输入？

在 Telegram 机器人中依次选择“更多” → “激活兑换码”。在 app.oneprovider.dev 打开“余额”，使用“OP 兑换码”输入框。订单金额会充入您的个人中心余额；然后按上面“签发密钥”一步签发密钥。

我在 redeem.oneprovider.dev 激活，应该用哪个标签页？

“新用户”会根据兑换码以及订单中的用户名或邮箱创建一个新密钥。“已有密钥的用户”会把兑换码的余额充入您已有的旧 sk- 密钥。同一个邮箱的第二个兑换码不会再创建新密钥：请使用“已有密钥的用户”，或换一个邮箱。

激活后我没有复制密钥

在激活页面再次输入同一个兑换码：点击后即可再次显示密钥。在个人中心签发的密钥，可以在重新登录后通过“显示”查看。

“找不到该兑换码”

请检查字符有没有输错（兑换码以 OP- 开头，后面是两组各四位字符）。已撤销的兑换码或别人的兑换码同样会找不到。请换一个浏览器再试一次，然后联系客服，并附上交易平台的订单号。

兑换码可以退款吗？

通常需要通过您购买兑换码的交易平台发起争议。我们自己的规则见退款政策 。