核心概念
双边市场
BYOKS 不仅是 API 网关，还是一个双边市场。你可以作为 Consumer 使用服务，也可以作为 Provider 提供服务。
两种角色
- Consumer（使用者）：发送请求，消费 API 服务
- Provider（提供者）：处理请求，提供 API 额度
Consumer 向 Provider 发送请求并付费，Provider 处理请求并获得收益。
Consumer（使用者）
作为 Consumer，你有两种使用方式：
BYOK 模式
使用你自己的 Provider API Key：
- 费用直接计入你的 Provider 账户
- 完整控制你的配额和限制
- 数据直接流向你的 Provider 账户
// 使用你自己的 OpenAI Key
const response = await client.chat.completions.create({
model: 'gpt-4o', // 你的 OpenAI Key
messages: [...],
});第三方 Provider 模式
使用 BYOKS 市场中其他用户提供的额度：
- 无需自己的 Provider Key
- 按使用量付费给 Provider
- 适合临时使用或试用
// 使用第三方 Provider
const response = await client.chat.completions.create({
model: 'gpt-4o@provider-xyz', // 指定第三方 Provider
messages: [...],
});Provider（提供者）
如果你有多余的 API 额度，可以成为 Provider 赚取收益：
如何成为 Provider
- 在 Dashboard 中添加你的 API Key
- 设置你的定价策略
- 开启 Provider 模式
收益模式
Consumer 请求 → BYOKS 路由 → 你的 Provider → 按量计费 → 结算到你账户
定价策略
你可以设置：
- 基础价格：每 1M token 的价格
- 加成比例：在官方价格基础上的加成
- 最低消费：单次请求的最低收费
数据流向
BYOK 模式：你的应用 → BYOKS Edge → 你的 Provider 账户
第三方 Provider 模式：你的应用 → BYOKS Edge → 第三方 Provider
使用第三方 Provider 时，你的请求内容会经过第三方。请确保你了解并同意这一点。
适用场景
| 角色 | 适用场景 |
|---|---|
| Consumer (BYOK) | 已有 Key，需要统一接口和路由 |
| Consumer (第三方) | 临时使用，不想申请 Key |
| Provider | 有多余额度，想要变现 |