DocsFlopCodeGateway

API 网关

了解 FlopCode 的 API 网关架构和请求流程。

架构概览

FlopCode CLI 通过 GPUShare 的 API 网关与 AI 模型通信。请求流程如下:

FlopCode CLI
    ↓ (Anthropic Messages API 格式)
api.dflop.top/v1/messages
    ↓ (认证 + 计量 + 转发)
上游 AI 模型服务
    ↓ (SSE 流式响应)
FlopCode CLI

协议格式

API 网关使用 Anthropic Messages API 兼容格式。FlopCode CLI 发送标准的 Messages API 请求,网关负责认证、计量和转发。

POST /v1/messages
Authorization: Bearer <token>
Content-Type: application/json

{
  "model": "...",
  "messages": [...],
  "stream": true,
  "max_tokens": 4096
}

认证方式

网关支持两种认证方式:

  • CLI Token — 通过 /login 获取,存储在 ~/.flopcode/credentials.json
  • API Key — 以 gps_ 开头,在 GPUShare 控制台创建

用量计量

网关会从模型响应中提取 token 使用量,自动累计到用户账户。你可以在 GPUShare 控制台的 Usage 页面查看详细用量。

SSE 流式响应会原样透传给 CLI,网关不会修改响应内容。

速率限制

请求频率受计划等级限制:

计划每日 Tokens每月 Tokens
Free50K1.5M
Pro500K15M
Unlimited无限制无限制

超出额度后请求会返回 429 状态码。升级计划或等待次日额度重置即可继续使用。