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

创建文生视频任务，通过输入纯文本提示词生成视频，返回task_id用于后续查询结果。

\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\ntype\n\nstring\n
\n

任务类型，固定值：text2video

\n
\n
必选
\n
\n
\n
\n\nmodel\n\nstring\n
\n

模型名称。可选值:

\n
    \n
  • VQ3-Pro：支持音画同步及分镜生成，画质效果最佳。
    • \n
  • VQ3-Turbo：支持音画同步及分镜生成，生成速度更快。
    • \n
  • VQ2：最新模型，生成速度快，综合效果优秀。
    • \n
\n
\n
必选
\n
\n
\n
\n\nmodel_parameters\n\nobject {7}\n
\n

模型参数配置。

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

文本提示词，生成视频的文本描述，字符长度不能超过 1500 个字符

\n
\n
必选
\n
\n
\n
\n\nduration\n\ninteger\n
\n

视频时长（单位：秒）。

\n
    \n
  • VQ3 系列：默认值 5s，可选范围：1 - 16 的任意整数
    • \n
  • VQ2：默认值 5s，可选范围：1 - 10 的任意整数；
    • \n
\n
\n
可选
\n
\n
\n
\n\nseed\n\ninteger\n
\n

随机种子。
\n当未传入种子或传入值为0时，系统将自动生成随机数作为种子，确保每次生成结果具有随机性。
\n用户可传入非零整数值作为固定种子，以实现结果的可复现性。

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

视频比例，默认值 16:9。
\n可选值: 16:9、9:16、1:1。
\n注：3:4 和 4:3 仅支持 VQ2和VQ3系列模型。

\n
\n
可选
\n
\n
\n
\n\nresolution\n\nstring\n
\n

分辨率参数，默认值依据模型和视频时长而定：

\n
    \n
  • VQ3-Pro、VQ3-Turbo：默认 720p，可选：540p、720p、1080p
    • \n
  • VQ2（1-8秒）：默认为 720p，可选：540p、720p、1080p
    • \n
\n
\n
可选
\n
\n
\n
\n\nbgm\n\nboolean\n
\n

是否为生成的视频添加背景音乐，默认值：false。

\n
    \n
  • true：开启。系统将从预设 BGM 库中自动挑选并适配适合视频时长的音乐。
    • \n
  • false：关闭。不添加背景音乐。\n生效限制：
    • \n
  • 该参数在VQ3模型中不生效。
    • \n
  • 在 VQ2 系列模型且视频时长 (duration) 设置为 9秒 或 10秒 时，bgm参数不生效。
    • \n
\n
\n
可选
\n
\n
\n
\n\naudio\n\nboolean\n
\n

是否使用音视频直出能力，默认为 true

\n
    \n
  • false：静音视频
    • \n
  • true：音画同步视频
    \n注：仅 VQ3系列模型支持该参数。
    • \n
\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{\n  \"type\": \"text2video\",\n  \"model\": \"VQ3-Pro\",\n  \"model_parameters\": {\n    \"prompt\": \"一座位于云端的未来主义城市，赛博朋克风格，高质量，高细节。\",\n    \"duration\": 5,\n    \"seed\": 0,\n    \"aspect_ratio\": \"16:9\",\n    \"resolution\": \"1080p\",\n    \"bgm\": false,\n    \"audio\": true\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    \"type\": \"text2video\",\n    \"model\": \"VQ3-Pro\",\n    \"model_parameters\": {\n      \"prompt\": \"一座位于云端的未来主义城市，赛博朋克风格，高质量，高细节。\",\n      \"duration\": 5,\n      \"seed\": 0,\n      \"aspect_ratio\": \"16:9\",\n      \"resolution\": \"1080p\",\n      \"bgm\": false,\n      \"audio\": true\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\nlog_id\n\nstring\n
\n

请求的唯一标识 log_id

\n
\n
必选
\n
\n
\n
\n\ntask_id\n\nstring\n
\n

任务ID，用于后续查询生成结果。

\n
\n
必选
\n
\n
\n
\n\nstatus\n\nstring\n
\n

任务状态，标识当前任务所处阶段。

\n
    \n
  • created 创建成功
    • \n
  • queueing 任务排队中
    • \n
  • processing 任务处理中
    • \n
  • success 任务成功
    • \n
  • failed 任务失败
    • \n
\n
\n
必选
\n
\n
\n
\n\nmodel\n\nstring\n
\n

使用的模型名称。

\n
\n
必选
\n
\n
\n
\n\nprompt\n\nstring\n
\n

输入的提示词内容。

\n
\n
必选
\n
\n
\n
\n\nduration\n\ninteger\n
\n

视频时长 (秒)。

\n
\n
可选
\n
\n
\n
\n\nseed\n\ninteger\n
\n

使用的随机种子。

\n
\n
可选
\n
\n
\n
\n\nresolution\n\nstring\n
\n

生成的视频分辨率。

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

视频比例。

\n
\n
可选
\n
\n
\n
\n\ncreated_at\n\nstring\n
\n

任务创建时间，格式为 ISO 8601

\n
\n
必选
\n
\n
\n
\n\nbgm\n\nboolean\n
\n

仅请求参数 bgm 为 true 时回显

\n
\n
可选
\n
\n
\n
\n
\n
\n
\n
\n\n
\n
\n
\n
响应示例
\n\n
\n
\n\n
\n
{\n    \"log_id\": \"as-pfsjh52npm\",\n    \"task_id\": \"69ba527fcb4dd0d29f59d415\",\n    \"status\": \"created\",\n    \"model\": \"VQ3-Pro\",\n    \"prompt\": \"一座位于云端的未来主义城市，赛博朋克风格，高质量，高细节。\",\n    \"duration\": 5,\n    \"seed\": 0,\n    \"resolution\": \"1080p\",\n    \"aspect_ratio\": \"16:9\",\n    \"created_at\": \"1773818495000\"\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状态码错误码错误信息错误描述
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":"ymwbl4dli","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":"ymwbl4dli","prev":{"id":"bmwbl4djs","name":"创建视频生成任务-首尾帧生视频","path":"bmwbl4djs","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":"rmwbl4dn9","name":"创建视频生成任务-非主体调用参考生视频","path":"rmwbl4dn9","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}}}