自己写程序(curl / Python / Node) 接入教程
一个 key 三种接口:OpenAI Chat、Responses、Claude Messages,官方 SDK 改个地址就能用
- 接口:OpenAI Chat Completions
- 地址写法:写到 /v1(https://gpt.cherrychat.org/v1)
- 推荐模型:gpt-6.1-sol、claude-sonnet-5-5、deepseek-v4-flash
- 平台:macOS、Windows、Linux
接入步骤
记下接入三件套
同一把 key 三种接口格式都能用。用 OpenAI 的 SDK 时地址写到 /v1;用 Anthropic(Claude)的 SDK 时地址只写域名。
- Base URL(OpenAI 格式):https://gpt.cherrychat.org/v1(Chat 和 Responses 都用这个)
- Base URL(Anthropic 格式):https://gpt.cherrychat.org(只到域名,SDK 自己补 /v1/messages)
- API Key(密钥):sk-你的密钥
- 模型名:gpt-6.1-sol
先用 curl 测通
复制到终端运行,返回一段 JSON、里面有 "content" 就说明地址和 key 都对。
macOS / Linux
curl https://gpt.cherrychat.org/v1/chat/completions \ -H "Authorization: Bearer sk-你的密钥" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "你好"}]}'Windows(PowerShell)
$body = @{ model = "gpt-6.1-sol" messages = @(@{ role = "user"; content = "你好" }) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Method Post -Uri "https://gpt.cherrychat.org/v1/chat/completions" ` -Headers @{ Authorization = "Bearer sk-你的密钥" } ` -ContentType "application/json; charset=utf-8" ` -Body ([System.Text.Encoding]::UTF8.GetBytes($body))Python(OpenAI SDK)
先运行 pip install openai,再把下面的代码存成 demo.py,运行 python demo.py。后半段是流式输出(边生成边打印)。
from openai import OpenAI client = OpenAI(base_url="https://gpt.cherrychat.org/v1", api_key="sk-你的密钥") resp = client.chat.completions.create( model="gpt-6.1-sol", messages=[{"role": "user", "content": "用一句话介绍你自己"}], ) print(resp.choices[0].message.content) # 流式输出 stream = client.chat.completions.create( model="gpt-6.1-sol", messages=[{"role": "user", "content": "写一首关于春天的短诗"}], stream=True, ) for chunk in stream: if chunk.choices and chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True)Node.js(OpenAI SDK)
先运行 npm install openai,把代码存成 demo.mjs,运行 node demo.mjs(需要 Node.js 18 以上)。
import OpenAI from 'openai'; const client = new OpenAI({ baseURL: 'https://gpt.cherrychat.org/v1', apiKey: 'sk-你的密钥' }); const resp = await client.chat.completions.create({ model: 'gpt-6.1-sol', messages: [{ role: 'user', content: '用一句话介绍你自己' }], }); console.log(resp.choices[0].message.content); // 流式输出 const stream = await client.chat.completions.create({ model: 'gpt-6.1-sol', messages: [{ role: 'user', content: '写一首关于春天的短诗' }], stream: true, }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content ?? ''); }Claude 原生格式(Anthropic SDK)
已有用 Anthropic SDK 写的代码时,只改 base_url 和 api_key。注意这里的地址只到域名。Python 先 pip install anthropic,Node 先 npm install @anthropic-ai/sdk。
Python
import anthropic client = anthropic.Anthropic(base_url="https://gpt.cherrychat.org", api_key="sk-你的密钥") msg = client.messages.create( model="claude-sonnet-5-5", max_tokens=1024, messages=[{"role": "user", "content": "你好"}], ) print(msg.content[0].text)Node.js
import Anthropic from '@anthropic-ai/sdk'; const client = new Anthropic({ baseURL: 'https://gpt.cherrychat.org', apiKey: 'sk-你的密钥' }); const msg = await client.messages.create({ model: 'claude-sonnet-5-5', max_tokens: 1024, messages: [{ role: 'user', content: '你好' }], }); console.log(msg.content[0].text);Responses 接口
OpenAI 新的 Responses 接口同样可用,地址是 https://gpt.cherrychat.org/v1/responses。
Python
from openai import OpenAI client = OpenAI(base_url="https://gpt.cherrychat.org/v1", api_key="sk-你的密钥") resp = client.responses.create(model="gpt-6.1-sol", input="用一句话介绍你自己") print(resp.output_text)curl
curl https://gpt.cherrychat.org/v1/responses \ -H "Authorization: Bearer sk-你的密钥" \ -H "Content-Type: application/json" \ -d '{"model": "gpt-6.1-sol", "input": "你好"}'查看可用模型
返回的列表就是这把 key 能用的全部模型名。
curl https://gpt.cherrychat.org/v1/models -H "Authorization: Bearer sk-你的密钥"
容易踩的坑
- OpenAI SDK 的地址带 /v1(https://gpt.cherrychat.org/v1);Anthropic SDK 的地址只到域名(https://gpt.cherrychat.org),两者别混用。
- 正式项目不要把 key 写死在要提交到 Git 的代码里:OpenAI SDK 会自动读 OPENAI_BASE_URL、OPENAI_API_KEY,Anthropic SDK 读 ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY 环境变量。
- Responses 接口的平台内置工具(web_search、file_search、code_interpreter 等)和 background 模式暂不支持,需要联网请自己用函数调用实现。
- 每个模型支持哪几种接口格式,以「模型价格」页的标注为准;模型名全小写。
- 流式输出的最后一块可能只带用量、没有文字,代码里要判空(示例已处理)。
- 批量任务注意并发:默认每把 key 每分钟 120 次请求、每个账号同时最多 8 个请求。
报错 → 原因 → 怎么办
| 看到的报错 | 原因 | 怎么办 |
|---|---|---|
| 报 401(invalid api key / authentication_error) | key 复制错了、带了空格或换行,或这把 key 已停用 | 到 API 页「我的密钥」重新复制;用环境变量时确认读到的不是旧值 |
| 报 404 Not Found | OpenAI SDK 的地址少了 /v1,或 Anthropic SDK 的地址多了 /v1(变成 /v1/v1/messages) | OpenAI SDK 用 https://gpt.cherrychat.org/v1,Anthropic SDK 用 https://gpt.cherrychat.org |
| 提示模型不存在(model_not_found) | 模型名写错,或这个模型不支持当前接口格式 | 用第 7 步列出的名字,或换「模型价格」页标注支持该格式的模型 |
| 报 402 或「余额不足」(Claude 格式显示 billing_error) | 账户积分不够付这次调用。API 调用只扣积分,会员卡和无限卡都不抵扣 | 到樱桃茶·智域GPT 的「商店」充值任意金额,几秒后重试即可 |
| 报 403,提示 IP 或模型不被允许 | 这把 key 设了 IP 白名单或「允许的模型」,当前 IP 或模型不在里面 | 到 API 页「我的密钥」编辑这把 key,补上或去掉对应限制 |
| 报 429 Too Many Requests | 请求太快:默认每把 key 每分钟最多 120 次,每个账号同时最多 8 个请求 | 调低工具里的并发数或每秒请求数,按提示的 Retry-After 秒数等一等再试;多数工具会自动重试 |
教程核对于 2026-11-02。工具界面改版后可能和这里略有不同,以官方文档为准。
Operated by UK Company CHERRYCHAT LTD · Company Number 16096119 · 客服微信 JsnonoChat · 内容由 AI 生成,请仔细甄别
