GPT 系列:CLI 与 VS Code / Cursor 完整部署指南
GPT 系列走 OpenAI-compatible 接口。新项目推荐优先验证 Responses API,同时保留 Chat Completions 兼容方式。
1. 适用场景
- 命令行 CLI 或自研脚本调用 GPT 模型。
- VS Code / Cursor 中配置 Continue、Cline、Roo Code 等插件。
- 任何支持 OpenAI-compatible Base URL 的客户端。
2. 核心配置
| 项目 | 值 |
|---|---|
| Provider | OpenAI-compatible |
| Base URL | https://api.synterolink.com/v1 |
| API Key 环境变量 | OPENAI_API_KEY |
| 推荐默认模型 | gpt-5.4 |
| 推荐验证端点 | /v1/models、/v1/responses、/v1/chat/completions |
3. 推荐模型
| 模型 | 推荐用途 | 备注 |
|---|---|---|
gpt-5.4 | 默认通用、代码、复杂任务 | 首选默认模型 |
gpt-5.4-mini | 轻量任务、速度优先、成本敏感 | 适合日常问答和简单代码 |
gpt-5.5 | 高质量输出、复杂推理 | 如账号已开通可优先用于高级任务 |
4. CLI 环境变量
export OPENAI_API_KEY="your_synterolink_key"
export OPENAI_BASE_URL="https://api.synterolink.com/v1"
如果客户端只接受 Base URL 填写框,就填写:
https://api.synterolink.com/v1
5. 验证模型列表
curl https://api.synterolink.com/v1/models \
-H "Authorization: Bearer $OPENAI_API_KEY"
成功标准:返回模型列表,且能看到你准备使用的模型 ID。
6. 验证 Responses API
curl https://api.synterolink.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-5.4",
"input": "Reply exactly: OK"
}'
说明:OpenAI 官方推荐新项目优先使用 Responses API;Chat Completions 仍可作为兼容接口使用。
7. 验证 Chat Completions
curl https://api.synterolink.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-5.4",
"messages": [
{"role": "user", "content": "Reply exactly: OK"}
]
}'
8. VS Code + Continue 示例
models:
- title: SynteroLink GPT 5.4
provider: openai
model: gpt-5.4
apiBase: https://api.synterolink.com/v1
apiKey: ${{ env.OPENAI_API_KEY }}
配置后,在 Continue 中发一句:Reply exactly: OK。
9. Cursor / Cline / Roo Code 配置
| 字段 | 填写 |
|---|---|
| Provider | OpenAI-compatible / OpenAI API compatible |
| Base URL | https://api.synterolink.com/v1 |
| API Key | 你的 SynteroLink key |
| Model | gpt-5.4 |
10. 成功验收清单
/v1/models能返回模型列表。/v1/responses能返回正常文本。- 编辑器内同一个模型能正常回答。
- 失败时先看 HTTP 状态码,再看模型名和 Base URL。
11. 常见错误
| 现象 | 原因 | 处理 |
|---|---|---|
| 401 Unauthorized | Key 错误、过期、复制多了空格 | 重新复制 key,确认 Bearer 前缀 |
| 404 Not Found | Base URL 不带 /v1 或路径错 | 使用 https://api.synterolink.com/v1 |
| model not found | 模型名拼错 | 使用模型矩阵里的精确模型 ID |
| timeout | 网络或上游响应慢 | 减少输入,稍后重试,检查代理 |
| VS Code 插件不生效 | 插件 provider 选错 | 选择 OpenAI-compatible |