curl 快速开始

用一个最小 OpenAI compatible 请求检查完整链路。

准备

在密钥页准备 YOUR_API_KEY。
在模型与价格页选择当前可用模型，并用其替换 YOUR_MODEL。
确认当前网络能够访问 https://api.popgo.site。

查看实时模型与价格

接入前检查清单

先只替换 YOUR_API_KEY 和 YOUR_MODEL，不要同时改请求路径、协议和客户端高级参数。
如果软件要求 Base URL，按对应教程填写根地址或 /v1 地址；如果要求完整 Endpoint，才填写完整接口路径。
先用快速开始请求得到一次成功响应，再把同一组 Key、模型和地址复制到客户端。

按协议分类选择地址和端点

OpenAI compatible 通常使用 /v1 Base URL；Claude Messages 和 Gemini 原生请求使用根地址，再由客户端或完整 Endpoint 追加协议路径。

完整接口清单请查看 API Reference。视频任务和媒体参数请查看图片与视频生成。

本地环境准备

如果要运行 CLI、自动化脚本或需要 Node.js 的工具，先确认 Node.js 与 npm 已安装，并在启动工具的同一个终端检查版本：

node --version
npm --version

Windows：可使用官方安装程序或系统包管理器安装 Node.js LTS。
macOS：可使用官方安装程序或 Homebrew 安装 Node.js。
Linux/WSL2：使用发行版包管理器或 Node.js 官方推荐方式安装。
如果安装后仍提示找不到命令，关闭旧终端并重新打开；新进程才会读取更新后的 PATH。

软件里到底填 Base URL 还是完整 Endpoint

不同软件字段名不统一，最容易错的是把 Base URL 和完整接口地址混在一起。可以按下面判断：

软件字段看起来像	应该填什么	示例
Base URL、API Host、Server URL、Endpoint Root	服务根或协议根地址	OpenAI compatible 通常填 `https://api.popgo.site/v1`
Chat Completions URL、Request URL、完整接口地址	完整接口路径	`https://api.popgo.site/v1/chat/completions`
Anthropic Base URL、Claude Base URL	根地址	`https://api.popgo.site`
API Key、Token、Bearer Token	只填 Key 本身	`YOUR_API_KEY`，不要带 `Bearer` 前缀，除非软件明确要求

常见协议地址对照

协议或能力	Base URL 字段	完整 Endpoint 字段	认证方式
OpenAI compatible 聊天	`https://api.popgo.site/v1`	`https://api.popgo.site/v1/chat/completions`	`Authorization: Bearer YOUR_API_KEY`
OpenAI compatible Responses	`https://api.popgo.site/v1`	`https://api.popgo.site/v1/responses`	`Authorization: Bearer YOUR_API_KEY`
OpenAI Images 图片	`https://api.popgo.site/v1`	`https://api.popgo.site/v1/images/generations`	`Authorization: Bearer YOUR_API_KEY`
Claude Messages	`https://api.popgo.site`	`https://api.popgo.site/v1/messages`	`x-api-key: YOUR_API_KEY`
Gemini generateContent	`https://api.popgo.site`	`https://api.popgo.site/v1beta/models/YOUR_MODEL:generateContent`	`x-goog-api-key: YOUR_API_KEY`

第三方软件通用填法

很多软件界面不同，但底层需要的信息基本一致。看到表单时按下面对应，不要把多个字段拼到一个地方：

表单字段	填写内容	常见错误
Provider、API Type、Format	选择 OpenAI compatible、Anthropic/Claude 或 Gemini 中与教程一致的类型	Provider 选 OpenAI，却填 Claude 根地址
Base URL、API Host	只填协议根，不带具体请求路径	在 Base URL 后又手动加 `/chat/completions`，导致客户端重复追加
API Key、Token	只填 `YOUR_API_KEY`	带上 `Bearer` 前缀，或误贴到模型字段
Model、Default Model	填主站实时模型页复制的 `YOUR_MODEL`	从旧截图手打模型 ID，或模型和 Key 分组不匹配
Test、Check、Validate	保存后做一次短请求	一上来就启用长上下文、工具调用或媒体生成，导致排查范围过大

不建议照搬的内容

不要从其他中转站截图里抄域名、模型名、价格倍率或群信息。
不要把真实 Key 写进教程截图、问题描述或公开仓库。
不要为了“证书错误”关闭 TLS 校验；这会降低本地安全性，应优先检查代理、系统时间和网络拦截。

发送请求

下面的请求使用 OpenAI compatible Base URL。

curl https://api.popgo.site/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL",
    "messages": [
      {"role": "user", "content": "请回复连接成功"}
    ]
  }'

成功判断

HTTP 状态为成功且响应中包含助手内容，说明 Base URL、密钥和模型均可用。若失败，请按状态码进入故障排查。

下一步

根据客户端支持情况继续阅读 OpenAI、Claude 或 Gemini 协议页，或选择软件集成教程。

准备​

接入前检查清单​

按协议分类选择地址和端点​

本地环境准备​

软件里到底填 Base URL 还是完整 Endpoint​

常见协议地址对照​

第三方软件通用填法​

推荐的接入顺序​

不建议照搬的内容​

发送请求​

成功判断​

下一步​

准备