代理转售/接入清单

代理转售接入清单

如果你代理转售 Wokey API,为自己的下游用户提供服务,按下面的顺序检查一遍。每一项都链接到详细说明。

接入清单link

  1. 1

    每个请求带上 X-End-User-Id

    一个 Key 服务很多终端用户时,用这个请求头标明请求属于哪个终端用户。某个终端用户反复违规,Wokey 只限制这个用户,你的其他用户照常使用。企业和中转账号还可以在控制台查看受限用户并自助解除。

    终端用户标识与限制 →

  2. 2

    识别模型拒答

    模型拒答时 HTTP 状态码仍是 200,需要按响应里的字段识别。识别到拒答后提示你的用户修改内容,不要原样重试。

    模型拒答 →

  3. 3

    尽早拦下违规用户

    反复触发拒答会被限流、暂停模型,并收取违规处置费。带不带 X-End-User-Id,违规都会计入你的账号,所以建议在请求发给 Wokey 之前做内容过滤。

    违规处置费与限制 →

  4. 4

    按状态码处理错误

    区分余额不足(402)、限流(429)和上游错误(502、504、529),分别提示或重试。联系客服排查时附上响应头 x-wokey-request-id。

    错误码 →

  5. 5

    监控余额与用量

    用 /v1/dashboard/balance 查询账号余额,用 /v1/usage 和 /v1/key 按 Key 查询用量和剩余额度,余额不足前及时充值。

    余额与用量 →

  6. 6

    需要时指定供应商

    同一个模型有多家供应商时,可以在请求体里用 provider 指定或排除供应商。

    指定供应商 →