复制接入文案
不会真实调用，请在本机环境中填写 API Key。
接口地址
Base URL
https://aixmq.com/
认证方式
Authorization: Bearer sk-topway-xxx
错误格式
{
"error": {
"message": "人类可读的中文提示",
"type": "auth_error | rate_limit | insufficient_balance | relay_error",
"code": 401
}
}
网关按请求体里的 model 选择上游渠道，并把路径原样透传（例如 https://aixmq.com/v1/videos 会转发到对应渠道的 /v1/videos）。因此创建与查询都必须带 model。
元数据接口（只认 API Key，不依赖网页登录）
| 接口 | 方法 | 说明 | 计费 |
|---|---|---|---|
| /v1/models | GET | 模型清单：ID、显示名、渠道、可用性、提交/查询接口、素材上限、时长、分辨率、价格（pricing） | 免费 |
| /v1/balance | GET | 账户余额（balance / currency / frozen） | 免费 |
| /v1/tasks | GET | 我的任务列表（?status= &limit=） | 免费 |
| /v1/tasks/{task_no} | GET | 单个任务状态与结果（统一查询接口，不扣费） | 免费 |
价格与限制都随 /v1/models 一起返回，分别在 pricing（mode / unit / unit_price / vip_price / currency）与 limits（images / videos / audios / duration / resolution）字段里，无需单独调用价格接口。
价格表（实时拉取）
| 模型 ID | 显示名 | 渠道 | 类型 | 计费方式 | 单价 | 你的实付 | 状态 |
|---|---|---|---|---|---|---|---|
| 点击「拉取价格表」加载 | |||||||
已登录时按你的 VIP 折扣实时计算「你的实付」；未登录可用 API Key 拉取（仅本次请求使用，不会保存）。
支持的业务接口
| 接口 | 方法 | 说明 | 模型 |
|---|---|---|---|
| /v1/videos | POST | 提交视频生成任务 | 视频类模型 |
| /v1/images | POST | 提交图片生成任务（n=张数） | 图片类模型 |
快速开始
1. 查看模型目录
curl -H "Authorization: Bearer sk-topway-你的密钥" https://aixmq.com/v1/models
2. 提交视频生成（按秒计费，时长字段取目录 limits.duration.parameter）
curl -X POST https://aixmq.com/v1/videos \\
-H "Authorization: Bearer sk-topway-你的密钥" \\
-H "Content-Type: application/json" \\
-d '{"model":"TX官方-seedance-2.0-480p","prompt":"电影感城市夜景，镜头缓慢推进","seconds":"5"}'
# → { "task_no": "TXXXX", "status": "queued", "charge": 2.62, "balance": 7.38 }
3. 轮询（每 5 秒，最多 10 分钟）
curl -H "Authorization: Bearer sk-topway-你的密钥" https://aixmq.com/v1/tasks/TXXXX
# status=success 后用 data.download_url 下载成品（7 天有效）
说明：任务状态为 queued / processing / success / failed；建议每 5 秒轮询一次，最多 10 分钟；成品请使用 download_url 下载（7 天有效，过期重新查询可刷新）；生成失败自动全额退款。余额不足返回 HTTP 402。
HTTP 状态码
| 状态码 | 含义 |
|---|---|
| 400 | 参数错误 |
| 401 | 未登录或 API Key 无效 |
| 402 | 余额/积分不足 |
| 403 | 账号被禁用 |
| 404 | 任务或模型不存在 |
| 429 | 限流（默认 10 次/分钟/Key） |
| 502 | 上游网关问题 |
| 503 | 系统维护中 |