GoToAI API 文档

GoToAI 是什么

GoToAI 是一个统一的 AI API 网关。你在控制台创建一把 API Key，然后通过统一的 https://gotoai.lol/v1 入口调用模型。

当前网关提供 OpenAI Chat Completions 兼容接口，适合 OpenAI SDK、LangChain、Dify、n8n、Cline、Cursor 等使用 OpenAI 兼容格式的工具。

5 分钟快速开始

1. 打开 注册页，使用邮箱和密码创建账号。
2. 进入 API 密钥 页面，创建一把 ar- 开头的 Key。
3. 进入 充值 或 兑换码 页面，为账号增加余额。
4. 把原项目里的 OpenAI base_url 改为 https://gotoai.lol/v1。
5. 发送第一次请求。

curl https://gotoai.lol/v1/chat/completions \
  -H "Authorization: Bearer ar-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "你好，用一句话介绍 GoToAI"}]
  }'

核心概念

Base URL 与鉴权

OpenAI 兼容 API

如果你原来使用 OpenAI SDK，通常只需要替换两个参数：base_url 和 api_key。

请求体示例

{
  "model": "gpt-4o-mini",
  "messages": [
    {"role": "system", "content": "你是一个简洁的中文助手"},
    {"role": "user", "content": "写一个三句话产品介绍"}
  ],
  "temperature": 0.7
}

启动器 / 转运站配置

在 OpenAI 兼容客户端、启动器或第三方工具里接入 GoToAI 时，接口地址一般填写到 /v1 这一层，不要填写完整的 /chat/completions 路径。

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="ar-xxxxxxxx",
    base_url="https://gotoai.lol/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello"}],
)

print(resp.choices[0].message.content)

Node / TypeScript SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "ar-xxxxxxxx",
  baseURL: "https://gotoai.lol/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "Hello" }],
});

console.log(resp.choices[0].message.content);

流式响应

OpenAI 兼容客户端可以在请求中加入 stream: true。后端会以 SSE 方式返回上游响应。

const stream = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "用流式输出一段短诗" }],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content || "");
}

模型标识

常用模型可以在 模型列表 页面查看。常见短名如下：

充值与计费

• 新账号默认获得体验额度，具体金额以后台当前配置为准。
• 请求完成后按模型输入、输出 token 计算费用。
• 余额不足时，接口会返回 402。
• 订单和兑换记录可在控制台查看。

故障排查