OpenAI 接口协议

了解通过球球 Token 调用 OpenAI 兼容接口时的鉴权、Base URL 和最小请求。

OpenAI 兼容接口适合用于自研 HTTP 请求、OpenAI 兼容 SDK，以及需要 /v1 Base URL 的客户端配置。Codex CLI、Grok CLI、OpenCode、Cherry Studio 的 OpenAI 通道都使用这一类地址。

Base URL

https://api.qiuqiutoken.net/v1

Chat Completions

POST/v1/chat/completions

https://api.qiuqiutoken.net/v1/chat/completions

Responses

POST/v1/responses

https://api.qiuqiutoken.net/v1/responses

准备信息

准备 API Token。

API Token 在控制台创建。请使用与你要调用的客户端或模型场景匹配的令牌分组。示例使用 sk-your-token 作为占位符，实际请求时请替换为你的 API Token。
确认模型名称。

请求中的 model 必须填写模型广场中的可用模型名。示例里的 <model-id> 只表示占位符。
确认接入线路。

默认使用上方 Base URL。网络不稳定时，到 API 接入线路选择同格式的备用 OpenAI 兼容地址。

最小可用请求

curl https://api.qiuqiutoken.net/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-your-token" \
-d '{
  "model": "<model-id>",
  "messages": [
    { "role": "user", "content": "用一句话介绍球球 Token。" }
  ]
}'

更多协议字段

使用 OpenAI 官方示例时，将 Base URL 换成上方地址，并填入控制台创建的 API Token；请求字段、响应结构和其他端点请查阅 OpenAI 官方 API Reference。