即梦视频接口

即梦(Jimeng)视频/图像生成接口文档。

接口地址

提交任务

POST https://www.moyu.info/v1/video/generations

查询结果

GET https://www.moyu.info/v1/video/generations/{task_id}

请求示例

文生视频 (Text-to-Video)

cURL

其他语言

图生视频 (Image-to-Video)

单图生视频

首尾帧生视频

传入两张图片作为首帧和尾帧，生成过渡视频：

也可以使用 Base64 方式传入图片：

文生图 (Text-to-Image)

文生图功能可以根据文本描述生成图片。

cURL

响应示例：

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

其他语言

图生图 (Image-to-Image)

图生图功能可以基于输入图片和文本描述生成新的图片。

通过 URL 传入图片

通过 Base64 传入图片

其他语言

提交任务响应格式

{
  "id": "3666383187090401977",
  "task_id": "3666383187090401977",
  "object": "video",
  "model": "jimeng_t2v_v30",
  "status": "",
  "progress": 0,
  "created_at": 0
}

重要：即梦为异步接口，返回task_id后需要使用该ID查询生成结果。

查询结果

使用返回的task_id查询视频生成进度和结果。

查询请求示例

cURL

其他语言

查询响应格式

任务进行中

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "3666383187090401977",
    "action": "generate",
    "status": "QUEUED",
    "fail_reason": "",
    "submit_time": 1770371348,
    "start_time": 0,
    "finish_time": 0,
    "progress": "10%",
    "data": {
      "code": 10000,
      "data": {
        "status": "in_queue",
        "video_url": "",
        "aigc_meta_tagged": false
      },
      "status": 10000,
      "message": "Success",
      "request_id": "202602061749147B73036B5FB941002F4C",
      "time_elapsed": "10.751557ms"
    }
  }
}

视频生成成功

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "4380441713537006986",
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1770203734,
    "start_time": 0,
    "finish_time": 1770203788,
    "progress": "100%",
    "data": {
      "code": 10000,
      "data": {
        "status": "done",
        "video_url": "https://example.com/video.mp4",
        "aigc_meta_tagged": false
      },
      "status": 10000,
      "message": "Success",
      "request_id": "20260204191628938F89EB62CF1C126F96",
      "time_elapsed": "64.431549ms"
    }
  }
}

图像生成成功

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "3990629258597848124",
    "action": "generate",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1770203838,
    "start_time": 0,
    "finish_time": 1770203853,
    "progress": "100%",
    "data": {
      "code": 10000,
      "data": {
        "status": "done",
        "video_url": "",
        "image_urls": null,
        "aigc_meta_tagged": false,
        "binary_data_base64": ["iVBORw0KGgoAAAANSUhEUg..."]
      },
      "status": 10000,
      "message": "Success",
      "request_id": "20260204191823E8BB64...",
      "time_elapsed": "19.876393ms"
    }
  }
}

重要说明：

即梦的文生图和图生图模型返回的图片格式为 Base64 编码

图片数据存储在 data.data.binary_data_base64 数组中

您需要自行处理 Base64 格式的图片数据

Base64 图片处理示例：

任务失败

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "13958182363172442081",
    "action": "generate",
    "status": "FAILURE",
    "fail_reason": "Invalid Input Parameters: :  <- [返回]算法返回码=201202,消息=Invalid Param:x2v pipeline: frames should be [73, 289]",
    "submit_time": 1770203818,
    "start_time": 0,
    "finish_time": 1770203818,
    "progress": "100%",
    "data": {
      "code": 50200,
      "data": null,
      "status": 50200,
      "message": "Invalid Input Parameters: :  <- [返回]算法返回码=201202,消息=Invalid Param:x2v pipeline: frames should be [73, 289]",
      "request_id": "20260204191658A6BEBDEDF341C500AFDD",
      "time_elapsed": "34.515917ms"
    }
  }
}

停止任务

在任务执行过程中，可以取消正在进行的任务。

停止请求示例

cURL

其他语言

停止任务响应格式

{
  "code": "success",
  "message": "Task cancelled successfully",
  "data": {
    "task_id": "4380441713537006986",
    "action": "generate",
    "status": "CANCELLED",
    "fail_reason": "Task cancelled by user",
    "submit_time": 1770203734,
    "start_time": 0,
    "finish_time": 1770267360,
    "progress": "100%"
  }
}

注意：只能停止状态为QUEUED或处理中的任务。已完成（SUCCESS）或已失败（FAILURE）的任务无法取消。

请求参数

提交任务参数

参数	类型	必填	说明
model	string	是	模型名称，如 `jimeng_t2v_v30`、`jimeng_i2v_v30`、`jimeng_i2v_first_tail_v30_1080`、`jimeng_t2i_v30`、`jimeng_i2i_v30`
prompt	string	是	描述提示词，详细描述想要生成的内容
frames	integer	视频时需要	视频帧数，支持 `121`(5秒) 或 `241`(10秒)
metadata	object	图生视频/图生图时需要	用于传递上游特有参数，详见下方说明
aspect_ratio	string	否	宽高比，如 `16:9`、`9:16`、`1:1`

metadata 参数说明

通过 metadata 传入图片和其他上游特有参数，metadata 中的字段会被展开后直接发送给上游接口。

metadata 子参数	类型	说明
image_urls	string[]	输入图片的 URL 数组
binary_data_base64	string[]	输入图片的 Base64 编码数组（与 image_urls 二选一）
width	integer	生成图片宽度
height	integer	生成图片高度

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

响应字段说明

提交任务响应字段

字段	类型	说明
id	string	任务唯一标识符
task_id	string	任务ID，用于查询生成结果
object	string	对象类型，如 "video"
model	string	使用的模型名称
status	string	任务状态
progress	integer	进度百分比
created_at	integer	创建时间戳

查询结果响应字段

字段	类型	说明
code	string	响应码，"success" 表示查询成功
message	string	响应消息
data.task_id	string	任务ID
data.action	string	操作类型，如 "generate"
data.status	string	任务状态：NOT_START(未开始)、QUEUED(排队中)、SUCCESS(成功)、FAILURE(失败)
data.fail_reason	string	失败原因
data.submit_time	integer	提交时间戳
data.start_time	integer	开始时间戳
data.finish_time	integer	完成时间戳
data.progress	string	进度百分比，如 "10%", "100%"
data.data.status	string	详细状态：in_queue(队列中)、done(完成)
data.data.video_url	string	生成的视频URL（视频任务）
data.data.binary_data_base64	array	Base64编码的图片数据（图像任务）
data.data.image_urls	array	图片URL列表（如果有）
data.data.aigc_meta_tagged	boolean	AIGC元数据标记

接口地址#

提交任务#

查询结果#

请求示例#

文生视频 (Text-to-Video)#

cURL#

其他语言#

图生视频 (Image-to-Video)#

单图生视频#

首尾帧生视频#

文生图 (Text-to-Image)#

cURL#

其他语言#

图生图 (Image-to-Image)#

通过 URL 传入图片#

通过 Base64 传入图片#

其他语言#

提交任务响应格式#

查询结果#

查询请求示例#

cURL#

其他语言#

查询响应格式#

任务进行中#

视频生成成功#

图像生成成功#

任务失败#

停止任务#

停止请求示例#

cURL#

其他语言#

停止任务响应格式#

请求参数#

提交任务参数#

metadata 参数说明#

响应字段说明#

提交任务响应字段#

查询结果响应字段#

接口地址

提交任务

查询结果

请求示例

文生视频 (Text-to-Video)

cURL

其他语言

图生视频 (Image-to-Video)

单图生视频

首尾帧生视频

文生图 (Text-to-Image)

cURL

其他语言

图生图 (Image-to-Image)

通过 URL 传入图片

通过 Base64 传入图片

其他语言

提交任务响应格式

查询结果

查询请求示例

cURL

其他语言

查询响应格式

任务进行中

视频生成成功

图像生成成功

任务失败

停止任务

停止请求示例

cURL

其他语言

停止任务响应格式

请求参数

提交任务参数

metadata 参数说明

响应字段说明

提交任务响应字段

查询结果响应字段