CONCEPT
什么是 AI API 中转站？
AI API 中转站把多个模型服务整理为统一的调用入口。你不需要在每个模型平台分别维护接口地址和密钥，而是通过一个 Base URL、一个 API Key，根据任务选择平台当前支持的模型。
SetSail 启航中转站面向开发工具、脚本、工作流和支持自定义 API 地址的客户端。核心站负责注册、API Key、用量和订单；教程站负责安装、配置和问题排查。
中转站不是模型本身。模型名称、能力和可用状态可能更新，正式接入前应先查看核心站的模型广场。
PREPARATION
开始前需要准备什么？
- 一个 SetSail 启航中转站账号
- 账号中创建的 API Key，通常以
sk-开头 - 支持自定义 Base URL 的客户端、SDK 或开发工具
- 准备调用的模型名称，可在模型广场确认
进入核心站注册
打开 SetSail 启航中转站，完成注册或登录。
生成独立 API Key
为当前设备或项目创建单独的 Key，便于以后查看用量和停用权限。
确认模型名称
在 模型广场查看当前可用模型，不要只凭第三方教程猜测模型名。
CONFIGURATION
Base URL 和 API Key 怎么填？
OpenAI 兼容场景通常使用下面两个配置。API Key 属于私密凭据，不要发到群聊、截图或公开代码仓库。
环境变量Shell
export OPENAI_BASE_URL="https://www.aizzqh.com/v1" export OPENAI_API_KEY="你的 API Key"
| 客户端字段 | 填写内容 | 注意事项 |
|---|---|---|
| Base URL / API Host | https://www.aizzqh.com/v1 | 如果客户端会自动追加 /v1，应避免填成重复路径。 |
| API Key | 核心站生成的独立 Key | 不要填写登录密码、邮箱或其他平台密钥。 |
| Model | 模型广场显示的模型名 | 区分大小写和连字符，不能使用页面展示名代替调用名。 |
有些客户端的字段叫“接口地址”“API Host”“Endpoint”或“自定义 OpenAI 地址”，本质上都是 Base URL。填写前先确认客户端是否会自动拼接路径。
FIRST REQUEST
如何发送第一条测试请求？
先查询模型列表
模型查询cURL
curl https://www.aizzqh.com/v1/models \
-H "Authorization: Bearer 你的_API_Key"
返回模型列表说明域名、网络和 API Key 基本可用。接下来从模型广场选择一个当前支持的模型，在你的 SDK 或客户端中发送最小测试请求。
Python SDK 配置示例
OpenAI 兼容客户端Python
from openai import OpenAI
client = OpenAI(
api_key="你的 API Key",
base_url="https://www.aizzqh.com/v1",
)
models = client.models.list()
print(models)
示例只用于验证通用连接方式。具体对话、图像、音频等端点，请根据所选模型能力和对应文档调用。
TROUBLESHOOTING
401、404、429 常见错误怎么排查？
| 状态码 | 常见原因 | 建议检查顺序 |
|---|---|---|
| 401 | API Key 缺失、截断、停用或请求头格式错误 | 重新复制 Key → 检查 Bearer 空格 → 查询 Key 状态 |
| 404 | Base URL、接口路径或模型名称错误 | 检查是否重复 /v1 → 查询模型列表 → 核对端点 |
| 429 | 余额、并发、速率或上游临时限制 | 查看余额用量 → 降低并发 → 稍后重试 → 更换可用模型 |
| 5xx | 网络、代理或上游服务临时异常 | 保留请求时间与模型名 → 短暂重试 → 联系支持时提供错误信息 |
排查时不要公开完整 API Key。可以提供状态码、模型名、请求时间和已脱敏的错误内容。
FAQ
常见问题
Base URL 到底要不要带 /v1？
常见 OpenAI 兼容 SDK 使用 https://www.aizzqh.com/v1。部分客户端会自动追加 /v1，这时应按客户端说明填写，重点是最终请求路径不能重复。
一个 API Key 可以在多个项目使用吗？
技术上可能可以，但更推荐每个设备或项目使用独立 Key，方便统计用量、定位问题和单独停用。
为什么教程里的模型名不能调用？
模型配置可能调整，第三方教程也可能过期。应以当前模型广场或 /v1/models 返回结果为准。
Codex 安装和配置在哪里看？
Windows 与 Mac 的 Codex 中文版下载、安装视频和图文说明继续放在教程站首页，安装完成后再按本文配置接口。