粿条AI 使用文档

从零开始：5 步就能用

粿条AI 是一个中转接口。你在常用软件里把官方地址和密钥换成这里的，就可以继续用 GPT、Claude、Gemini 等模型。下面按顺序做，不要跳步。

1. 注册账号

   打开首页，用邮箱注册。新用户会送一点体验额度。

   去首页注册　已有账号，进控制台

2. 创建 API 密钥

   控制台左侧点「API 密钥」→ 创建。完整密钥只出现一次，立刻复制保存。以后软件里填的就是这一串，一般以 sk- 开头。

3. 购买额度卡

   体验额度用完后，到额度商城买卡。面值怎么标，兑换后就加多少美元额度。例如 ¥5 的卡，兑换后加 US$5。

   打开额度商城

4. 到控制台兑换

   支付成功后，订单页会给出兑换码。控制台左侧点「兑换」，贴进去。看到余额增加，才算充好。

5. 接到你正在用的软件

   聊天、填三处就用：用 Cherry Studio。已经在用 Codex 的人：下载 Cockpit Tools，在软件里添加自定义供应商，不用改配置文件。不要在 Codex 登录页点「用 API 密钥登录」，那会连到 OpenAI 官方。

   Cherry Studio（推荐聊天）　下载 Cockpit Tools（Codex）

Cherry Studio：在软件里填三处

买了额度的用户，优先用这个。不用终端、不用改配置文件。下载安装后：设置 → 模型服务 → 添加自定义（OpenAI 兼容），填下面三行。

下载 Cherry Studio

Cockpit Tools：添加粿条AI

用 Codex 时，先装这个开源工具，再按下面四张图添加 API Key。下面两个按钮每次都会跳到 GitHub 当前最新 Release，不固定旧版本。

按当前系统下载（含 Intel / ARM）

不用 Cockpit 时，用一条命令

已经用 Cockpit Tools 的人可以跳过。这条命令会在你自己的电脑上写入配置，跑完必须完全退出 Codex 再打开。

注册、买卡、兑换

没有账号、没有密钥、没有余额，软件都会连不上。按这三步准备好。

API 接入基础

不管你用现成软件还是自己写代码，都只要改三处：地址、密钥、模型。其他保持软件原来的填法。

常见软件填哪里

• Cherry Studio（推荐）：选自定义 OpenAI 兼容，地址填 https://console.guotiaoai.com/v1。
• Codex：已经在用再走文档里的 Codex 命令；登录页不要点「用 API 密钥登录」。
• OpenCode：选自定义 OpenAI 兼容，地址同样填 https://console.guotiaoai.com/v1。
• Claude Code：地址填 https://console.guotiaoai.com，不要加 /v1。
• Gemini CLI：地址同样填 https://console.guotiaoai.com。

按协议选择请求头和客户端

协议、请求头、典型客户端要成套使用。混用会导致 401，或字段、流式事件不兼容。

支持的主要端点

某端点写在文档里，不代表当前密钥一定有权使用。实际开放范围以该 Key 的模型列表为准。

OpenAI、Anthropic 与 Gemini

Responses 是 Codex 与新式 OpenAI 客户端的推荐入口。Chat Completions 兼容仍以 messages 为输入的现有应用。不要只替换 URL 而保留原请求体。

OpenAI Responses

curl "https://console.guotiaoai.com/v1/responses" \
  -H "Authorization: Bearer $GT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6",
    "input": "用三点说明 API 网关的作用"
  }'

OpenAI Chat Completions

curl "https://console.guotiaoai.com/v1/chat/completions" \
  -H "Authorization: Bearer $GT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6",
    "messages": [
      {"role": "system", "content": "回答要简洁。"},
      {"role": "user", "content": "什么是 API 网关？"}
    ]
  }'

Python · OpenAI SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://console.guotiaoai.com/v1",
)
response = client.responses.create(
    model="gpt-5.6",
    input="用三点说明 API 网关的作用",
)
print(response.output_text)

Anthropic Messages

Base URL 填 https://console.guotiaoai.com，不要加 /v1。HTTP 调用必须带 x-api-key 和 anthropic-version，请求体需要 messages 和 max_tokens。

curl "https://console.guotiaoai.com/v1/messages" \
  -H "x-api-key: $GT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 256,
    "messages": [
      {"role": "user", "content": "列出三个 Go 并发注意事项"}
    ]
  }'

Gemini generateContent

curl "https://console.guotiaoai.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "解释什么是流式响应"}]
    }]
  }'

打开 stream，按行读取 SSE

OpenAI 和 Anthropic 通常在 JSON 中加入 "stream": true。Gemini 使用 :streamGenerateContent?alt=sse。客户端需要按行解析 Server-Sent Events，不要等完整响应体；为长响应配置足够的读取超时；取消时主动关闭连接。

OpenAI 流式

curl "https://console.guotiaoai.com/v1/chat/completions" \
  -H "Authorization: Bearer $GT_API_KEY" \
  -H "Content-Type: application/json" \
  -N \
  -d '{
    "model": "gpt-5.6",
    "stream": true,
    "messages": [{"role": "user", "content": "你好"}]
  }'

Anthropic 流式

curl "https://console.guotiaoai.com/v1/messages" \
  -H "x-api-key: $GT_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -N \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 256,
    "stream": true,
    "messages": [{"role": "user", "content": "你好"}]
  }'

OpenAI 流式以 data: [DONE] 结束；Anthropic 会依次给出 message_start、content_block_delta、message_stop。不要只凭 HTTP 200 判断生成已经完成。

可用模型：复制名字，不要自己编

你不需要先搞懂接口。打开控制台看「可用模型」，把名字原样复制到软件里。不同密钥看到的列表可能不一样，以你这把密钥为准。

新手可以先试这三个：

• 写代码、日常问答：gpt-5.6
• 要 Claude：claude-sonnet-5
• 要 Gemini：gemini-3.5-flash

也可以把密钥贴到下面，立刻看到这把钥匙能用哪些模型。密钥只发到粿条AI，本页不保存。

curl "https://console.guotiaoai.com/v1/models" \
  -H "Authorization: Bearer $GT_API_KEY"

主要模型系列参考

下面只是常见系列，方便对照。真正能用的，以控制台或上方查询结果为准。

如何选择

• 代码代理：选明确支持 Responses、工具调用和长上下文的 GPT-5.6 或 Claude。
• 日常问答：先用 Flash、Haiku 等低延迟型号，再按质量升级。
• 复杂推理：使用高能力型号并限制最大输出，先小流量评估成本和延迟。
• 图像生成：只选带 Image 能力、且实时列表里确实存在的型号。
• 生产环境：固定完整快照 ID；使用 latest 或无版本别名时要接受行为变化。

选择你正在使用的语言与 SDK

不要混用不同厂商的参数格式。选择项目当前使用的 SDK，只替换 API Key、Base URL 和模型 ID。

提交描述并获取图片结果

图像模型的请求格式、尺寸和输出方式可能不同。请先在控制台确认支持的图像模型，再按照相应模型说明提交请求。

按当前系统下载并配置客户端

有人不清楚该下哪个安装包，也有人因为网络原因打不开外网站点。这里按你正在用的电脑识别 Mac / Windows，并给出对应官方安装包。 配置地址只用 粿条AI 控制台，不要填写其他网站的 URL 或 API。

Provider: 自定义 / OpenAI Compatible
Base URL: https://console.guotiaoai.com/v1
API Key: YOUR_API_KEY
模型 ID: 从控制台可用模型复制

model_provider = "guotiao"
model = "gpt-5.6"

[model_providers.guotiao]
name = "粿条AI"
base_url = "https://console.guotiaoai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false

Provider: Custom
接口地址: https://console.guotiaoai.com/v1
API Key: YOUR_API_KEY
模型 ID: 从控制台可用模型复制

{
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://console.guotiaoai.com/v1",
        "apiKey": "YOUR_API_KEY"
      }
    }
  }
}

API Provider: OpenAI Compatible
Base URL: https://console.guotiaoai.com/v1
API Key: YOUR_API_KEY
Model ID: 从控制台可用模型复制
Azure: 关闭

GOOGLE_GEMINI_BASE_URL=https://console.guotiaoai.com
GEMINI_API_KEY=YOUR_API_KEY
GEMINI_MODEL=从控制台复制 Gemini 模型 ID

Codex / OpenCode → https://console.guotiaoai.com/v1
Claude Code → https://console.guotiaoai.com
反重力 / Gemini CLI → https://console.guotiaoai.com

添加方式: API Key（不要 OAuth）
供应商: 自定义
基础地址: https://console.guotiaoai.com
API Key: YOUR_API_KEY
同步供应商模型到 Codex: 打开

常见错误码

常见问题