快速开始

粿条AI 开发文档

为第一次接入 API 的用户准备。从注册、充值、创建密钥，到 SDK 和桌面客户端配置，每一步都可以在这里找到。

01准备账号注册、额度与密钥 02调用 API地址、鉴权与模型 03下载客户端按系统安装

01 · 接入准备

完成接入前准备

完成注册后进入控制台。若余额不足，可前往额度商城购买额度卡，再回到控制台输入兑换码。兑换完成后，控制台会显示对应的美元 API 额度。

第一步注册并登录

使用有效邮箱完成账号注册。

第二步兑换额度

购买额度卡并在控制台兑换。

第三步创建 API Key

密钥只完整显示一次，请妥善保存。

安全提醒

API Key 仅放在服务端环境变量中，不要写入浏览器代码、公开仓库或截图。

02 · API 与模型

API 接入基础

具体服务地址以控制台显示为准。兼容 OpenAI 的接口通常使用 /v1 路径，并通过 Bearer Token 完成鉴权。

Base URLhttps://api.guotiaoai.com/v1

鉴权Authorization: Bearer $GT_API_KEY

聊天接口POST /chat/completions

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

03 · 可用模型

从控制台复制准确的模型 ID

不同账号可用模型可能不同，请优先以控制台显示的实时列表为准。也可以调用模型列表接口检查。

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

04 · 开发

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

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

OPENAI · JAVASCRIPT

OpenAI SDK

继续使用 OpenAI SDK，只需替换 API Key 与 Base URL。

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.GT_API_KEY,
  baseURL: "https://api.guotiaoai.com/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-4.1-mini",
  messages: [{ role: "user", content: "你好" }]
});

ANTHROPIC · JAVASCRIPT

Anthropic SDK

保持 Messages API 的调用习惯，地址以控制台显示为准。

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.GT_API_KEY,
  baseURL: "https://api.guotiaoai.com"
});

const response = await client.messages.create({
  model: "claude-sonnet-4",
  max_tokens: 1024,
  messages: [{ role: "user", content: "你好" }]
});

GEMINI · JAVASCRIPT

Gemini SDK

使用 Gemini SDK 时，将服务地址替换为控制台提供的地址。

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  apiKey: process.env.GT_API_KEY,
  httpOptions: { baseUrl: "https://api.guotiaoai.com" }
});

const response = await ai.models.generateContent({
  model: "gemini-2.5-flash",
  contents: "你好"
});

05 · 图像生成

提交描述并获取图片结果

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

建议

先用较小尺寸完成联调，确认请求成功后再提高分辨率，避免无效消耗额度。

06 · 客户端

下载对应系统的安装包

未能可靠识别系统，请手动选择安装包。点一次即可下载，装好后在设置里填写 API Key 和 Base URL。

macOS · Apple 芯片一键下载当前系统客户端

ChatGPT.dmg

下载 macOS · Apple 芯片

macOS · IntelCodex-latest-x64.dmg下载安装包 Windows · x64ChatGPT-x64.msix下载安装包 Windows · ARM64ChatGPT-arm64.msix下载安装包

命令行版本Node.jsnpm i -g @openai/codex

07 · 排错

常见错误码

401密钥无效

确认 API Key 完整、未被删除，并使用 Bearer 鉴权。

402可用额度不足

前往额度商城购买额度卡，然后在控制台兑换。

404模型不可用

在控制台查看当前可用模型，并使用准确的模型 ID。

429请求过于频繁

降低并发或稍后重试，程序应使用指数退避。

5xx服务暂时异常

稍后自动重试；如持续发生，请附请求时间联系支持。

08 · 帮助

常见问题

额度卡如何计入余额？

卡面 US$5 的额度卡兑换后增加 US$5 API 可用额度；人民币售价为 ¥5，不进行汇率换算。

为什么请求返回 401？

通常是密钥复制不完整、密钥已删除，或请求头没有使用 Bearer 鉴权。

模型名称应该填什么？

请直接复制控制台“可用模型”中的模型 ID，避免凭记忆填写。

09 · 技术支持

仍然没有解决？

联系支持时请提供请求时间、模型 ID、HTTP 状态码和请求 ID；不要发送完整 API Key。

bh141425@gmail.com