跳转到主要内容

Base URL

https://api.maxapi.io

工作流程

所有 AI 生成任务遵循相同的异步流程:
1

提交任务

调用 POST /api/v1/task/submit,指定模型和参数,立即返回 taskId
2

等待结果

通过 轮询 GET /api/v1/task/:taskId 或设置 Webhook 回调 获取结果。
3

获取产物

任务成功后,result.urls 中包含生成的图片或视频 URL。
文件链接有效期为 7 天,请在生成后及时下载保存,过期后链接将失效。

通用响应格式

成功:
{
  "code": 0,
  "msg": "ok",
  "data": { ... }
}
失败:
{
  "code": 400,
  "msg": "错误描述"
}

任务状态

status说明
PENDING排队中,等待处理
PROCESSINGWorker 已接收,准备中
SUBMITTED已提交至上游 AI 接口,等待返回
SUCCESS任务成功,result 包含结果
FAILURE任务失败
TIMEOUT任务超时
CANCELLED任务已取消
状态流转:
PENDING → PROCESSING → SUBMITTED → SUCCESS
                                  → FAILURE
                                  → TIMEOUT
          (任意非终态)             → CANCELLED

支持的模型

model说明
seedream-5-liteSeedream 5 Lite(最新)
seedream-4.6Seedream 4.6
seedream-4.5Seedream 4.5
seedream-4Seedream 4