API 对接文档

获取 API Key

1Base URL

-

本站完全兼容 OpenAI 协议,把官方 SDK 的 base_url 换成上面的地址即可。

2可用模型

-

模型名以 GET /v1/models 返回为准。

3获取 API Key

登录用户中心 → 「令牌」→ 新建令牌,即可获得形如 sk-xxxx 的密钥。请求时放入 Authorization: Bearer sk-xxxx

4调用示例

加载中…

5流式输出(SSE)

加载中…

服务端为逐块转发,不做缓冲;响应头带 X-Queue-PositionX-Queue-Wait-Ms

6并发与排队说明

  1. 本站上游并发有限,同一时间只有 max_concurrency 个请求真正打到上游。
  2. 超出并发时,请求会进入队列等待,不会立即返回 429;等待期间连接保持不断。
  3. 流式请求在排队期间会收到 : queued position=N 形式的 SSE 注释行,用于保活。
  4. 只有「队列已满」或「等待超时」时才会失败,错误码分别为 queue_full(429) 与 queue_timeout(503)。
  5. 建议客户端超时设置 180 秒以上,以覆盖排队等待时间。
  6. 排队等待时间不计费。

7错误码

HTTPcode说明处理建议
401missing_api_key / invalid_api_key / token_disabled / user_disabled密钥缺失、无效、令牌或账户被禁用检查 Authorization 头与令牌状态
402insufficient_balance余额不足充值后自动恢复
404model_not_found模型不存在通过 GET /v1/models 查询
413payload_too_large请求体超过 1MB精简请求体
429queue_full服务繁忙,排队已满退避后重试
503queue_timeout排队超时稍后重试
504upstream_timeout上游连接/读取超时稍后重试
5xxupstream_error上游服务异常(原样透传)按上游错误处理

错误响应统一为 OpenAI 格式:{"error":{"message":"...","type":"...","code":"..."}}

免责声明

加载中…
登录·服务条款·隐私政策