文档：改一行，能调全部。
API Plaza 是一个兼容 OpenAI 接口的聚合网关。把 base_url 换成网关地址，其余照旧。本页的支持模型清单实时来自目录，不会过时。
快速开始
在控制台注册并创建 API key，然后把下面任意一段跑起来——这就是全部接入工作。
让你的 AI 替你接入
把接入指令直接发给 Claude、ChatGPT 或 Cursor：内含 base_url、认证方式、实时模型清单与调用样例，AI 拿到就能把你的项目接上。
认证
所有请求都在 Header 里带上你的 key。key 在控制台创建，可设额度、限模型、绑 IP。
HEADER Authorization: Bearer <你的 API key>
对话补全
POST /v1/chat/completions
与 OpenAI Chat Completions 完全兼容：流式（stream: true）、多轮、函数/工具调用、视觉输入照常工作。
支持模型（实时）
| 参数 | 类型 | 说明 |
|---|---|---|
| model* | string | 目录中的任意文本模型 id |
| messages* | array | OpenAI 消息数组，支持多轮与图片内容 |
| stream | bool | true 时按 SSE 逐 token 返回 |
| tools | array | 函数/工具定义，结构化输出原样透传 |
| temperature / top_p / max_tokens | number | 采样参数，随上游语义 |
图片生成
POST /v1/images/generations
同步接口：请求返回即含图片 URL。按张计费，价格见目录。
支持模型（实时）
| 参数 | 类型 | 说明 |
|---|---|---|
| model* | string | 目录中的任意图片模型 id |
| prompt* | string | 生成描述 |
| size | string | 如 1024x1024；随模型支持 |
| n | int | 生成张数，按张计费 |
视频生成
视频是异步任务，三步：创建任务 → 轮询状态 → 取结果。按时长档计费。
POST /v1/videos
GET /v1/videos/{task_id}
GET /v1/videos/{task_id}/content
支持模型（实时）
| 参数 | 类型 | 说明 |
|---|---|---|
| model* | string | 目录中的任意视频模型 id |
| prompt* | string | 生成描述 |
| seconds | string | 时长档，各模型支持档位见目录 |
| image_urls | array | 图生视频的首帧参考图（支持的模型） |
任务通常在数十秒到几分钟内完成；status 依次为 queued → processing → completed。轮询建议间隔 ≥2s。
错误处理
错误返回 OpenAI 风格的 JSON：{"error": {"message", "type", "code"}}。常见状态码：
| HTTP | 含义 | 处理建议 |
|---|---|---|
| 401 | key 缺失或无效 | 检查 Authorization 头与 key 状态 |
| 402 / 403 | 余额不足或 key 超出限制 | 控制台充值，或检查 key 的额度/模型范围 |
| 429 | 触发限流 | 指数退避重试 |
| 5xx | 网关或上游故障 | 失败请求不计费；重试并查看状态页 |
定价与用量
价格全部公开在价格页与目录 JSON 里；POST /estimate 可在调用前精确算价。
每一笔调用的 token 数、费用与状态都记录在控制台的用量日志里，余额与充值也在控制台管理。