使用指南
通用 API 接入
软件通常只需要三项:地址、密钥、模型。
| 输入框 | 填写什么 | 如何判断 |
|---|---|---|
| Base URL / API 地址 | https://api.16688.org/v1 | 用于 OpenAI 兼容客户端,不要再附加 /chat/completions |
| API Key | sk-*** | 替换为本站 API 密钥页面复制的完整密钥 |
| Model / 模型 | gpt-5.6-sol | 使用本次基础实测通过的模型 ID |
Chat Completions:最小 curl 请求
下面是 macOS / Linux 终端写法。Windows 请使用PowerShell 版本,不要原样复制反斜线换行写法。
Bash / curl
curl https://api.16688.org/v1/chat/completions \
-H "Authorization: Bearer sk-***" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"Reply exactly OK."}],"max_tokens":128}'成功响应中的 choices[0].message.content 应为 OK。只看到 HTTP 200 还不够,还要检查响应正文是否包含有效结果。
Codex 所需的 Responses
完整端点是 POST https://api.16688.org/v1/responses,使用 Authorization: Bearer sk-*** 和 Content-Type: application/json。实测请求正文如下:
JSON
{
"model": "gpt-5.6-sol",
"input": [
{
"role": "user",
"content": "Reply exactly OK."
}
],
"stream": true,
"store": false,
"max_output_tokens": 128
}这是流式响应:先读取 response.output_text.delta 的文字,最后确认 response.completed 事件及 response.status = completed。中途收到文字、收到 HTTP 200 或仅收到流结束,都不能单独证明任务完整成功。
Claude Messages
完整端点是 POST https://api.16688.org/v1/messages。本次实测使用 Authorization: Bearer sk-***,同时发送 anthropic-version: 2023-06-01 与 Content-Type: application/json:
JSON
{
"model": "claude-sonnet-4-6",
"messages": [
{
"role": "user",
"content": "Reply exactly OK."
}
],
"max_tokens": 32
}成功响应的 content 数组中应有文本 OK。API Key 放在请求头中,不要放进网址参数。
列出当前密钥可见的模型
Bash / curl
curl https://api.16688.org/v1/models -H "Authorization: Bearer sk-***"模型列表用于发现候选 ID,不是对所有接口和能力的承诺。切换模型后,应重新发出一次最小请求。图片编辑、视频任务、工具调用、长上下文和多轮续接不在上述三个最小请求的验证范围内。