创建主体
更新时间：2026-03-09
POST
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
本接口用于创建一个主体生成任务，同步返回主体创建信息。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
model
string
模型名称。
固定值：Custom-Elements
必选
type
string
任务类型。
固定值：omni-video
必选
model_parameters
object {4}
模型参数配置。
必选
显示子属性
隐藏子属性
element_name
string
主体名称。
长度限制：最大 20 字符。
必选
element_description
string
主体描述。
长度限制：最大 20 字符。
必选
element_frontal_image
string
主体正面参考图像，作为主体特征识别的核心参考。
数据格式：支持 HTTP URL 或 Base64 编码字符串。
文件约束：
● 格式：.jpg / .jpeg / .png
● 大小：≤ 10MB
● 分辨率：宽或高 ≥ 300px
● 宽高比范围：1:2.5 ~ 2.5:1。
必选
element_refer_list
array
主体补充参考图列表，通过多角度图像辅助定义主体外观。
数量限制：1～3 张。
必选
显示子属性
隐藏子属性
items
object {1}
显示子属性
隐藏子属性
image_url
string
参考图 URL 或 Base64 字符串。
可选
请求结构
POST /beta/video/generations/qianfan-video HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"model": "Custom-Elements",
"type": "omni-video",
"model_parameters": {
"element_name": "狗狗",
"element_description": "博美犬",
"element_frontal_image": "https://testdde.bj.bcebos.com/%E7%94%9F%E6%88%90%E7%8B%97%E7%8B%97%E5%9B%BE%E7%89%87.png",
"element_refer_list": [
{
"image_url": "https://testdde.bj.bcebos.com/%E7%94%9F%E6%88%90%E7%8B%97%E7%8B%97%E5%9B%BE%E7%89%87%20(1).png"
}
]
}
}示例代码
基础调用
curl -X POST "https://qianfan.baidubce.com/beta/video/generations/qianfan-video" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"model": "Custom-Elements",
"type": "omni-video",
"model_parameters": {
"element_name": "狗狗",
"element_description": "博美犬",
"element_frontal_image": "https://testdde.bj.bcebos.com/%E7%94%9F%E6%88%90%E7%8B%97%E7%8B%97%E5%9B%BE%E7%89%87.png",
"element_refer_list": [
{
"image_url": "https://testdde.bj.bcebos.com/%E7%94%9F%E6%88%90%E7%8B%97%E7%8B%97%E5%9B%BE%E7%89%87%20(1).png"
}
]
}
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
data
object {6}
响应的核心数据对象。
必选
显示子属性
隐藏子属性
element_id
integer
主体ID。
必选
element_name
string
主体名称。
必选
element_description
string
主体详细描述。
必选
element_frontal_image
string
主体正面参考图。
必选
element_refer_list
array
主体补充参考图。
必选
显示子属性
隐藏子属性
items
object {1}
显示子属性
隐藏子属性
image_url
string
参考图 URL 或 Base 64 编码。
可选
owned_by
string
所有者。
必选
message
string
响应消息状态。
必选
request_id
string
请求ID。
必选
json
{
"data": {
"element_id": 850482101115179038,
"element_name": "狗狗",
"element_description": "博美犬",
"element_frontal_image": "https://p2-kling.klingai.com/bs2/klingai-kling-input-stunt/muse/766442622855942214/IMAGE/20260211/5eeaf7b605d3b54ec42fe5520a199bd2-fe100a8f-5762-494c-8054-df8898cd4428?x-kcdn-pid=112452",
"element_refer_list": [
{
"image_url": "https://p2-kling.klingai.com/bs2/klingai-kling-input-stunt/muse/766442622855942214/IMAGE/20260211/bc7e446b7adf165911af4ecb9fc9b12a-3c034061-7ad9-4e62-a3c3-92fcd3acf959?x-kcdn-pid=112452"
}
],
"owned_by": "766442622855942214"
},
"message": "SUCCEED",
"request_id": "as-pc8fz6waig"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
视频模型通用错误码
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 500 | internal_error | video_genration_interal_error | video generation service interal error |
| 400 | invalid_request_error | invalid_lipsync_argument | |
| 429 | rate_limit_exceeded | video_genration_concurrency_exceeded | Rate limit reached for Concurrency |
| 403 | unsafe_request | video_genration_prompt_unsafe | the content of prompt field is unsafe |
评价此篇文章