OpenAI API 国内怎么用？GPT 接入教程：SDK / Cursor / 报错排查

一句话答案：OpenAI API 在国内可以稳定调用——通过 API 聚合平台拿 Key，把 base_url 指向 https://api.yomiapi.com/v1，官方 OpenAI SDK、Cursor 及各类兼容工具都能直接接上。下面给三步拿 Key 和三套接入配置，附完整报错排查。

引言

上个月，做电商的小团队找到我：他们要上线一个客服机器人，产品方案都定好了，模型选的是 GPT。卡住他们的不是 prompt，而是官方平台的注册与支付——海外卡、账单地址、实名验证，折腾一周还是过不去，项目原地待命。

这个场景很典型：GPT 模型本身没问题，国内团队真正被卡住的是接入这第一公里。聚合平台解决的就是这一段——注册用邮箱，充值用人民币，接口完全兼容 OpenAI 格式，现有 SDK 代码几乎不用动。本文按"三步拿 Key → 三套接入方案 → 报错排查"的顺序，给一份可以直接照抄的教程。

关键要点

  • 三步拿 Key：注册 → 控制台 #keys 生成 → 复制 base_url（https://api.yomiapi.com/v1，末尾带 /v1）。
  • 方案一：官方 OpenAI SDK，Python 与 Node.js 改一行 base_url，模型用 gpt-5.5、gpt-5.6-sol（以模型广场实际列表为准）。
  • 方案二：Cursor 在 Settings → Models 里填 Override OpenAI Base URL。
  • 方案三：任何支持自定义 base_url 的 OpenAI 兼容工具，按同一套思路接入。
  • 报错表：401 / 403 / 429 / 500，403 重点查密钥权限与余额。
  • 微信 / 支付宝人民币充值，输入输出分别按 token 计价，消费明细笔笔可查。

三步拿 Key：注册、生成、复制 base_url

拿 Key 这件事，聚合平台比官方流程轻得多，全程没有海外支付环节。

第一步，注册——访问 Yomi API，用邮箱完成注册，只需要一个能收邮件的邮箱。

第二步，生成 Key——进控制台的 Keys 页面，一键生成。平台支持按项目建多个 Key，权限与额度相互隔离，建议一个项目一个 Key，泄露后单独禁用重建，不影响线上其他服务。这步别偷懒，多建一个 Key 花不了十秒钟。

第三步，复制 base_url——OpenAI 兼容地址是：

https://api.yomiapi.com/v1

注意末尾带 /v1。到这一步，你手里有三样东西：api_key、base_url、model。下面三套方案，全部基于这三个信息。

方案一：官方 OpenAI SDK，Python 与 Node.js 双示例

Python 和 Node.js 是接 GPT 最常用的两种语言，官方 SDK 可以直接用，只改配置不动代码。以 Python 为例：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的Yomi-API-Key",        # 控制台 Keys 页生成
    base_url="https://api.yomiapi.com/v1" # OpenAI 兼容地址，末尾带 /v1
)

resp = client.chat.completions.create(
    model="gpt-5.5",                      # 模型名以模型广场实际列表为准
    messages=[{"role": "user", "content": "你是客服机器人，写一句欢迎语"}]
)
print(resp.choices[0].message.content)

Node.js 是同一套路：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的Yomi-API-Key",
  baseURL: "https://api.yomiapi.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-5.6-sol",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

日常对话选 gpt-5.5，深度推理选 gpt-5.6-sol。两个模型的具体参数可以看 GPT-5.5 模型页 和 GPT-5.6 SOL 模型页，更多模型在 模型广场 挑，以实际列表为准。响应结构与 OpenAI 官方一致，流式、工具调用、多轮对话都按原样用。

接入后怎么确认生效？把上面的示例跑一次，能正常返回内容就说明通道通了。正式业务里建议打开 stream=true 流式输出，首字返回更快，长回复也更稳。做 agent 或带工具的流程时，function calling 直接可用，参数格式与官方文档一致，不需要额外适配。

第一次跑通后，建议花几分钟把 gpt-5.5 与 gpt-5.6-sol 各试一轮，感受一下回复风格与速度差异。客服、文档问答这类短任务用 gpt-5.5 更划算，长文总结、复杂分析再上 gpt-5.6-sol。两个模型之间切换只改 model 字段，线上改配置即可，不用动代码。

方案二：Cursor 配置，Override OpenAI Base URL

Cursor 是不少团队的主力 IDE，接 GPT 不需要装插件，改两个设置就行。操作路径：

  1. 打开 Cursor → Settings（设置）→ Models（模型）。
  2. 在 OpenAI API Key 处填入 Yomi 的 Key。
  3. 在 Override OpenAI Base URL 处填入 https://api.yomiapi.com/v1。
  4. 添加模型名 gpt-5.5，保存后对话与补全里就能选到。

Override 打开后，模型列表按你填的名字加载。不在列表里的模型名记得手动补上。填完点 Save，重启 Cursor 让配置生效。日常写代码时，对话、补全、代码审查都会走同一个通道，账单统一记在控制台，按 token 计量。

方案三：其他 OpenAI 兼容工具，一套通用思路

除了 SDK 和 Cursor，还有一批客户端支持自定义 base_url：ChatGPT-Next-Web、LobeChat、各类开源面板，以及团队自研的网关。它们的接入逻辑完全一致，四步搞定：

  1. 找到工具里的"自定义 API 地址 / Base URL"设置项。
  2. 填入 https://api.yomiapi.com/v1。
  3. 填入 Key。
  4. 填模型名，开始对话。

填模型名时注意用线上真实 id，比如 gpt-5.5 而不是"GPT-5.5"，大小写和连字符都不能错，否则会提示模型不存在。这套思路适用面很广，只要是 OpenAI 兼容协议，接法就一样。

接生产代码前，优先选数据不存储、走 TLS 1.3 加密、消费明细可查的聚合平台。网上有些来路不明的低价接口，价格离谱、密钥来源不清，2026 年 6 月 8 日国家安全部发布过"AI 中转站"风险提示，点名数据裸奔、模型缩水、恶意植入、数据出境四类问题——别拿业务数据去试错。

报错排查：401 / 403 / 429 / 500

接入期最常见的四类报错，先对表定位再动手。说句实话，九成问题出在 Key 和 base_url 的抄写上，先复查这两处，再看下表。

报错含义排查步骤
401 Unauthorized 鉴权失败 Key 是否复制完整、有没有多余空格；Key 是否被禁用；base_url 是否漏了 /v1 或多了末尾斜杠
403 Forbidden 权限或余额不足 控制台查看余额是否为 0，欠费后请求会被拒绝；检查该 Key 的权限范围与绑定的模型是否对应
429 Too Many Requests 触发限流 检查并发是否过高；按项目拆分多个 Key 分摊；控制台查看当前用量与配额
500 Internal Server Error 服务端异常 多为瞬时波动，稍后重试；开启流式（stream=true）降低单次超时风险；平台智能路由会自动切换可用线路

403 在接入期最容易被忽略：先看余额，再看密钥权限。这两项在控制台里都是一眼能看到的信息，比改代码快得多。如果表里没有你的报错，把完整错误信息贴到控制台接入文档对应页面核对，多数情况是配置拼写问题。

人民币充值：先小额验证，再放量

钱这块，官方渠道的美元结算与双币卡是第二道坎，聚合平台直接换成人民币。支持微信、支付宝充值，按 token 计量，输入输出分别计价，模型不同单价不同，页面都标得清楚。

建议先充几十块跑通流程，确认稳定再放量。把上面三套方案各试一遍，看延迟与稳定性，符合预期再加大额度。全球节点低延迟接入，实际请求往返时间在多数业务场景下都够用。跑一次请求花多少钱，控制台消费明细里逐笔可见，没有隐藏扣费，小团队可以先按周看账单，习惯用量后再决定是否包月。

写在最后

回到那个卡在海外支付的客服项目——换个接入方式后，团队当天下午就跑通了第一条消息，第二周机器人上线，之后只调 prompt，再没碰过注册和账单。

OpenAI API 国内怎么用？答案不在模型，在接入路径：把注册、支付、路由这几道坎交给聚合平台，自己专注业务。GPT 模型国内用不了怎么办，本质是同一个答案——选一条可靠的通道，而不是反复试官方流程。

如果你也要接 GPT，按顺序走一遍：注册拿 Key → 跑通一个 SDK 示例 → 用 Cursor 日常调试。平台目前聚合 GPT/Claude/Gemini/DeepSeek 等 200+ 模型 · 30+ Providers，GPT 与 Claude 可同 Key 混用，换模型只改一个字段，都在同一个控制台管理。想了解一个 Key 怎么覆盖全部模型，可以看一个 Key 接入指南。

现在动手：先把第一条 GPT 请求跑通，后面的事边用边看。

领取 API Key，今天跑通第一次调用 →

相关链接