即梦 & 生数异步图片接口

即梦(Jimeng)与生数(Vidu) 异步图片生成接口文档。

关于「异步」：以下模型在上游均为异步任务模型。本文档统一使用 POST /v1/video/generations 提交 + GET /v1/video/generations/{task_id} 查询 的异步任务接口，调用方手动管理任务生命周期，适合长耗时、批量任务管理的场景。

支持的模型

即梦(Jimeng)

模型	类型	说明
`jimeng_t2i_v40`	文生图	即梦 4.0 文生图，效果最佳
`jimeng_t2i_v31`	文生图	即梦 3.1 文生图
`jimeng_t2i_v30`	文生图	即梦 3.0 文生图
`jimeng_i2i_v30`	图生图	即梦 3.0 图生图

生数(Vidu)

模型	类型	说明
`q2-pro`	文生图 / 图生图	生数 Q2 高质量版
`q2-fast`	文生图 / 图生图	生数 Q2 快速版
`q3-fast`	文生图 / 图生图	生数 Q3 快速版

注意：生数模型名上游区分大小写，必须使用全小写。

接口地址

POST https://www.moyu.info/v1/video/generations              # 提交任务
GET  https://www.moyu.info/v1/video/generations/{task_id}    # 查询结果

提交任务

即梦 — 文生图（cURL）

⚠️ Windows 环境下 curl 中文编码问题：直接在命令行 -d 传中文，curl 会按系统码页（GBK）发送，建议使用 --data-binary @文件 或编程语言调用。

即梦 — 图生图（cURL）

通过 image 字段传入参考图（URL 或 Base64）：

生数 — 文生图（cURL）

生数 — 图生图（cURL）

通过 extra_fields.images 数组传入一张或多张参考图（URL 或 Base64）：

提交响应

{
  "id": "6369603594515605437",
  "task_id": "6369603594515605437",
  "object": "video",
  "model": "jimeng_t2i_v31",
  "status": "",
  "progress": 0,
  "created_at": 0
}

拿到 task_id 后用于查询结果。

查询结果

建议每 3–5 秒 轮询一次。

状态流转

NOT_START → SUBMITTED → IN_PROGRESS → SUCCESS / FAILURE

即梦 — 成功响应

图片数据通常在 data.data.data.binary_data_base64（Base64 数组）：

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "3990629258597848124",
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1770203838,
    "finish_time": 1770203853,
    "progress": "100%",
    "data": {
      "code": 10000,
      "status": 10000,
      "message": "Success",
      "data": {
        "status": "done",
        "binary_data_base64": ["iVBORw0KGgoAAAANSUhEUg..."],
        "image_urls": null
      }
    }
  }
}

生数 — 成功响应

图片 URL 通常在 data.data.creations[].url：

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "vidu-task-xxxxx",
    "action": "generate",
    "status": "SUCCESS",
    "submit_time": 1770203838,
    "finish_time": 1770203853,
    "progress": "100%",
    "data": {
      "id": "vidu-task-xxxxx",
      "state": "success",
      "creations": [
        {
          "id": "creation-1",
          "url": "https://cdn.vidu.com/xxxxx.png",
          "cover_url": "",
          "watermarked_url": ""
        }
      ]
    }
  }
}

注意：生数返回的 URL 通常 24 小时内有效，请及时下载保存。

请求参数

通用参数

参数	类型	必填	说明
model	string	是	模型名称，见上方支持列表
prompt	string	是	图片描述提示词，支持中英文
image	string	即梦图生图必填	参考图，URL 或 Base64（仅 `jimeng_i2i_v30` 使用）
extra_fields	object	否	上游特有参数透传

即梦 `extra_fields` 常用参数

子参数	类型	说明
seed	integer	随机种子，-1 表示随机
width	integer	图片宽度，范围 `[256, 768]`（部分模型扩展到 2048）
height	integer	图片高度
use_pre_llm	boolean	是否启用文本扩写，默认 true
use_sr	boolean	是否启用超分，默认 true

完整参数请参考即梦官方文档

生数 `extra_fields` 常用参数

子参数	类型	说明
images	string[]	参考图列表（URL 或 Base64），用于图生图
seed	integer	随机种子
aspect_ratio	string	画面比例，如 `1:1`、`16:9`、`9:16`
resolution	string	分辨率，如 `720p`、`1080p`
payload	string	业务自定义透传字段
callback_url	string	任务完成回调地址（生数会主动 POST 通知）

完整 Python 示例（轮询拿图）

即梦

生数

错误处理

模型不存在 / 未配置

{
  "error": {
    "message": "The model specified does not exist",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_not_found"
  }
}

解决方案：检查模型名称是否在支持列表内；生数模型名必须全小写。

上游任务失败

{
  "code": "success",
  "message": "",
  "data": {
    "status": "FAILURE",
    "fail_reason": "...",
    "progress": "100%"
  }
}

解决方案：检查 prompt 是否触发内容安全策略；检查参考图 URL 是否可访问；查看 fail_reason 字段定位具体原因。

Windows 环境编码问题

方案一：使用 --data-binary @文件 发送 UTF-8 编码的 JSON 文件

方案二：在 CMD 中执行 chcp 65001 切换为 UTF-8

方案三：使用 Python / JavaScript / Go 等编程语言调用（推荐）

支持的模型#

即梦(Jimeng)#

生数(Vidu)#

接口地址#

提交任务#

即梦 — 文生图（cURL）#

即梦 — 图生图（cURL）#

生数 — 文生图（cURL）#

生数 — 图生图（cURL）#

提交响应#

查询结果#

状态流转#

即梦 — 成功响应#

生数 — 成功响应#

请求参数#

通用参数#

即梦 extra_fields 常用参数#

生数 extra_fields 常用参数#

完整 Python 示例（轮询拿图）#

即梦#

生数#

错误处理#

模型不存在 / 未配置#

上游任务失败#

Windows 环境编码问题#