自研应用接入图灵 API（通用 OpenAI 兼容）

HTTP 请求的形状 通用

1. 方法 POST
2. 路径 /v1/chat/completions
3. 请求头带 Authorization: Bearer 密钥 和 Content-Type: application/json
4. body 里放 model 和 messages

curl https://turingapi.space/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "messages": [{"role": "user", "content": "你好"}]
  }' 

用这条命令先确认账号和网络没问题，再去查客户端配置，能省一半排查时间。

三种协议怎么选 进阶

1. /v1/chat/completions：最通用，几乎所有客户端都走这个
2. /v1/messages：Anthropic 原生协议，Claude Code 这类工具用
3. /v1/responses：OpenAI Responses 协议，Codex CLI 用
4. 同一把密钥在三个路径上都通用

选哪个协议取决于你的客户端，不取决于模型。同一把密钥能调三种协议。

浏览器直连的风险 安全

1. 前端代码里出现的密钥等于公开的
2. 任何人打开开发者工具都能拿到
3. 浏览器直连还可能被 CORS 拦截
4. 正确做法是由后端转发请求

个人自用的小工具问题不大，一旦部署给别人用，必须改成后端转发。

看到这些就说明通了

1. curl 能返回 JSON 格式的补全结果
2. 返回体里有 choices 字段
3. 控制台「用量」页出现记录

curl 通说明账号侧一切正常，剩下的都是客户端配置问题。

通用故障对照表

1. 404 → 地址多了或少了一层 /v1
2. 401 → 密钥错、有空格、或没放 Bearer 头
3. 403 → 余额不足或该模型未授权
4. 502 → 上游线路异常，换个模型重试

curl -H "Authorization: Bearer sk-你的密钥" https://turingapi.space/v1/models

这条命令能一次验掉地址和密钥两个变量，是排查的第一步。