创建视频生成任务
调用本接口,使用视频生成妙影(Shadow)创建一个视频生成任务。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
用于生成视频的模型。
图生视频:shadow-i2v
输入给模型,生成视频的信息,支持文本信息和图片信息。
显示子属性
隐藏子属性
多选一,只需要符合下列任意一组子节点
支持文本信息和图片信息,图片信息为必填信息,文本信息为选填信息。
显示子属性
隐藏子属性
文本信息(选填)
显示子属性
隐藏子属性
输入内容的类型,此处应为 text。
输入给模型的文本内容,描述期望生成的视频内容。 支持中英文,中文效果更佳,中文内容建议500字以内。
图像信息(必填)
显示子属性
隐藏子属性
输入内容的类型,此处应为 image_url。
输入给模型的图片信息,限制条件如下:
图片格式:JPEG、JPG、PNG、WEBP
图片大小:不超过10MB
图片尺寸:不小于300px
显示子属性
隐藏子属性
图片信息,支持图片 URL 或图片 Base64 编码。
图片URL:请确保图片URL可被访问。
Base64编码:目前支持带前缀和不带前缀两种格式的Base64编码,以下为具体示例:
1、不带前缀的Base64编码参数:iVBORw0KGgoA...IAXDIBKE0DHxrk
2、前缀的Base64编码:data:image/png;base64,iVB...E0DHxgljNBAA
生成视频的时长,单位:秒,不同模型可选时间范围不同:
shadow-i2v 默认为 5,可选:5
prompt智能改写,默认开启。开启后使用大模型对输入prompt进行智能改写。对于较短的prompt生成效果提升明显,但会增加耗时。
- true:开启智能改写。
- false:不开启智能改写。
POST /video/generations HTTP/1.1
Host: qianfan.baidubce.com
Authorization: authorization string
{
"model": "shadow-i2v",
"content": [
{
"type": "text",
"text": "嫦娥的裙摆和丝带随液态水墨与银河星尘流动,拉出绚丽的长长光尾,光尾中闪烁着点点星光。她伸出手指触碰前方巨大的月球,指尖荡开一圈涟漪般的金色光环。风格:新国风美学,流体模拟,粒子特效,震撼美丽,水墨与星尘的流体特效、粒子光尾、动态唯美"
},
{
"type": "image_url",
"image_url": {
"url": "https://mb-pm-wendang.bj.bcebos.com/Shadow/1758879979036.jpg"
}
}
]
}
示例代码
curl --location 'https://qianfan.baidubce.com/video/generations' \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $QIANFAN_API_KEY"
-d '{
"model": "shadow-i2v",
"content": [
{
"type": "text",
"text": "嫦娥的裙摆和丝带随液态水墨与银河星尘流动,拉出绚丽的长长光尾,光尾中闪烁着点点星光。她伸出手指触碰前方巨大的月球,指尖荡开一圈涟漪般的金色光环。风格:新国风美学,流体模拟,粒子特效,震撼美丽,水墨与星尘的流体特效、粒子光尾、动态唯美"
},
{
"type": "image_url",
"image_url": {
"url": "https://mb-pm-wendang.bj.bcebos.com/Shadow/1758879979036.jpg"
}
}
]
}
'
返回响应
本次请求的唯一标识,可用于排查问题。
视频生成任务ID,用于查询视频生成任务进展或问题排查。
{
"id": "as-***",
"task_id": "67c999d***8e8c05a4"
}
错误码
如果调用失败并返回报错信息,请参见错误码进行解决。
公共错误码:查看公共错误码
本接口专有错误码如下:
http状态码 | type | code | message |
---|---|---|---|
500 | internal_error | video_generation_internal_error | video generation service internal error |
400 | invalid_request_error | invalid_video_generation_argument | xxx |
429 | rate_limit_exceeded | video_generation_concurrency_exceeded | Rate limit reached for Concurrency |
403 | unsafe_request | video_generation_prompt_unsafe | The input image/prompt is unsafe. |
403 | unsafe_request | video_generation_output_unsafe | The output is unsafe. |
501 | internal_error | video_generation_risk_system_error | risk control system internal error |