入门指南
API 是什么
API 是 AI 模型聚合中转平台：在兼容 OpenAI 接口风格的前提下，通过统一 Base URL 与 API Key 调用多家模型（Chat、图像、视频、音频等）。
接入三要素
| 项 | 说明 |
|---|---|
| Base URL | https://4zapi.com/v1（OpenAI 兼容路径） |
| API Key | 在控制台「API 令牌」创建，请求头 Authorization: Bearer sk-xxx |
| Model | 控制台「支持模型」或 GET /v1/models |
模型请求使用上表的 API Key。账户管理接口使用下一节的系统访问令牌。
系统访问令牌
系统访问令牌用于调用账户管理接口（例如查询当前账号）。在已登录控制台的前提下生成：
- 左侧「个人」打开「个人设置」。
- 切到页签「账户&安全」。
- 在「API调用令牌」中找到「系统访问令牌」，点击「生成令牌」。
生成成功后，新令牌会写入剪贴板，并显示在卡片中（默认打码）。眼睛图标可查看全文，复制图标可再复制一次。页顶的 ID: 是用户 ID，点击可复制。
每次点击「生成令牌」都会作废上一枚令牌并签发新值。刷新页面后不再回显，需要再次生成才能拿到明文。
调用管理接口时同时带上下面两个请求头：
| 头 | 值 |
|---|---|
Authorization |
Bearer <系统访问令牌>（Bearer 可省略） |
New-Api-User |
个人设置页顶的用户 ID，与令牌所属账号一致 |
推荐学习路径
- 5 分钟 Quick Start（Python）
- 异步任务通用说明（视频 / Suno / Kling 等必读）
- 门户「接口参考」中的各平台 OpenAPI
与官方 API 的关系
- 默认：改
base_url指向，模型名使用支持的 ID - 进阶：部分平台提供原生路径（如
/kling/*、/suno/*），见门户对应平台文档
常见错误
| 现象 | 可能原因 |
|---|---|
invalid character '<' looking for beginning of value |
Base URL 或路径错误，上游返回了 HTML |
| 401 | Key 无效或已禁用 |
| 管理接口 401 | 未带 New-Api-User，或该头与令牌所属用户不一致；或令牌已因再次「生成令牌」失效 |
用系统访问令牌请求 /v1 返回 401 |
模型接口要使用「API 令牌」中的 sk-xxx |
| 模型不存在 | 模型名拼写错误或当前分组无权限 |
更多排错见各平台 OpenAPI 中的 x-error-playbook。