身份验证
创建 API 密钥、在每个请求中发送它，并了解权限范围和端点。
API Key
在控制台设置密钥名称和有效期，也可选择永久有效。新密钥包含所有标准 API 权限，登录后可再次查看。不要将密钥写入客户端代码或公开仓库。
| 权限 | 允许 |
|---|---|
jobs:create | 提交任务 |
jobs:read | 轮询和列出任务 |
media:write | 上传输入图像或视频 |
media:read | 下载结果文件 |
usage:read | 读取额度和流水 |
chat:create | Call chat completions |
发送密钥
发送密钥的方式： Authorization: Bearer <key> 或 x-api-key: <key> ——二者不能同时使用。网页控制台和 Playground 使用登录会话。
缺少或无效的密钥返回 401 AUTH_REQUIRED；权限不足的密钥返回 403 INSUFFICIENT_SCOPE。
端点
| 方法 | 路径 | 用途 | 认证 |
|---|---|---|---|
GET | /api/v1/models | 列出公开模型目录 | 公开 |
GET | /api/v1/models/{slug} | 获取单个模型及其输入 schema | 公开 |
GET | /api/v1/prices | 已配置的单任务价格（美元微单位） | 公开 |
POST | /api/v1/media | 上传图像或视频字节，返回 media:<uuid> | media:write |
POST | /api/v1/jobs | 提交一个异步模型任务 | jobs:create |
GET | /api/v1/jobs/{id} | 轮询单个任务的状态和结果 | jobs:read |
GET | /api/v1/jobs | 最近 100 个任务 | jobs:read |
GET | /api/v1/results/{id} | 下载自己的结果文件 | media:read |
GET | /api/v1/usage | 额度余额与近期流水 | usage:read |
GET | /api/v1/chat/models | Callable chat models with token prices (OpenAI list format) | 公开 |
POST | /api/v1/chat/completions | OpenAI-compatible chat completion, billed per token | chat:create |
GET | /api/v1/chat/requests | Your chat requests with charges, limit (1–100) and before cursor | usage:read |
GET | /api/v1/chat/requests/{id} | One chat request belonging to your account | usage:read |
AI 智能体
AI 智能体可以通过 MCP 服务器用 OAuth 登录，无需使用密钥。 MCP 与 Skill