创建视频生成任务
创建一个视频生成任务。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
用于生成视频的模型,目前已支持的模型:
· T2V-01-Director
· S2V-01
· I2V-01-live
· I2V-01
· T2V-01
正向文本提示词,最大2000字符,说明:
当modle选择为T2V-01-Director时,对prompt中的运镜控制,有更准确的响应。
(1)支持插入运镜指令,实现运镜控制:运镜指令需以[ ]格式插入prompt中镜头应用处,标准运镜指令格式为[C1,C2,C3],其中C表示不同类型运镜,共支持15种枚举运镜方式,具体可参考下方详情。为保证运镜效果,建议组合运镜指令不超过3个。
① 支持15种运镜方式,可选值如下:
· 左右移:[左移]、[右移]
· 左右摇:[左摇]、[右摇]
· 推拉:[推进]、[拉远]
· 升降:[上升]、[下降]
· 上下摇:[上摇]、[下摇]
· 变焦:[变焦推近]、[变焦拉远]
· 晃动:[晃动]
· 跟随:[跟随]
· 固定:[固定]
② 支持单一及组合运镜
· 单一运镜:例如[左摇],表示插入单一镜头;
· 多运镜同时生效:同一组内的镜头表示同时生效,如[左摇,右移],表示插入两个组合镜头,且同时生效;
· 多运镜先后生效:插入在前的镜头指令,先生效。如在prompt描述“xxx[左摇],xxx[右移] ” 表示:视频生成时,先运行左摇镜头,后运行右移镜头;
· 更多运镜教程及模板,可参考运镜使用教程。
(2)支持通过自然语言描述,实现运镜控制;使用指令内运镜名称,会提升运镜响应准确性。
(3) 运镜指令与自然语言描述可同时生效。
说明:
(1)默认取值为True,模型会自动优化传入的prompt,以提升生成质量。
(2)如果需要更精确的控制,可以将此参数设置为False,模型将更加严格地遵循指令。此时建议提供更精细的prompt,以获得最佳效果。
当model选择为I2V-01、I2V-01-live时可用,说明:
(1)模型将以此参数中传入的图片为首帧画面来生成视频。支持传入图片的
data:image/jpeg;base64,{data}格式的 Base64 编码字符串,或可通过公网访问的 URL。传入此参数时支持将prompt设置为空字符串或不传入prompt,模型将自主决定画面如何演变。
(2)传入图片需要满足以下条件:格式为JPG/JPEG/PNG;长宽比大于2:5、小于5:2;短边像素大于300px;体积不大于20MB。
当model选择为S2V-01时可用。模型将依据此参数中上传的主体来生成视频。目前仅支持单主体参考(数组长度为 1)
显示子属性
隐藏子属性
显示子属性
隐藏子属性
主体类型,目前仅支持"character",即人物面部主体。
说明:
(1)主体参考图的data:image/jpeg;base64,{data}格式的Base64 编码字符串,或可通过公网访问的 URL,以字符串形式存储在数组中(暂时数组长度仅支持为 1,即单图参考)
(2)主体参考图片尺寸需小于20MB,格式支持jpg、jpeg、png
(3)图片中需要包含有效主体信息,否则视频生成过程将会失败(任务创建时不会受阻),此情况下将会在查询接口中返回视频生成任务失败状态。
发起任务创建请求时,MiniMax服务器将向请求地址发送一条包含校验字段的请求,当请求地址收到该 POST 校验请求时,需要提取出challenge值,并在3秒内返回包含challenge值的响应数据,否则将无法通过校验,创建任务失败。说明:
(1)响应数据示例:
{ "challenge": "1a3cs1***eabc3u"}
成功配置回调请求地址后,当视频生成任务有状态变化时,MiniMax服务器将向此地址发送包含任务最新状态的回调请求。
回调请求内容结构与查询视频生成任务状态API的返回体一致(不包含video_width和video_height)。
(2)回调返回的"status"包括以下状态:
· processing:生成中
· success:成功
· failed:失败
POST /beta/video/generations/minimax HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"model": "T2V-01-Director",
"prompt": "海边鱼肚子里发现一张纸条上面写着MiniMax"
}
示例代码
curl --location 'https://qianfan.baidubce.com/beta/video/generations/minimax' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-*********/614fb**********' \
--data '{
"model": "T2V-01-Director",
"prompt": "海边鱼肚子里发现一张纸条上面写着MiniMax"
}'
返回响应
视频生成异步任务的任务id,生成结果需要通过使用此id在异步任务查询接口中获取。
状态码及其详情
显示子属性
隐藏子属性
状态码及其分别含义如下:
· 0:请求成功
· 1026:视频描述涉及敏感内容
· 2013:传入参数异常,请检查入参是否按要求填写
错误详情
{
"id": "as-xx"
"task_id": "106916112212032",
"base_resp": {
"status_code": 0,
"status_msg": "success"
}
}
错误码
如果请求错误,请查看错误码说明。
评价此篇文章
