已验证指南更新于 2026-05-15仅使用占位符

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. 核心配置

项目
ProviderOpenAI-compatible
Base URLhttps://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 配置

字段填写
ProviderOpenAI-compatible / OpenAI API compatible
Base URLhttps://api.synterolink.com/v1
API Key你的 SynteroLink key
Modelgpt-5.4

10. 成功验收清单

  • /v1/models 能返回模型列表。
  • /v1/responses 能返回正常文本。
  • 编辑器内同一个模型能正常回答。
  • 失败时先看 HTTP 状态码,再看模型名和 Base URL。

11. 常见错误

现象原因处理
401 UnauthorizedKey 错误、过期、复制多了空格重新复制 key,确认 Bearer 前缀
404 Not FoundBase URL 不带 /v1 或路径错使用 https://api.synterolink.com/v1
model not found模型名拼错使用模型矩阵里的精确模型 ID
timeout网络或上游响应慢减少输入,稍后重试,检查代理
VS Code 插件不生效插件 provider 选错选择 OpenAI-compatible