{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/4mwbqltj9","result":{"data":{"markdownRemark":{"html":"\n
\n
\n
\n
\n
POST
\n
\nhttps://qianfan.baidubce.com/beta/video/generations/qianfan-video\n
\n
\n
\n

上传1～7张图片，模型将以此参数中传入的图片中的主题为参考，生成具备主体一致性的视频

\n
\n
\n

权限说明

\n

调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。

\n
\n
\n

请求参数

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
Body 参数
\n
\n
\n
\n
\n
\n\nmodel\n\nstring\n
\n

模型ID。
支持模型: K1.6。

\n
\n
必选
\n
\n
\n
\n\ntype\n\nstring\n
\n

任务类型，固定值：multi-img2video。

\n
\n
必选
\n
\n
\n
\n\nmodel_parameters\n\nobject {6}\n
\n

模型参数配置。

\n
\n
必选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nimage_list\n\narray\n
\n

参考图像列表。
最多支持 4 张图片。
支持 HTTP URL 或 Base64 编码字符串。
● Base64 编码不可包含头部前缀（如 data:image/png;base64,）。
● 文件格式支持 .jpg / .jpeg / .png。
● 文件大小 ≤ 10MB。
● 分辨率 ≥ 200x200px。
● 宽高比范围：1:2.5 ~ 2.5:1。
注意：API 端无自动裁剪逻辑，请提前上传已选好主体的图片。

\n
\n
必选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nitems\n\nobject {1}\n
\n
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\nimage\n\nstring\n
\n

单张参考图像数据。
\n\"image_list\":[ { \"image\":\"image_url\" }, { \"image\":\"image_url\" }]

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\nprompt\n\nstring\n
\n

正向提示词，用于描述视频内容。
长度限制：最大 2500 字符。

\n
\n
必选
\n
\n
\n
\n\nnegative_prompt\n\nstring\n
\n

负向提示词，用于描述不希望出现的画面内容。
长度限制：最大 2500 字符。

\n
\n
可选
\n
\n
\n
\n\nmode\n\nstring\n
\n

视频生成模式。
默认值：std
枚举值：
● std：标准模式，兼顾生成速度与质量。
● pro：专业模式，优先保证视频细节与质量。
注：具体模型支持情况请参考能力地图。

\n
\n
可选
\n
\n
\n
\n\nduration\n\nstring\n
\n

视频时长（秒）。
默认值：5
枚举值：5、10。

\n
\n
可选
\n
\n
\n
\n\naspect_ratio\n\nstring\n
\n

生成视频的画面纵横比（宽:高）。
默认值：16:9
枚举值：16:9、9:16、1:1。

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
请求结构
\n\n
\n
\n\n
\n
POST /beta/video/generations/qianfan-video HTTP/1.1\nHOST: qianfan.baidubce.com\nAuthorization: Bearer <API Key>\nContent-Type: application/json\n{\n  \"model\": \"K1.6\",\n  \"type\": \"multi-img2video\",\n  \"model_parameters\": {\n    \"image_list\": [\n      {\n        \"image\": \"https://example.com/image_reference_01.jpg\"\n      },\n      {\n        \"image\": \"https://example.com/image_reference_02.jpg\"\n      }\n    ],\n    \"prompt\": \"一段连贯的视频，展示主角从画面左侧移动到右侧，风格保持一致，高清，电影质感\",\n    \"negative_prompt\": \"模糊，变形，扭曲，低质量，噪点\",\n    \"mode\": \"std\",\n    \"duration\": \"5\",\n    \"aspect_ratio\": \"16:9\"\n  }\n}
\n
\n
\n
\n
\n
\n
\n
\n

示例代码

\n
\n\n
\n
\n
\n
默认示例
\n\n
\n
\n\n
\n
curl -X POST \"https://qianfan.baidubce.com/beta/video/generations/qianfan-video\" \\\n  -H \"Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"model\": \"K1.6\",\n  \"type\": \"multi-img2video\",\n  \"model_parameters\": {\n    \"image_list\": [\n      {\n        \"image\": \"https://example.com/image_reference_01.jpg\"\n      },\n      {\n        \"image\": \"https://example.com/image_reference_02.jpg\"\n      }\n    ],\n    \"prompt\": \"一段连贯的视频，展示主角从画面左侧移动到右侧，风格保持一致，高清，电影质感\",\n    \"negative_prompt\": \"模糊，变形，扭曲，低质量，噪点\",\n    \"mode\": \"std\",\n    \"duration\": \"5\",\n    \"aspect_ratio\": \"16:9\"\n  }\n}'
\n
\n
\n
\n
\n
\n
\n
\n

返回响应

\n
\n
\n
\n
\n
Headers 参数
\n
除公共头域外，无其它特殊头域
\n
\n
\n
\n
\n
返回参数
\n
\n
\n
\n
\n
\n\ncode\n\ninteger\n
\n

错误码。

\n
\n
必选
\n
\n
\n
\n\nmessage\n\nstring\n
\n

错误信息。

\n
\n
必选
\n
\n
\n
\n\nrequest_id\n\nstring\n
\n

请求ID。

\n
\n
必选
\n
\n
\n
\n\ndata\n\nobject {5}\n
\n

返回数据体，包含任务相关信息。

\n
\n
必选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n\ntask_id\n\nstring\n
\n

任务ID。

\n
\n
必选
\n
\n
\n
\n\ntask_status\n\nstring\n
\n

任务状态。

\n
    \n
  • submitted：已提交
    • \n
  • processing：处理中
    • \n
  • succeed：成功
    • \n
  • failed：失败
    • \n
\n
\n
必选
\n
\n
\n
\n\ncreated_at\n\ninteger\n
\n

任务创建时间，Unix 时间戳（毫秒）。

\n
\n
必选
\n
\n
\n
\n\nupdated_at\n\ninteger\n
\n

任务更新时间，Unix 时间戳（毫秒）。

\n
\n
必选
\n
\n
\n
\n\ntask_info\n\nobject\n
\n

任务详细信息。

\n
\n
必选
\n
\n\n
\n\n显示子属性\n隐藏子属性\n
\n\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n\n
\n
\n
\n
请求成功
\n\n
\n
\n\n
\n
{\n  \"code\": 0,\n  \"message\": \"\",\n  \"request_id\": \"as-vav8kk4s9j\",\n  \"data\": {\n    \"task_id\": \"6981e556628540ad3e08a351\",\n    \"task_status\": \"submitted\",\n    \"created_at\": 1770120534000,\n    \"updated_at\": 1770120534000,\n    \"task_info\": {}\n  }\n}
\n
\n
\n
\n
\n
\n
\n
\n
\n
\n

错误码

\n

如果调用失败并返回报错信息，请参见错误码进行解决。

\n

公共错误码：查看公共错误码

\n

本接口专有错误码如下：

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP状态码错误码错误信息错误描述
0请求成功--
1100账户异常账户异常检查账户配置信息
1200请求参数非法请求参数非法检查请求参数是否正确
1201请求参数非法参数非法，如key写错或value非法参考返回体中message字段的具体信息，修改请求参数
1202请求参数非法请求的method无效查看接口文档，使用正确的request method
1203请求参数非法请求的资源不存在，如模型参考返回体中message字段的具体信息，修改请求参数
1300触发策略触发平台策略检查是否触发平台策略
1301触发策略触发平台的内容安全策略检查输入内容，修改后重新发起请求
5000内部错误服务器内部错误稍后重试，或联系客服
5001内部错误服务器暂时不可用，通常是在维护稍后重试，或联系客服
5002内部错误服务器内部超时，通常是发生积压稍后重试，或联系客服
\n

视频模型通用错误码

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
HTTP状态码错误码错误信息错误描述
500internal_errorvideo_genration_interal_errorvideo generation service interal error
400invalid_request_errorinvalid_lipsync_argument
429rate_limit_exceededvideo_genration_concurrency_exceededRate limit reached for Concurrency
403unsafe_requestvideo_genration_prompt_unsafethe content of prompt field is unsafe
\n
\n
","fields":{"slug":"4mwbqltj9","title":"创建视频生成任务-多图参考生视频","date":"2026-11-11","extractedHeadings":[{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2},{"value":"错误码","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"4mwbqltj9","prev":null,"next":null,"parents":[]}}}