{"componentChunkName":"component---src-templates-acg-portal-new-template-tsx","path":"/rmwbl4dn9","result":{"data":{"markdownRemark":{"html":"<script id=\"API_DOC_DATA\" data-method=\"POST\" type=\"application/json\">{\"debugUrl\":{\"url\":\"https://qianfan.baidubce.com/beta/video/generations/qianfan-video\",\"href\":\"\",\"method\":\"POST\"},\"debugDesc\":\"本接口支持通过传入图片、参考视频，结合文本提示词，生成具备全局主体一致性的定制化视频，接口返回`task_id`用于后续查询结果。\",\"authInfo\":\"## 权限说明\\n调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看[认证鉴权](https://cloud.baidu.com/doc/qianfan-api/s/ym9chdsy5)。\",\"requestCode\":\"curl -X POST \\\"https://qianfan.baidubce.com/beta/video/generations/qianfan-video\\\" \\n  -H \\\"Authorization: Bearer <API Key>\\\" \\n  -H \\\"Content-Type: application/json\\\" \\n  -d '{\\n  \\\"model\\\": \\\"VQ4\\\",\\n  \\\"type\\\": \\\"reference2video\\\",\\n  \\\"model_parameters\\\": {\\n    \\\"images\\\": [\\n        \\\"https://example.com/reference-1.png\\\",\\n        \\\"https://example.com/reference-2.png\\\"\\n    ],\\n    \\\"sounds\\\": [\\n        \\\"https://example.com/reference-audio-1.mp3\\\"\\n    ],\\n    \\\"prompt\\\": \\\"参考图中的人物在草地上奔跑，阳光明媚，电影质感\\\",\\n    \\\"duration\\\": 5,\\n    \\\"aspect_ratio\\\": \\\"16:9\\\",\\n    \\\"resolution\\\": \\\"1080p\\\"\\n  }\\n}'\",\"requestHeader\":false,\"requestParam\":{\"url\":false,\"body\":{\"type\":\"object\",\"required\":[\"model\",\"type\",\"model_parameters\"],\"properties\":{\"type\":{\"type\":\"string\",\"description\":\"任务类型，固定值：`reference2video`。\"},\"model\":{\"type\":\"string\",\"description\":\"用于生成视频的模型。\\n可选值：VQ1、V2.0、VQ2、VQ2-Pro、VQ4\\n<br>· `VQ4`：Vidu 最新参考生模型，支持 1~15 张参考图、0~3 个参考音频，支持音画同出\\n<br>· `VQ2-Pro`：新模型，效果好，细节丰富\\n<br>· `VQ2`：新模型，效果好\\n<br>· `V2.0`：生成速度快\\n<br>· `VQ1`：画面清晰，平滑转场，运镜稳定\"},\"model_parameters\":{\"type\":\"object\",\"required\":[\"prompt\"],\"properties\":{\"bgm\":{\"type\":\"boolean\",\"description\":\"是否为生成的视频添加背景音乐，默认值：`false`。  \\n* `true`：开启。系统将从预设 BGM 库中自动挑选并适配适合视频时长的音乐。\\n* `false`：关闭。不添加背景音乐。\\n注：当使用`VQ2`系列模型且视频时长 (duration) 设置为 9秒 或 10秒 时，`bgm`参数不生效。`VQ4`不支持该参数\\n\"},\"seed\":{\"type\":\"integer\",\"description\":\"随机种子。   \\n当未传入种子或传入值为0时，系统将自动生成随机数作为种子，确保每次生成结果具有随机性。  \\n用户可传入非零整数值作为固定种子，以实现结果的可复现性。\"},\"audio\":{\"type\":\"boolean\",\"description\":\"是否使用音画同步直出能力，默认 true。（仅 VQ4 支持）\\n· true：输出带声音的视频（含台词与音效）\\n· false：输出静音视频\"},\"images\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"该主体对应的图片url，每个主体最多支持3张图片。\"},\"prompt\":{\"type\":\"string\",\"description\":\"提示词，用于描述生成的视频内容。  \\n字符长度不能超过 1500 个字符。\"},\"sounds\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"参考音频，模型以传入音频作为参考生成视频。（仅 VQ4 支持）\\n· 数量：0~3 个\\n· 单个音频时长 3~12s\\n· 格式：mp3\\n· 单个音频文件不超过 50MB，请求体不超过 20MB\"},\"videos\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"模型将以此参数中传入的视频作为参考，生成具备主体一致的视频。仅 `VQ2-Pro` 模型支持此参数。<br>最多支持 1 个 8s 视频或 2 个 5s 视频。<br>支持 `mp4`、`avi`、`mov` 格式；分辨率需 ≥ 128*128；长宽比需介于 1:4 至 4:1 之间。<br>视频源文件 ≤ 100M；Base64 解码后数据 ≤ 20M。<br>Base64 字符串须包含对应的 Content-Type 前缀，示例：`data:video/mp4;base64,{base64_encode}`<br> VQ4 不支持该参数\"},\"wm_url\":{\"type\":\"string\",\"description\":\"水印内容（图片 URL），不传时使用默认水印。\"},\"duration\":{\"type\":\"integer\",\"description\":\"视频时长（秒）。  \\n* `VQ4`：默认 5 秒，可选：3 - 16 的任意整数。\\n* `VQ2-Pro`：默认设置为 5 秒，支持自定义设置 0 至 10 秒 的任意整数时长。（0秒为自动判断时长）\\n* `VQ2`：默认设置为 5 秒，支持自定义设置 1 至 10 秒 的任意整数时长。\\n* `VQ1`：默认设置为 5 秒，仅支持 5 秒 固定时长。\\n* `V2.0`：默认设置为 4 秒，仅支持 4 秒 固定时长。\\n\"},\"meta_data\":{\"type\":\"string\",\"description\":\"元数据标识，JSON 格式字符串，透传字段；为空时默认使用系统生成的元数据标识。\"},\"resolution\":{\"type\":\"string\",\"description\":\"分辨率，默认值取决于模型与时长。\\n* `VQ2-Pro`：默认 720p。可选：540p, 720p, 1080p。\\n* `VQ2 (1-10s)`：默认 720p。可选：540p, 720p, 1080p。\\n* `VQ1 (5s)`：默认 1080p。可选：1080p。\\n* `V2.0 (4s)`：默认 360p。可选：360p, 720p。\\n* `VQ4`：默认 720p，可选：540p、720p、1080p、2K、4K。\"},\"wm_position\":{\"type\":\"integer\",\"description\":\"水印位置，默认 3。\\n· 1：左上角\\n· 2：右上角\\n· 3：右下角\\n· 4：左下角\"},\"aspect_ratio\":{\"type\":\"string\",\"description\":\"画面比例，默认值：16:9\\n* 通用可选值：16:9, 9:16, 1:1\\n* `VQ2`模型仅支持 4:3, 3:4\\n* `VQ4`：默认 16:9，可选 1:1、9:16、16:9、3:4、4:3。\"},\"movement_amplitude\":{\"type\":\"string\",\"description\":\"运动幅度，默认值：`auto` \\n可选值：`auto`, `small`, `medium`, `large`。  \\n使用`VQ2`和`VQ4`模型时该参数不生效。\"}},\"propertyOrder\":[\"images\",\"videos\",\"sounds\",\"prompt\",\"bgm\",\"duration\",\"audio\",\"aspect_ratio\",\"resolution\",\"movement_amplitude\",\"seed\",\"wm_position\",\"wm_url\",\"meta_data\"]}},\"propertyOrder\":[\"model\",\"type\",\"model_parameters\"]},\"query\":false,\"urlDesc\":\"\",\"bodyDesc\":\"\",\"queryDesc\":\"\"},\"requestExampleCode\":[{\"scene\":\"请求示例\",\"sceneDesc\":\"\",\"languageTabs\":[{\"code\":\"curl -X POST \\\"https://qianfan.baidubce.com/beta/video/generations/qianfan-video\\\" \\\\\\n  -H \\\"Content-Type: application/json\\\" \\\\\\n  -H \\\"Authorization: Bearer bce-v3/ALTAK-******OgxsPHN/e7cfca2c5428d001524eed0836c058a516f8e467\\\" \\\\\\n  -d '{\\n    \\\"type\\\": \\\"reference2video\\\",\\n    \\\"model\\\": \\\"VQ2-Pro\\\",\\n    \\\"model_parameters\\\": {\\n      \\\"images\\\": [\\n        \\\"https://example.com/subject_image_1.jpg\\\"\\n      ],\\n      \\\"videos\\\": [\\n        \\\"data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZ...\\\"\\n      ],\\n      \\\"prompt\\\": \\\"一只可爱的金毛犬在草地上奔跑，阳光明媚，电影级质感，平滑运镜\\\",\\n      \\\"bgm\\\": true,\\n      \\\"duration\\\": 5,\\n      \\\"aspect_ratio\\\": \\\"16:9\\\",\\n      \\\"resolution\\\": \\\"720p\\\",\\n      \\\"movement_amplitude\\\": \\\"auto\\\",\\n      \\\"seed\\\": 0\\n    }\\n  }'\",\"lang\":\"curl\",\"codeHtml\":\"<pre class=\\\"shiki github-dark-default\\\" style=\\\"background-color:#0d1117;color:#e6edf3\\\" tabindex=\\\"0\\\"><code><span class=\\\"line\\\"><span style=\\\"color:#FFA657\\\">curl</span><span style=\\\"color:#79C0FF\\\"> -X</span><span style=\\\"color:#A5D6FF\\\"> POST</span><span style=\\\"color:#A5D6FF\\\"> \\\"https://qianfan.baidubce.com/beta/video/generations/qianfan-video\\\"</span><span style=\\\"color:#FF7B72\\\"> \\\\</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#79C0FF\\\">  -H</span><span style=\\\"color:#A5D6FF\\\"> \\\"Content-Type: application/json\\\"</span><span style=\\\"color:#FF7B72\\\"> \\\\</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#79C0FF\\\">  -H</span><span style=\\\"color:#A5D6FF\\\"> \\\"Authorization: Bearer bce-v3/ALTAK-******OgxsPHN/e7cfca2c5428d001524eed0836c058a516f8e467\\\"</span><span style=\\\"color:#FF7B72\\\"> \\\\</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#79C0FF\\\">  -d</span><span style=\\\"color:#A5D6FF\\\"> '{</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">    \\\"type\\\": \\\"reference2video\\\",</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">    \\\"model\\\": \\\"VQ2-Pro\\\",</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">    \\\"model_parameters\\\": {</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      \\\"images\\\": [</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">        \\\"https://example.com/subject_image_1.jpg\\\"</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      ],</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      \\\"videos\\\": [</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">        \\\"data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZ...\\\"</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      ],</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      \\\"prompt\\\": \\\"一只可爱的金毛犬在草地上奔跑，阳光明媚，电影级质感，平滑运镜\\\",</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      \\\"bgm\\\": true,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      \\\"duration\\\": 5,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      \\\"aspect_ratio\\\": \\\"16:9\\\",</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      \\\"resolution\\\": \\\"720p\\\",</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      \\\"movement_amplitude\\\": \\\"auto\\\",</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">      \\\"seed\\\": 0</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">    }</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  }'</span></span></code></pre>\"}]}],\"responseHeader\":false,\"responseBody\":{\"type\":\"object\",\"required\":[\"log_id\",\"task_id\",\"status\",\"model\",\"prompt\",\"created_at\"],\"properties\":{\"bgm\":{\"type\":\"boolean\",\"description\":\"背景音乐。\"},\"seed\":{\"type\":\"integer\",\"description\":\"使用的随机种子。\"},\"model\":{\"type\":\"string\",\"description\":\"使用的模型名称。\"},\"images\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"图像参考。\"},\"log_id\":{\"type\":\"string\",\"description\":\"日志ID，用于问题排查。\"},\"prompt\":{\"type\":\"string\",\"description\":\"输入的提示词内容。\"},\"status\":{\"type\":\"string\",\"description\":\"任务状态，标识当前任务所处阶段。  \\n* `created` 创建成功\\n* `queueing` 任务排队中\\n* `processing` 任务处理中\\n* `success` 任务成功\\n* `failed` 任务失败\"},\"task_id\":{\"type\":\"string\",\"description\":\"任务ID，用于后续查询生成结果。\"},\"duration\":{\"type\":\"integer\",\"description\":\"视频时长 (秒)。\"},\"watermark\":{\"type\":\"boolean\",\"description\":\"本次任务是否使用水印。\"},\"created_at\":{\"type\":\"string\",\"description\":\"任务创建的时间，格式为时间戳字符串（毫秒级）。\"},\"resolution\":{\"type\":\"string\",\"description\":\"生成的视频分辨率。\"},\"aspect_ratio\":{\"type\":\"string\",\"description\":\"画面比例。\"},\"movement_amplitude\":{\"type\":\"string\",\"description\":\"运动幅度。\"}},\"propertyOrder\":[\"log_id\",\"task_id\",\"status\",\"model\",\"images\",\"prompt\",\"duration\",\"seed\",\"resolution\",\"movement_amplitude\",\"aspect_ratio\",\"bgm\",\"watermark\",\"created_at\"]},\"responseExampleCode\":[{\"scene\":\"响应示例\",\"sceneDesc\":\"\",\"languageTabs\":[{\"code\":\"{\\n  \\\"log_id\\\": \\\"as-xxxxxxxxxx\\\",\\n  \\\"task_id\\\": \\\"697b217128a819d37fce4c4b\\\",\\n  \\\"status\\\": \\\"created\\\",\\n  \\\"model\\\": \\\"VQ4\\\",\\n  \\\"images\\\": [\\n    \\\"https://example.com/reference-1.png\\\",\\n    \\\"https://example.com/reference-2.png\\\"\\n  ],\\n  \\\"prompt\\\": \\\"参考图中的人物在草地上奔跑，阳光明媚，电影质感\\\",\\n  \\\"duration\\\": 5,\\n  \\\"seed\\\": 12345,\\n  \\\"resolution\\\": \\\"1080p\\\",\\n  \\\"aspect_ratio\\\": \\\"16:9\\\",\\n  \\\"bgm\\\": false,\\n  \\\"watermark\\\": true,\\n  \\\"created_at\\\": \\\"1769677169000\\\"\\n}\",\"lang\":\"JSON\",\"codeHtml\":\"<pre class=\\\"shiki github-dark-default\\\" style=\\\"background-color:#0d1117;color:#e6edf3\\\" tabindex=\\\"0\\\"><code><span class=\\\"line\\\"><span style=\\\"color:#E6EDF3\\\">{</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"log_id\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#A5D6FF\\\">\\\"as-xxxxxxxxxx\\\"</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"task_id\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#A5D6FF\\\">\\\"697b217128a819d37fce4c4b\\\"</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"status\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#A5D6FF\\\">\\\"created\\\"</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"model\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#A5D6FF\\\">\\\"VQ4\\\"</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"images\\\"</span><span style=\\\"color:#E6EDF3\\\">: [</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">    \\\"https://example.com/reference-1.png\\\"</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">    \\\"https://example.com/reference-2.png\\\"</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#E6EDF3\\\">  ],</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"prompt\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#A5D6FF\\\">\\\"参考图中的人物在草地上奔跑，阳光明媚，电影质感\\\"</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"duration\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#79C0FF\\\">5</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"seed\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#79C0FF\\\">12345</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"resolution\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#A5D6FF\\\">\\\"1080p\\\"</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"aspect_ratio\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#A5D6FF\\\">\\\"16:9\\\"</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"bgm\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#79C0FF\\\">false</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"watermark\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#79C0FF\\\">true</span><span style=\\\"color:#E6EDF3\\\">,</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#A5D6FF\\\">  \\\"created_at\\\"</span><span style=\\\"color:#E6EDF3\\\">: </span><span style=\\\"color:#A5D6FF\\\">\\\"1769677169000\\\"</span></span>\\n<span class=\\\"line\\\"><span style=\\\"color:#E6EDF3\\\">}</span></span></code></pre>\"}]}],\"otherContent\":\"\\n## 错误码\\n\\n如果调用失败并返回报错信息，请参见错误码进行解决。\\n\\n公共错误码：[查看公共错误码](https://cloud.baidu.com/doc/qianfan-api/s/Om9b4yj3w)\\n\\n本接口专有错误码如下：\\n\\n| HTTP状态码 | 错误码| 错误信息| 错误描述|\\n| :--- | :--- | :--- | :--- |\\n| 400 | BadRequest | bad request | 不合法的请求。 |\\n| 400 | FieldLacking | field is missing or empty: {{.fields}} | 缺少字段，具体字段见错误信息。 |\\n| 400 | FieldUnwanted | unwanted field: {{.fields}} | 不需要传某些字段，具体字段见错误信息。 |\\n| 400 | FieldItemCountOutOfRange | field item count out of range: {{.fields}} | 字段数量超出限制（如数组长度超限）。 |\\n| 400 | PageSizeOutOfRange | page size out of range | **图像尺寸或格式有问题**。<br>1. 图片大小需小于 50M。<br>2. 格式只支持 jpg/jpeg/png/webp。<br>3. 图片长宽比需要小于 1:4 或者 4:1。<br>4. 跳舞特效的图片长宽比需要在 1:1.2 至 1:2 之间。 |\\n| 400 | ImageDownloadFailure | image download failure | 下载用户图片URL失败，请检查链接的有效性。 |\\n| 400 | OperationInProcess | operation in process, please retry later | 请求在处理中，请勿重复提交。 |\\n| 400 | TaskPromptPolicyViolation | prompt policy violation | Prompt 触发安审风控。 |\\n| 400 | ImageFormatInvalid | invalid image format | 图像格式不符合要求。 |\\n| 400 | AuditSubmitIllegal | submit is illegal | 输入内容（图片或文本）没有通过安全审核。 |\\n| 400 | CreationPolicyViolation | creation policy violation | 生成物触发风控。 |\\n| 400 | ModelUnavailable | model unavailable | 请求的模型不可用，调用任务失败，请检查模型类型并重试。 |\\n| 400 | FieldInvalid | invalid field: {{.fields}} | 传入参数未通过合法性校验。 |\\n| 400 | ImageCheckBodyJointsFailed | Image Check Body Joins Failed | 输入图人体检测失败，请重新上传。 |\\n| 400 | ImageCheckFaceFailed | Image Check Face Failed | 输入图人脸检测失败，请重新上传。 |\\n| 400 | ImageObjectsUndetected | Image BodyJoins or Face Too Much Occlusion | 输入图的人体或人脸有遮挡，请重新上传。 |\\n| 404 | TaskNotFound | task not found | Task id 没找到。 |\\n| 404 | CreationNotFound | creation not found | Creation id 没找到。 |\\n| 500 | InternalServiceFailure | internal service failure | 服务器内部错误，请稍后重试，或联系客服。 |\\n\\n### 视频模型通用错误码\\n\\n| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |\\n| :--- | :--- | :--- | :--- |\\n| 500 | internal_error | video_genration_interal_error | video generation service interal error |\\n| 400 | invalid_request_error | invalid_lipsync_argument | |\\n| 429 | rate_limit_exceeded | video_genration_concurrency_exceeded | Rate limit reached for Concurrency |\\n| 403 | unsafe_request | video_genration_prompt_unsafe | the content of prompt field is unsafe |\"}</script>\n<main id=\"doc-body\">\n<section id=\"debug-url\">\n<div class=\"debug-wrapper\">\n<div class=\"debug-url-wrapper\">\n<div class=\"debug-url-method\" data-method=\"post\">POST</div>\n<div class=\"debug-url-text\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"路径\" data-track-value=\"https://qianfan.baidubce.com/beta/video/generations/qianfan-video\" data-copy-text=\"https://qianfan.baidubce.com/beta/video/generations/qianfan-video\">\n<span>https://qianfan.baidubce.com/beta/video/generations/qianfan-video</span>\n</div>\n</div>\n</div>\n<p>本接口支持通过传入图片、参考视频，结合文本提示词，生成具备全局主体一致性的定制化视频，接口返回<code>task_id</code>用于后续查询结果。</p>\n</section>\n<section id=\"auth-info\">\n<h2 id=\"权限说明\">权限说明<a class=\"anchor\" aria-label=\"权限说明 permalink\" href=\"#%E6%9D%83%E9%99%90%E8%AF%B4%E6%98%8E\"></a></h2>\n<p>调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看<a href=\"https://cloud.baidu.com/doc/qianfan-api/s/ym9chdsy5\" target=\"_blank\">认证鉴权</a>。</p>\n</section>\n<section id=\"request-params\">\n<h2 class=\"section-title\" id=\"请求参数\">请求参数<a class=\"anchor\" aria-label=\"请求参数 permalink\" href=\"#%E8%AF%B7%E6%B1%82%E5%8F%82%E6%95%B0\"></a></h2>\n<div class=\"horizontal-container\">\n<div class=\"horizontal-left-panel\">\n<div class=\"param-card param-card-empty\">\n<div class=\"param-card-header\">\n<div class=\"param-card-title\">Headers 参数</div>\n<div class=\"param-card-header-desc\">除公共头域外，无其它特殊头域</div>\n</div>\n</div>\n<div class=\"param-card\">\n<div class=\"param-card-header\">\n<div class=\"param-card-title\">Body 参数</div>\n</div>\n<div class=\"param-card-content\">\n<div class=\"api-param-list  \">\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"model\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"model\">\nmodel\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>用于生成视频的模型。\n可选值：VQ1、V2.0、VQ2、VQ2-Pro、VQ4\n<br>· <code>VQ4</code>：Vidu 最新参考生模型，支持 1~15 张参考图、0~3 个参考音频，支持音画同出\n<br>· <code>VQ2-Pro</code>：新模型，效果好，细节丰富\n<br>· <code>VQ2</code>：新模型，效果好\n<br>· <code>V2.0</code>：生成速度快\n<br>· <code>VQ1</code>：画面清晰，平滑转场，运镜稳定</p>\n</div>\n<div class=\"api-param-list-item-required\" data-required=\"\">必选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"type\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"type\">\ntype\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>任务类型，固定值：<code>reference2video</code>。</p>\n</div>\n<div class=\"api-param-list-item-required\" data-required=\"\">必选</div>\n</div>\n<div class=\"api-param-list-item api-param-list-item-has-child\">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"model_parameters\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"model_parameters\">\nmodel_parameters\n</span>\n<span class=\"api-param-list-item-type\">object {14}</span>\n</div>\n<div class=\"api-param-desc\"></div>\n<div class=\"api-param-list-item-required\" data-required=\"\">必选</div>\n<details class=\"api-param-list-tree\">\n<summary>\n<div class=\"api-param-list-tree-root\">\n<svg width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><g><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M5.59842 7.81538L3.09594 4.71641C2.93376 4.51557 2.98209 4.2337 3.20389 4.08685C3.28912 4.03042 3.39196 4 3.49755 4L8.50249 4C8.77726 4 9 4.2017 9 4.4505C9 4.54611 8.96641 4.63923 8.90409 4.71641L6.40162 7.81538C6.23944 8.01622 5.92816 8.05998 5.70636 7.91312C5.66504 7.88576 5.62863 7.85279 5.59842 7.81538Z\" fill=\"currentColor\"></path></g></svg>\n<span class=\"api-param-list-tree-root-text root-text-show\">显示子属性</span>\n<span class=\"api-param-list-tree-root-text root-text-hide\">隐藏子属性</span>\n</div>\n</summary>\n<div class=\"api-param-list api-param-list-child \">\n<div class=\"api-param-list-item api-param-list-item-has-child\">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"images\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"images\">\nimages\n</span>\n<span class=\"api-param-list-item-type\">array</span>\n</div>\n<div class=\"api-param-desc\"><p>该主体对应的图片url，每个主体最多支持3张图片。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n<details class=\"api-param-list-tree\">\n<summary>\n<div class=\"api-param-list-tree-root\">\n<svg width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><g><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M5.59842 7.81538L3.09594 4.71641C2.93376 4.51557 2.98209 4.2337 3.20389 4.08685C3.28912 4.03042 3.39196 4 3.49755 4L8.50249 4C8.77726 4 9 4.2017 9 4.4505C9 4.54611 8.96641 4.63923 8.90409 4.71641L6.40162 7.81538C6.23944 8.01622 5.92816 8.05998 5.70636 7.91312C5.66504 7.88576 5.62863 7.85279 5.59842 7.81538Z\" fill=\"currentColor\"></path></g></svg>\n<span class=\"api-param-list-tree-root-text root-text-show\">显示子属性</span>\n<span class=\"api-param-list-tree-root-text root-text-hide\">隐藏子属性</span>\n</div>\n</summary>\n<div class=\"api-param-list api-param-list-child \">\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"items\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"items\">\nitems\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"></div>\n</div>\n</div>\n</details>\n</div>\n<div class=\"api-param-list-item api-param-list-item-has-child\">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"videos\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"videos\">\nvideos\n</span>\n<span class=\"api-param-list-item-type\">array</span>\n</div>\n<div class=\"api-param-desc\"><p>模型将以此参数中传入的视频作为参考，生成具备主体一致的视频。仅 <code>VQ2-Pro</code> 模型支持此参数。<br>最多支持 1 个 8s 视频或 2 个 5s 视频。<br>支持 <code>mp4</code>、<code>avi</code>、<code>mov</code> 格式；分辨率需 ≥ 128*128；长宽比需介于 1:4 至 4:1 之间。<br>视频源文件 ≤ 100M；Base64 解码后数据 ≤ 20M。<br>Base64 字符串须包含对应的 Content-Type 前缀，示例：<code>data:video/mp4;base64,{base64_encode}</code><br> VQ4 不支持该参数</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n<details class=\"api-param-list-tree\">\n<summary>\n<div class=\"api-param-list-tree-root\">\n<svg width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><g><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M5.59842 7.81538L3.09594 4.71641C2.93376 4.51557 2.98209 4.2337 3.20389 4.08685C3.28912 4.03042 3.39196 4 3.49755 4L8.50249 4C8.77726 4 9 4.2017 9 4.4505C9 4.54611 8.96641 4.63923 8.90409 4.71641L6.40162 7.81538C6.23944 8.01622 5.92816 8.05998 5.70636 7.91312C5.66504 7.88576 5.62863 7.85279 5.59842 7.81538Z\" fill=\"currentColor\"></path></g></svg>\n<span class=\"api-param-list-tree-root-text root-text-show\">显示子属性</span>\n<span class=\"api-param-list-tree-root-text root-text-hide\">隐藏子属性</span>\n</div>\n</summary>\n<div class=\"api-param-list api-param-list-child \">\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"items\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"items\">\nitems\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"></div>\n</div>\n</div>\n</details>\n</div>\n<div class=\"api-param-list-item api-param-list-item-has-child\">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"sounds\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"sounds\">\nsounds\n</span>\n<span class=\"api-param-list-item-type\">array</span>\n</div>\n<div class=\"api-param-desc\"><p>参考音频，模型以传入音频作为参考生成视频。（仅 VQ4 支持）\n· 数量：0~3 个\n· 单个音频时长 3~12s\n· 格式：mp3\n· 单个音频文件不超过 50MB，请求体不超过 20MB</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n<details class=\"api-param-list-tree\">\n<summary>\n<div class=\"api-param-list-tree-root\">\n<svg width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><g><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M5.59842 7.81538L3.09594 4.71641C2.93376 4.51557 2.98209 4.2337 3.20389 4.08685C3.28912 4.03042 3.39196 4 3.49755 4L8.50249 4C8.77726 4 9 4.2017 9 4.4505C9 4.54611 8.96641 4.63923 8.90409 4.71641L6.40162 7.81538C6.23944 8.01622 5.92816 8.05998 5.70636 7.91312C5.66504 7.88576 5.62863 7.85279 5.59842 7.81538Z\" fill=\"currentColor\"></path></g></svg>\n<span class=\"api-param-list-tree-root-text root-text-show\">显示子属性</span>\n<span class=\"api-param-list-tree-root-text root-text-hide\">隐藏子属性</span>\n</div>\n</summary>\n<div class=\"api-param-list api-param-list-child \">\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"items\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"items\">\nitems\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"></div>\n</div>\n</div>\n</details>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"prompt\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"prompt\">\nprompt\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>提示词，用于描述生成的视频内容。<br>\n字符长度不能超过 1500 个字符。</p>\n</div>\n<div class=\"api-param-list-item-required\" data-required=\"\">必选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"bgm\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"bgm\">\nbgm\n</span>\n<span class=\"api-param-list-item-type\">boolean</span>\n</div>\n<div class=\"api-param-desc\"><p>是否为生成的视频添加背景音乐，默认值：<code>false</code>。</p>\n<ul>\n<li><code>true</code>：开启。系统将从预设 BGM 库中自动挑选并适配适合视频时长的音乐。</li>\n<li><code>false</code>：关闭。不添加背景音乐。\n注：当使用<code>VQ2</code>系列模型且视频时长 (duration) 设置为 9秒 或 10秒 时，<code>bgm</code>参数不生效。<code>VQ4</code>不支持该参数</li>\n</ul>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"duration\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"duration\">\nduration\n</span>\n<span class=\"api-param-list-item-type\">integer</span>\n</div>\n<div class=\"api-param-desc\"><p>视频时长（秒）。</p>\n<ul>\n<li><code>VQ4</code>：默认 5 秒，可选：3 - 16 的任意整数。</li>\n<li><code>VQ2-Pro</code>：默认设置为 5 秒，支持自定义设置 0 至 10 秒 的任意整数时长。（0秒为自动判断时长）</li>\n<li><code>VQ2</code>：默认设置为 5 秒，支持自定义设置 1 至 10 秒 的任意整数时长。</li>\n<li><code>VQ1</code>：默认设置为 5 秒，仅支持 5 秒 固定时长。</li>\n<li><code>V2.0</code>：默认设置为 4 秒，仅支持 4 秒 固定时长。</li>\n</ul>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"audio\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"audio\">\naudio\n</span>\n<span class=\"api-param-list-item-type\">boolean</span>\n</div>\n<div class=\"api-param-desc\"><p>是否使用音画同步直出能力，默认 true。（仅 VQ4 支持）\n· true：输出带声音的视频（含台词与音效）\n· false：输出静音视频</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"aspect_ratio\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"aspect_ratio\">\naspect_ratio\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>画面比例，默认值：16:9</p>\n<ul>\n<li>通用可选值：16:9, 9:16, 1:1</li>\n<li><code>VQ2</code>模型仅支持 4:3, 3:4</li>\n<li><code>VQ4</code>：默认 16:9，可选 1:1、9:16、16:9、3:4、4:3。</li>\n</ul>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"resolution\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"resolution\">\nresolution\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>分辨率，默认值取决于模型与时长。</p>\n<ul>\n<li><code>VQ2-Pro</code>：默认 720p。可选：540p, 720p, 1080p。</li>\n<li><code>VQ2 (1-10s)</code>：默认 720p。可选：540p, 720p, 1080p。</li>\n<li><code>VQ1 (5s)</code>：默认 1080p。可选：1080p。</li>\n<li><code>V2.0 (4s)</code>：默认 360p。可选：360p, 720p。</li>\n<li><code>VQ4</code>：默认 720p，可选：540p、720p、1080p、2K、4K。</li>\n</ul>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"movement_amplitude\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"movement_amplitude\">\nmovement_amplitude\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>运动幅度，默认值：<code>auto</code>\n可选值：<code>auto</code>, <code>small</code>, <code>medium</code>, <code>large</code>。<br>\n使用<code>VQ2</code>和<code>VQ4</code>模型时该参数不生效。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"seed\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"seed\">\nseed\n</span>\n<span class=\"api-param-list-item-type\">integer</span>\n</div>\n<div class=\"api-param-desc\"><p>随机种子。<br>\n当未传入种子或传入值为0时，系统将自动生成随机数作为种子，确保每次生成结果具有随机性。<br>\n用户可传入非零整数值作为固定种子，以实现结果的可复现性。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"wm_position\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"wm_position\">\nwm_position\n</span>\n<span class=\"api-param-list-item-type\">integer</span>\n</div>\n<div class=\"api-param-desc\"><p>水印位置，默认 3。\n· 1：左上角\n· 2：右上角\n· 3：右下角\n· 4：左下角</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"wm_url\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"wm_url\">\nwm_url\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>水印内容（图片 URL），不传时使用默认水印。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"meta_data\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"meta_data\">\nmeta_data\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>元数据标识，JSON 格式字符串，透传字段；为空时默认使用系统生成的元数据标识。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n</div>\n</details>\n</div>\n</div>\n</div>\n</div>\n</div>\n<div class=\"horizontal-right-panel\">\n<div class=\"code-block request-code-block\">\n<div class=\"code-block-header\">\n<div class=\"code-block-name \">请求结构</div>\n<button class=\"code-copy-btn\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"请求结构 代码\" data-track-value=\"复制\" data-tooltip-text=\"\">\n<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\"> <path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M5.57894 3.45614C5.57894 3.38832 5.63392 3.33333 5.70175 3.33333H12.5439C12.6117 3.33333 12.6667 3.38832 12.6667 3.45614V10.2982C12.6667 10.3661 12.6117 10.4211 12.5439 10.4211H11.7544V5.70175C11.7544 4.89754 11.1025 4.24561 10.2982 4.24561H5.57894V3.45614ZM4.24561 4.24561V3.45614C4.24561 2.65194 4.89754 2 5.70175 2H12.5439C13.3481 2 14 2.65194 14 3.45614V10.2982C14 11.1025 13.3481 11.7544 12.5439 11.7544H11.7544V12.5439C11.7544 13.3481 11.1025 14 10.2982 14H3.45614C2.65194 14 2 13.3481 2 12.5439V5.70175C2 4.89754 2.65194 4.24561 3.45614 4.24561H4.24561ZM3.33333 5.70175C3.33333 5.63392 3.38832 5.57894 3.45614 5.57894H10.2982C10.3661 5.57894 10.4211 5.63392 10.4211 5.70175V12.5439C10.4211 12.6117 10.3661 12.6667 10.2982 12.6667H3.45614C3.38832 12.6667 3.33333 12.6117 3.33333 12.5439V5.70175Z\" fill=\"currentColor\"></path> </svg>\n复制\n</button>\n</div>\n<div class=\"code-block-inner-tab-content doc-tab-content-wrapper\">\n<input id=\"req-code-side-radio-0\" class=\"doc-tab-item-radio\" type=\"radio\" name=\"req-code-side\" checked=\"\" data-index=\"0\">\n<div class=\"doc-tab-content\">\n<pre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#E6EDF3\">curl </span><span style=\"color:#FF7B72\">-</span><span style=\"color:#79C0FF\">X</span><span style=\"color:#79C0FF\"> POST</span><span style=\"color:#A5D6FF\"> \"https://qianfan.baidubce.com/beta/video/generations/qianfan-video\"</span><span style=\"color:#E6EDF3\"> </span></span>\n<span class=\"line\"><span style=\"color:#FF7B72\">  -</span><span style=\"color:#79C0FF\">H</span><span style=\"color:#A5D6FF\"> \"Authorization: Bearer &lt;API Key&gt;\"</span><span style=\"color:#E6EDF3\"> </span></span>\n<span class=\"line\"><span style=\"color:#FF7B72\">  -</span><span style=\"color:#79C0FF\">H</span><span style=\"color:#A5D6FF\"> \"Content-Type: application/json\"</span><span style=\"color:#E6EDF3\"> </span></span>\n<span class=\"line\"><span style=\"color:#FF7B72\">  -</span><span style=\"color:#E6EDF3\">d </span><span style=\"color:#A5D6FF\">'</span><span style=\"color:#FFA198;font-style:italic\">{</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"model\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"VQ4\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"type\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"reference2video\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"model_parameters\"</span><span style=\"color:#E6EDF3\">: {</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"images\"</span><span style=\"color:#E6EDF3\">: [</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">        \"https://example.com/reference-1.png\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">        \"https://example.com/reference-2.png\"</span></span>\n<span class=\"line\"><span style=\"color:#E6EDF3\">    ],</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"sounds\"</span><span style=\"color:#E6EDF3\">: [</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">        \"https://example.com/reference-audio-1.mp3\"</span></span>\n<span class=\"line\"><span style=\"color:#E6EDF3\">    ],</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"prompt\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"参考图中的人物在草地上奔跑，阳光明媚，电影质感\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"duration\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#79C0FF\">5</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"aspect_ratio\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"16:9\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"resolution\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"1080p\"</span></span>\n<span class=\"line\"><span style=\"color:#E6EDF3\">  }</span></span>\n<span class=\"line\"><span style=\"color:#E6EDF3\">}</span><span style=\"color:#A5D6FF\">'</span></span></code></pre>\n</div>\n</div>\n</div>\n</div>\n</div>\n</section>\n<section id=\"example-code\">\n<h2 class=\"section-title\" id=\"示例代码\">示例代码<a class=\"anchor\" aria-label=\"示例代码 permalink\" href=\"#%E7%A4%BA%E4%BE%8B%E4%BB%A3%E7%A0%81\"></a></h2>\n<div class=\"doc-tab-content-wrapper\">\n<input id=\"req-example-tab-0\" class=\"doc-tab-item-radio\" type=\"radio\" name=\"req-example-radio-group\" checked=\"\" data-index=\"0\">\n<div class=\"doc-tab-content\">\n<div class=\"code-block \">\n<div class=\"code-block-header\">\n<div class=\"code-block-name \">请求示例</div>\n<button class=\"code-copy-btn\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"请求示例 代码\" data-track-value=\"复制\" data-tooltip-text=\"\">\n<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\"> <path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M5.57894 3.45614C5.57894 3.38832 5.63392 3.33333 5.70175 3.33333H12.5439C12.6117 3.33333 12.6667 3.38832 12.6667 3.45614V10.2982C12.6667 10.3661 12.6117 10.4211 12.5439 10.4211H11.7544V5.70175C11.7544 4.89754 11.1025 4.24561 10.2982 4.24561H5.57894V3.45614ZM4.24561 4.24561V3.45614C4.24561 2.65194 4.89754 2 5.70175 2H12.5439C13.3481 2 14 2.65194 14 3.45614V10.2982C14 11.1025 13.3481 11.7544 12.5439 11.7544H11.7544V12.5439C11.7544 13.3481 11.1025 14 10.2982 14H3.45614C2.65194 14 2 13.3481 2 12.5439V5.70175C2 4.89754 2.65194 4.24561 3.45614 4.24561H4.24561ZM3.33333 5.70175C3.33333 5.63392 3.38832 5.57894 3.45614 5.57894H10.2982C10.3661 5.57894 10.4211 5.63392 10.4211 5.70175V12.5439C10.4211 12.6117 10.3661 12.6667 10.2982 12.6667H3.45614C3.38832 12.6667 3.33333 12.6117 3.33333 12.5439V5.70175Z\" fill=\"currentColor\"></path> </svg>\n复制\n</button>\n</div>\n<div class=\"code-block-inner-tab-content doc-tab-content-wrapper\">\n<input id=\"req-example-code-0-radio-0\" class=\"doc-tab-item-radio\" type=\"radio\" name=\"req-example-code-0\" checked=\"\" data-index=\"0\">\n<div class=\"doc-tab-content\">\n<pre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#FFA657\">curl</span><span style=\"color:#79C0FF\"> -X</span><span style=\"color:#A5D6FF\"> POST</span><span style=\"color:#A5D6FF\"> \"https://qianfan.baidubce.com/beta/video/generations/qianfan-video\"</span><span style=\"color:#FF7B72\"> \\</span></span>\n<span class=\"line\"><span style=\"color:#79C0FF\">  -H</span><span style=\"color:#A5D6FF\"> \"Content-Type: application/json\"</span><span style=\"color:#FF7B72\"> \\</span></span>\n<span class=\"line\"><span style=\"color:#79C0FF\">  -H</span><span style=\"color:#A5D6FF\"> \"Authorization: Bearer bce-v3/ALTAK-******OgxsPHN/e7cfca2c5428d001524eed0836c058a516f8e467\"</span><span style=\"color:#FF7B72\"> \\</span></span>\n<span class=\"line\"><span style=\"color:#79C0FF\">  -d</span><span style=\"color:#A5D6FF\"> '{</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"type\": \"reference2video\",</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"model\": \"VQ2-Pro\",</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"model_parameters\": {</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      \"images\": [</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">        \"https://example.com/subject_image_1.jpg\"</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      ],</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      \"videos\": [</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">        \"data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZ...\"</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      ],</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      \"prompt\": \"一只可爱的金毛犬在草地上奔跑，阳光明媚，电影级质感，平滑运镜\",</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      \"bgm\": true,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      \"duration\": 5,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      \"aspect_ratio\": \"16:9\",</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      \"resolution\": \"720p\",</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      \"movement_amplitude\": \"auto\",</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">      \"seed\": 0</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    }</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  }'</span></span></code></pre>\n</div>\n</div>\n</div>\n</div>\n</div>\n</section>\n<section id=\"response-params\">\n<h2 class=\"section-title\" id=\"返回响应\">返回响应<a class=\"anchor\" aria-label=\"返回响应 permalink\" href=\"#%E8%BF%94%E5%9B%9E%E5%93%8D%E5%BA%94\"></a></h2>\n<div class=\"horizontal-container\">\n<div class=\"horizontal-left-panel\">\n<div class=\"param-card param-card-empty\">\n<div class=\"param-card-header\">\n<div class=\"param-card-title\">Headers 参数</div>\n<div class=\"param-card-header-desc\">除公共头域外，无其它特殊头域</div>\n</div>\n</div>\n<div class=\"param-card\">\n<div class=\"param-card-header\">\n<div class=\"param-card-title\">返回参数</div>\n</div>\n<div class=\"param-card-content\">\n<div class=\"api-param-list  \">\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"log_id\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"log_id\">\nlog_id\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>日志ID，用于问题排查。</p>\n</div>\n<div class=\"api-param-list-item-required\" data-required=\"\">必选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"task_id\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"task_id\">\ntask_id\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>任务ID，用于后续查询生成结果。</p>\n</div>\n<div class=\"api-param-list-item-required\" data-required=\"\">必选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"status\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"status\">\nstatus\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>任务状态，标识当前任务所处阶段。</p>\n<ul>\n<li><code>created</code> 创建成功</li>\n<li><code>queueing</code> 任务排队中</li>\n<li><code>processing</code> 任务处理中</li>\n<li><code>success</code> 任务成功</li>\n<li><code>failed</code> 任务失败</li>\n</ul>\n</div>\n<div class=\"api-param-list-item-required\" data-required=\"\">必选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"model\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"model\">\nmodel\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>使用的模型名称。</p>\n</div>\n<div class=\"api-param-list-item-required\" data-required=\"\">必选</div>\n</div>\n<div class=\"api-param-list-item api-param-list-item-has-child\">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"images\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"images\">\nimages\n</span>\n<span class=\"api-param-list-item-type\">array</span>\n</div>\n<div class=\"api-param-desc\"><p>图像参考。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n<details class=\"api-param-list-tree\">\n<summary>\n<div class=\"api-param-list-tree-root\">\n<svg width=\"12\" height=\"12\" viewBox=\"0 0 12 12\" fill=\"none\" xmlns=\"http://www.w3.org/2000/svg\"><g><path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M5.59842 7.81538L3.09594 4.71641C2.93376 4.51557 2.98209 4.2337 3.20389 4.08685C3.28912 4.03042 3.39196 4 3.49755 4L8.50249 4C8.77726 4 9 4.2017 9 4.4505C9 4.54611 8.96641 4.63923 8.90409 4.71641L6.40162 7.81538C6.23944 8.01622 5.92816 8.05998 5.70636 7.91312C5.66504 7.88576 5.62863 7.85279 5.59842 7.81538Z\" fill=\"currentColor\"></path></g></svg>\n<span class=\"api-param-list-tree-root-text root-text-show\">显示子属性</span>\n<span class=\"api-param-list-tree-root-text root-text-hide\">隐藏子属性</span>\n</div>\n</summary>\n<div class=\"api-param-list api-param-list-child \">\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"items\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"items\">\nitems\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"></div>\n</div>\n</div>\n</details>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"prompt\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"prompt\">\nprompt\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>输入的提示词内容。</p>\n</div>\n<div class=\"api-param-list-item-required\" data-required=\"\">必选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"duration\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"duration\">\nduration\n</span>\n<span class=\"api-param-list-item-type\">integer</span>\n</div>\n<div class=\"api-param-desc\"><p>视频时长 (秒)。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"seed\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"seed\">\nseed\n</span>\n<span class=\"api-param-list-item-type\">integer</span>\n</div>\n<div class=\"api-param-desc\"><p>使用的随机种子。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"resolution\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"resolution\">\nresolution\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>生成的视频分辨率。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"movement_amplitude\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"movement_amplitude\">\nmovement_amplitude\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>运动幅度。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"aspect_ratio\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"aspect_ratio\">\naspect_ratio\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>画面比例。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"bgm\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"bgm\">\nbgm\n</span>\n<span class=\"api-param-list-item-type\">boolean</span>\n</div>\n<div class=\"api-param-desc\"><p>背景音乐。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"watermark\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"watermark\">\nwatermark\n</span>\n<span class=\"api-param-list-item-type\">boolean</span>\n</div>\n<div class=\"api-param-desc\"><p>本次任务是否使用水印。</p>\n</div>\n<div class=\"api-param-list-item-required\">可选</div>\n</div>\n<div class=\"api-param-list-item \">\n<div class=\"api-param-list-item-title\">\n<span class=\"api-param-list-item-name\" data-copy-text=\"created_at\" data-tooltip-gap=\"8\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"参数名\" data-track-value=\"created_at\">\ncreated_at\n</span>\n<span class=\"api-param-list-item-type\">string</span>\n</div>\n<div class=\"api-param-desc\"><p>任务创建的时间，格式为时间戳字符串（毫秒级）。</p>\n</div>\n<div class=\"api-param-list-item-required\" data-required=\"\">必选</div>\n</div>\n</div>\n</div>\n</div>\n</div>\n<div class=\"horizontal-right-panel\">\n<div class=\"doc-tab-content-wrapper\">\n<input id=\"res-param-tab-0\" class=\"doc-tab-item-radio\" type=\"radio\" name=\"res-param-radio-group\" checked=\"\" data-index=\"0\">\n<div class=\"doc-tab-content\">\n<div class=\"code-block \">\n<div class=\"code-block-header\">\n<div class=\"code-block-name \">响应示例</div>\n<button class=\"code-copy-btn\" data-track-category=\"千帆AI应用开发者中心-API参考\" data-track-name=\"响应示例 代码\" data-track-value=\"复制\" data-tooltip-text=\"\">\n<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" fill=\"none\"> <path fill-rule=\"evenodd\" clip-rule=\"evenodd\" d=\"M5.57894 3.45614C5.57894 3.38832 5.63392 3.33333 5.70175 3.33333H12.5439C12.6117 3.33333 12.6667 3.38832 12.6667 3.45614V10.2982C12.6667 10.3661 12.6117 10.4211 12.5439 10.4211H11.7544V5.70175C11.7544 4.89754 11.1025 4.24561 10.2982 4.24561H5.57894V3.45614ZM4.24561 4.24561V3.45614C4.24561 2.65194 4.89754 2 5.70175 2H12.5439C13.3481 2 14 2.65194 14 3.45614V10.2982C14 11.1025 13.3481 11.7544 12.5439 11.7544H11.7544V12.5439C11.7544 13.3481 11.1025 14 10.2982 14H3.45614C2.65194 14 2 13.3481 2 12.5439V5.70175C2 4.89754 2.65194 4.24561 3.45614 4.24561H4.24561ZM3.33333 5.70175C3.33333 5.63392 3.38832 5.57894 3.45614 5.57894H10.2982C10.3661 5.57894 10.4211 5.63392 10.4211 5.70175V12.5439C10.4211 12.6117 10.3661 12.6667 10.2982 12.6667H3.45614C3.38832 12.6667 3.33333 12.6117 3.33333 12.5439V5.70175Z\" fill=\"currentColor\"></path> </svg>\n复制\n</button>\n</div>\n<div class=\"code-block-inner-tab-content doc-tab-content-wrapper\">\n<input id=\"res-param-code-0-radio-0\" class=\"doc-tab-item-radio\" type=\"radio\" name=\"res-param-code-0\" checked=\"\" data-index=\"0\">\n<div class=\"doc-tab-content\">\n<pre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\"><code><span class=\"line\"><span style=\"color:#E6EDF3\">{</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"log_id\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"as-xxxxxxxxxx\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"task_id\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"697b217128a819d37fce4c4b\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"status\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"created\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"model\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"VQ4\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"images\"</span><span style=\"color:#E6EDF3\">: [</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"https://example.com/reference-1.png\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">    \"https://example.com/reference-2.png\"</span></span>\n<span class=\"line\"><span style=\"color:#E6EDF3\">  ],</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"prompt\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"参考图中的人物在草地上奔跑，阳光明媚，电影质感\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"duration\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#79C0FF\">5</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"seed\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#79C0FF\">12345</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"resolution\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"1080p\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"aspect_ratio\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"16:9\"</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"bgm\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#79C0FF\">false</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"watermark\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#79C0FF\">true</span><span style=\"color:#E6EDF3\">,</span></span>\n<span class=\"line\"><span style=\"color:#A5D6FF\">  \"created_at\"</span><span style=\"color:#E6EDF3\">: </span><span style=\"color:#A5D6FF\">\"1769677169000\"</span></span>\n<span class=\"line\"><span style=\"color:#E6EDF3\">}</span></span></code></pre>\n</div>\n</div>\n</div>\n</div>\n</div>\n</div>\n</div>\n</section>\n<section id=\"other-content\">\n<h2 id=\"错误码\">错误码<a class=\"anchor\" aria-label=\"错误码 permalink\" href=\"#%E9%94%99%E8%AF%AF%E7%A0%81\"></a></h2>\n<p>如果调用失败并返回报错信息，请参见错误码进行解决。</p>\n<p>公共错误码：<a href=\"https://cloud.baidu.com/doc/qianfan-api/s/Om9b4yj3w\" target=\"_blank\">查看公共错误码</a></p>\n<p>本接口专有错误码如下：</p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align:left\">HTTP状态码</th>\n<th style=\"text-align:left\">错误码</th>\n<th style=\"text-align:left\">错误信息</th>\n<th style=\"text-align:left\">错误描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">BadRequest</td>\n<td style=\"text-align:left\">bad request</td>\n<td style=\"text-align:left\">不合法的请求。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">FieldLacking</td>\n<td style=\"text-align:left\">field is missing or empty: {{.fields}}</td>\n<td style=\"text-align:left\">缺少字段，具体字段见错误信息。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">FieldUnwanted</td>\n<td style=\"text-align:left\">unwanted field: {{.fields}}</td>\n<td style=\"text-align:left\">不需要传某些字段，具体字段见错误信息。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">FieldItemCountOutOfRange</td>\n<td style=\"text-align:left\">field item count out of range: {{.fields}}</td>\n<td style=\"text-align:left\">字段数量超出限制（如数组长度超限）。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">PageSizeOutOfRange</td>\n<td style=\"text-align:left\">page size out of range</td>\n<td style=\"text-align:left\"><strong>图像尺寸或格式有问题</strong>。<br>1. 图片大小需小于 50M。<br>2. 格式只支持 jpg/jpeg/png/webp。<br>3. 图片长宽比需要小于 1:4 或者 4:1。<br>4. 跳舞特效的图片长宽比需要在 1:1.2 至 1:2 之间。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">ImageDownloadFailure</td>\n<td style=\"text-align:left\">image download failure</td>\n<td style=\"text-align:left\">下载用户图片URL失败，请检查链接的有效性。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">OperationInProcess</td>\n<td style=\"text-align:left\">operation in process, please retry later</td>\n<td style=\"text-align:left\">请求在处理中，请勿重复提交。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">TaskPromptPolicyViolation</td>\n<td style=\"text-align:left\">prompt policy violation</td>\n<td style=\"text-align:left\">Prompt 触发安审风控。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">ImageFormatInvalid</td>\n<td style=\"text-align:left\">invalid image format</td>\n<td style=\"text-align:left\">图像格式不符合要求。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">AuditSubmitIllegal</td>\n<td style=\"text-align:left\">submit is illegal</td>\n<td style=\"text-align:left\">输入内容（图片或文本）没有通过安全审核。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">CreationPolicyViolation</td>\n<td style=\"text-align:left\">creation policy violation</td>\n<td style=\"text-align:left\">生成物触发风控。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">ModelUnavailable</td>\n<td style=\"text-align:left\">model unavailable</td>\n<td style=\"text-align:left\">请求的模型不可用，调用任务失败，请检查模型类型并重试。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">FieldInvalid</td>\n<td style=\"text-align:left\">invalid field: {{.fields}}</td>\n<td style=\"text-align:left\">传入参数未通过合法性校验。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">ImageCheckBodyJointsFailed</td>\n<td style=\"text-align:left\">Image Check Body Joins Failed</td>\n<td style=\"text-align:left\">输入图人体检测失败，请重新上传。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">ImageCheckFaceFailed</td>\n<td style=\"text-align:left\">Image Check Face Failed</td>\n<td style=\"text-align:left\">输入图人脸检测失败，请重新上传。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">ImageObjectsUndetected</td>\n<td style=\"text-align:left\">Image BodyJoins or Face Too Much Occlusion</td>\n<td style=\"text-align:left\">输入图的人体或人脸有遮挡，请重新上传。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">404</td>\n<td style=\"text-align:left\">TaskNotFound</td>\n<td style=\"text-align:left\">task not found</td>\n<td style=\"text-align:left\">Task id 没找到。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">404</td>\n<td style=\"text-align:left\">CreationNotFound</td>\n<td style=\"text-align:left\">creation not found</td>\n<td style=\"text-align:left\">Creation id 没找到。</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">500</td>\n<td style=\"text-align:left\">InternalServiceFailure</td>\n<td style=\"text-align:left\">internal service failure</td>\n<td style=\"text-align:left\">服务器内部错误，请稍后重试，或联系客服。</td>\n</tr>\n</tbody>\n</table>\n<h3>视频模型通用错误码</h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align:left\">HTTP状态码</th>\n<th style=\"text-align:left\">错误码</th>\n<th style=\"text-align:left\">错误信息</th>\n<th style=\"text-align:left\">错误描述</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td style=\"text-align:left\">500</td>\n<td style=\"text-align:left\">internal_error</td>\n<td style=\"text-align:left\">video_genration_interal_error</td>\n<td style=\"text-align:left\">video generation service interal error</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">400</td>\n<td style=\"text-align:left\">invalid_request_error</td>\n<td style=\"text-align:left\">invalid_lipsync_argument</td>\n<td style=\"text-align:left\"></td>\n</tr>\n<tr>\n<td style=\"text-align:left\">429</td>\n<td style=\"text-align:left\">rate_limit_exceeded</td>\n<td style=\"text-align:left\">video_genration_concurrency_exceeded</td>\n<td style=\"text-align:left\">Rate limit reached for Concurrency</td>\n</tr>\n<tr>\n<td style=\"text-align:left\">403</td>\n<td style=\"text-align:left\">unsafe_request</td>\n<td style=\"text-align:left\">video_genration_prompt_unsafe</td>\n<td style=\"text-align:left\">the content of prompt field is unsafe</td>\n</tr>\n</tbody>\n</table>\n</section>\n</main>","fields":{"slug":"rmwbl4dn9","title":"创建视频生成任务-非主体调用参考生视频","date":"2026-11-11","extractedHeadings":[{"value":"权限说明","depth":2},{"value":"请求参数","depth":2},{"value":"示例代码","depth":2},{"value":"返回响应","depth":2},{"value":"错误码","depth":2}]},"headings":[]}},"pageContext":{"isCreatedByStatefulCreatePages":false,"slug":"rmwbl4dn9","prev":{"id":"ymwbl4dli","name":"创建视频生成任务-文生视频","path":"ymwbl4dli","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video/V1协议/V系列/创建视频生成任务-文生视频.md","seo":null,"parentIds":["Zmwbl43s8","xmwbl4528","Nmwbl45c6","Jmwbl492w","Lmwbl4dfh","Pmwbl4dfo","Omwbl4dfv"],"parents":[{"id":"Zmwbl43s8","documentId":"0098c3f5-6f86-4ca0-ba61-8c65e07a87a5","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Zmwbl43s8","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmwbl4528","documentId":"202d7dd2-1164-424e-98f5-69ab44721f8a","name":"推理API（数据面）","repoName":"qianfan-api","filePath":"模型/推理API（数据面）","disabled":false,"path":"xmwbl4528","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Nmwbl45c6","documentId":"985bba32-c873-4e13-9148-0631067ca278","name":"在线推理","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理","disabled":false,"path":"Nmwbl45c6","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Jmwbl492w","documentId":"d6246d50-4248-474c-8464-26a32dd13bc3","name":"视频生成","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成","disabled":false,"path":"Jmwbl492w","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Lmwbl4dfh","documentId":"42842130-5c2a-4709-b33c-3acb002a7d35","name":"Qianfan-Video","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video","disabled":false,"path":"Lmwbl4dfh","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Pmwbl4dfo","documentId":"76471b8c-6f6f-4cef-9b59-f7f07317644b","name":"V1协议","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video/V1协议","disabled":false,"path":"Pmwbl4dfo","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Omwbl4dfv","documentId":"8bd7c941-4c6d-447c-b7aa-12728b251602","name":"V系列","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video/V1协议/V系列","disabled":false,"path":"Omwbl4dfv","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"next":{"id":"Rmwbl4dp8","name":"创建视频生成任务-主体调用参考生视频","path":"Rmwbl4dp8","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video/V1协议/V系列/创建视频生成任务-主体调用参考生视频.md","seo":null,"parentIds":["Zmwbl43s8","xmwbl4528","Nmwbl45c6","Jmwbl492w","Lmwbl4dfh","Pmwbl4dfo","Omwbl4dfv"],"parents":[{"id":"Zmwbl43s8","documentId":"0098c3f5-6f86-4ca0-ba61-8c65e07a87a5","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Zmwbl43s8","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmwbl4528","documentId":"202d7dd2-1164-424e-98f5-69ab44721f8a","name":"推理API（数据面）","repoName":"qianfan-api","filePath":"模型/推理API（数据面）","disabled":false,"path":"xmwbl4528","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Nmwbl45c6","documentId":"985bba32-c873-4e13-9148-0631067ca278","name":"在线推理","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理","disabled":false,"path":"Nmwbl45c6","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Jmwbl492w","documentId":"d6246d50-4248-474c-8464-26a32dd13bc3","name":"视频生成","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成","disabled":false,"path":"Jmwbl492w","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Lmwbl4dfh","documentId":"42842130-5c2a-4709-b33c-3acb002a7d35","name":"Qianfan-Video","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video","disabled":false,"path":"Lmwbl4dfh","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Pmwbl4dfo","documentId":"76471b8c-6f6f-4cef-9b59-f7f07317644b","name":"V1协议","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video/V1协议","disabled":false,"path":"Pmwbl4dfo","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Omwbl4dfv","documentId":"8bd7c941-4c6d-447c-b7aa-12728b251602","name":"V系列","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video/V1协议/V系列","disabled":false,"path":"Omwbl4dfv","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}]},"parents":[{"id":"Zmwbl43s8","documentId":"0098c3f5-6f86-4ca0-ba61-8c65e07a87a5","name":"模型","repoName":"qianfan-api","filePath":"模型","disabled":false,"path":"Zmwbl43s8","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"xmwbl4528","documentId":"202d7dd2-1164-424e-98f5-69ab44721f8a","name":"推理API（数据面）","repoName":"qianfan-api","filePath":"模型/推理API（数据面）","disabled":false,"path":"xmwbl4528","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Nmwbl45c6","documentId":"985bba32-c873-4e13-9148-0631067ca278","name":"在线推理","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理","disabled":false,"path":"Nmwbl45c6","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Jmwbl492w","documentId":"d6246d50-4248-474c-8464-26a32dd13bc3","name":"视频生成","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成","disabled":false,"path":"Jmwbl492w","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":{"title":null,"keywords":null,"description":null,"serviceType":null},"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Lmwbl4dfh","documentId":"42842130-5c2a-4709-b33c-3acb002a7d35","name":"Qianfan-Video","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video","disabled":false,"path":"Lmwbl4dfh","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Pmwbl4dfo","documentId":"76471b8c-6f6f-4cef-9b59-f7f07317644b","name":"V1协议","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video/V1协议","disabled":false,"path":"Pmwbl4dfo","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null},{"id":"Omwbl4dfv","documentId":"8bd7c941-4c6d-447c-b7aa-12728b251602","name":"V系列","repoName":"qianfan-api","filePath":"模型/推理API（数据面）/在线推理/视频生成/Qianfan-Video/V1协议/V系列","disabled":false,"path":"Omwbl4dfv","lastMergeTime":null,"isApiDoc":null,"httpMethod":null,"seo":null,"sourceOrgName":null,"sourceRepoName":null,"sourceDocumentId":"","solutionTag":null,"solutionColor":null}],"specificSeo":null}}}