NearToken

外观

认证与约定 ​

请求头 ​

三种协议共用同一枚令牌，只是请求头不同。

OpenAI 兼容接口（/v1/chat/completions、/v1/images/*、/v1/videos、/v1/embeddings、/v1/audio/*、/suno/*）：

http
Authorization: Bearer sk-你的令牌
Content-Type: application/json

Claude 原生接口（/v1/messages）：

http
x-api-key: sk-你的令牌
anthropic-version: 2023-06-01
Content-Type: application/json

Gemini 原生接口（/v1beta/models/{model}:generateContent）：

http
x-goog-api-key: sk-你的令牌
Content-Type: application/json

也可以把令牌放在 URL 的 ?key= 查询参数里，仅建议在 Gemini 客户端的兼容模式下使用。除此之外不要把令牌写进查询参数、前端代码、截图或日志。

令牌与分组 ​

  • 令牌属于某个分组。分组决定这枚令牌能看到哪些模型、按什么价格结算。
  • 令牌还可以单独限制模型范围。GET /v1/models 返回的是两者交集。
  • 403 通常是分组或模型限制不匹配，401 才是令牌本身有问题。

模型清单见模型。

通用约定 ​

  • 请求与响应均为 UTF-8 JSON。
  • 文本对话支持 stream: true，服务端返回 text/event-stream，收到 data: [DONE] 结束。
  • 图片、视频、音乐都是计费较重的调用：先确认任务状态，再决定是否重试，不要因为超时就重复提交。
  • 失败响应统一格式与状态码含义见请求与错误。
  • 每次请求都可以在响应头里拿到请求 ID，反馈问题时请带上它，不要附带令牌。

速率与并发 ​

服务端按令牌和模型做请求频率限制，超限返回 429。收到 429 时按 Retry-After 等待；没有该响应头时使用指数退避。不要把 429 当作失败重试到底。

NearToken