OneProvider

分销商 API 方法参考

所有分销商 API 端点汇总在一张表里，含权限范围和幂等标记，并附 OneProvider 的 OpenAPI 3.1 规范链接，可直接导入。

分销商 API 的所有接口汇总在一张表中，列出各自的权限和幂等标志，并附 OpenAPI 3.1 规范的链接。

全部模型、功能与价格 面向 AI 智能体的文档索引： https://oneprovider.dev/docs/llms.txt

Base URL：https://app.oneprovider.dev/partner/v1。机器可读的 OpenAPI 3.1 规范：https://app.oneprovider.dev/partner/v1/openapi.yaml （公开，无需 token）。

“Idempotency”列标出了需要 Idempotency-Key 请求头的方法。权限“any”表示任何有效 token，“none”表示无需 token。

API 方法
方法路径ScopeIdempotency用途
GET/meany-Token、权限、分销商。
GET/balanceread-分销商余额、已预留、可用、批发价、充值服务商。
GET/balance/transactionsread-余额交易记录（cursor）。
POST/balance/topupsbilling必需创建充值支付，返回 pay_url。
GET/balance/topups/{order_id}billing-您自己的支付状态。
GET/pricingread-批发价、折扣、限制。
GET/modelsread-模型目录及实时状态。
GET/customersread-客户列表（?external_id=）。
GET/customers/{id}read-单个客户。
POST/customerskeys-创建客户。
PATCH/customers/{id}keys-修改 name、note，封禁（blocked）。
GET/customers/{id}/usageread-某个客户所有有效密钥的用量，按天和按模型（?days=1..90）。
GET/keysread-密钥列表（?status=、?query=、?customer_id=）。
GET/keys/{id}read-不含密钥本身的密钥，带 dashboard_url。
GET/keys/{id}/usageread-密钥按天和按模型的用量（?days=1..90，默认 30）。
POST/keyskeys必需发放密钥；密钥本身只返回一次。
POST/keys/bulkkeys必需一次发放多个相同的密钥。
PATCH/keys/{id}keys-额度、有效期（expires_days/hours）或延长（extend_days/hours）、名称、客户标记。
DELETE/keys/{id}keys-删除密钥（200 或 202）。
POST/keys/{id}/topupkeys必需为密钥额度增加一笔金额。
POST/keys/{id}/rotatekeys必需重新发放密钥：生成新密钥，旧密钥失效。
POST/keys/{id}/pausekeys-暂停密钥。
POST/keys/{id}/resumekeys-恢复密钥。
POST/orderskeys必需客户已付款的订单：新密钥或充值。
GET/ordersread-订单列表（?external_order_id=）。
GET/orders/{id}read-单个订单。
GET/plansread-您的套餐。
POST/plansplans-创建套餐。
PATCH/plans/{id}plans-修改套餐。
DELETE/plans/{id}plans-删除套餐。
GET/code-batchescodes-兑换码批次列表。
POST/code-batchescodes必需创建兑换码批次。
GET/code-batches/{id}codes-单个批次。
GET/code-batches/{id}/codescodes-批次中的兑换码（?status=）。
POST/code-batches/{id}/revokecodes-作废未兑换的兑换码。
GET/codes/{code}codes-兑换码的状态。
POST/codes/{code}/redeemcodes必需把兑换码兑换成密钥。
GET/statsread-按天统计（?days=1..90）。
GET/auditread-操作日志（筛选项 period、actor、action、q）。
GET/botbot-店铺机器人和客服机器人（不含 token）。
GET/settingsread-店铺设置：名称、联系方式、品牌、密钥前缀、给客户的消息。
PATCH/settingskeys-修改店铺设置（只修改传入的字段）。
GET/payment-providersbot-机器人的支付方式：CryptoBot、xRocket、Platega（不含 token）；Stars 始终开启。
GET/webhookswebhooks-Webhook 列表。
POST/webhookswebhooks-创建 Webhook；secret 只显示一次。
DELETE/webhooks/{id}webhooks-删除 Webhook。
POST/webhooks/{id}/testwebhooks-发送测试事件。
GET/webhooks/{id}/deliverieswebhooks-投递日志。
GET/openapi.yamlnone-OpenAPI 3.1 规范（公开）。

通用规则（分页、错误、限制）见授权与限制 。

最后更新: 2026-11-08 发现问题？ @Oneproviderhelpbot