16688AI使用文档
使用指南

通用 API 接入

更新于 2026 年 11 月 2 日 · 16688AI

软件通常只需要三项:地址、密钥、模型。

输入框填写什么如何判断
Base URL / API 地址https://api.16688.org/v1用于 OpenAI 兼容客户端,不要再附加 /chat/completions
API Keysk-***替换为本站 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,不是对所有接口和能力的承诺。切换模型后,应重新发出一次最小请求。图片编辑、视频任务、工具调用、长上下文和多轮续接不在上述三个最小请求的验证范围内。