OpenAI 兼容 API 接入指南

一分钟验证接入

先在控制台创建密钥，并复制当前可用的模型 ID。不要把真实密钥写进代码仓库、公开日志或网页。

Shell

export QUICKAICODE_API_KEY="YOUR_API_KEY"

curl https://quickaicode.com/v1/models \
  -H "Authorization: Bearer $QUICKAICODE_API_KEY"

返回模型列表后，再用列表中的模型 ID 发起请求。下面的 YOUR_MODEL_ID 必须替换成控制台或模型接口实际返回的值。

核心兼容端点

GET /v1/models

获取当前密钥可访问的模型列表，适合在配置客户端前检查权限。

POST /v1/responses

Responses API 兼容入口，支持文本输入与流式事件。具体字段取决于模型和分组能力。

POST /v1/chat/completions

Chat Completions 兼容入口，适用于仍使用 messages 格式的客户端。

兼容不等于完全相同

本服务以兼容常见 OpenAI API 用法为目标，但模型范围、工具能力、参数、速率限制与官方服务可能不同。请以实际响应和控制台说明为准。

Chat Completions 示例

curl

curl https://quickaicode.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $QUICKAICODE_API_KEY" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "用一句话说明 API 网关"}],
    "stream": true
  }'

设置 stream: true 后，客户端应按 SSE 增量读取响应，不要等待整个响应完成后再显示内容。

常见状态码

401 未授权

检查 Bearer 前缀、密钥是否完整，以及密钥是否已被删除或禁用。

429 请求受限

降低并发或请求速率，并根据返回信息等待后重试。

5xx 上游异常

保留请求 ID，采用有限次数、带退避的重试，并联系支持定位。

密钥与生产环境建议

使用环境变量或密钥管理服务保存 API Key，不要硬编码。
为不同应用创建独立密钥，便于停用、审计和定位用量。
客户端请求设置合理的连接、首字节和流式空闲超时。
正式上线前验证目标模型、错误处理、流式解析和用量记录。

OpenAI 兼容 API：用熟悉的格式接入