创建主体
更新时间：2026-02-11
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}
Custom-Elements特定参数，详见model_parameters说明
必选
显示子属性
隐藏子属性
element_name
string
主体名称，不能超过20个字符
必选
element_description
string
主体描述，不能超过20个字符
必选
element_frontal_image
string
主体正面参考图，支持传入图片Base64编码或图片URL（确保可访问）。图片格式支持.jpg / .jpeg / .png。图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比要在1:2.5 ~ 2.5:1之间
必选
element_refer_list
array
主体其他参考列表，可通过上传多张、不同角度的主体参考图来定义主体外观。至少上传1张参考图，至多上传3张参考图
必选
显示子属性
隐藏子属性
items
object {1}
显示子属性
隐藏子属性
image_url
string
图片URL
可选
请求结构
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": "xxx",
"element_refer_list": [
{
"image_url": "xxx"
}
]
}
}示例代码
基础调用
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": "xxx",
"element_refer_list": [
{
"image_url": "xxx"
}
]
}
}'返回响应
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
可选
owned_by
string
所有者
可选
message
string
消息
可选
request_id
string
请求ID
可选
成功响应
{
"data": {
"element_id": 123,
"element_name": "天台",
"element_description": "天台阳光",
"element_frontal_image": "xxx",
"element_refer_list": [
{
"image_url": "xxx"
}
],
"owned_by": "xxx"
},
"message": "SUCCEED",
"request_id": "as-xxx"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
本接口专有错误码如下：
| HTTP状态码 | 错误码 | 错误信息 | 错误描述 |
|---|---|---|---|
| 0 | 请求成功 | - | - |
| 1100 | 账户异常 | 账户异常 | 检查账户配置信息 |
| 1200 | 请求参数非法 | 请求参数非法 | 检查请求参数是否正确 |
| 1201 | 请求参数非法 | 参数非法，如key写错或value非法 | 参考返回体中message字段的具体信息，修改请求参数 |
| 1202 | 请求参数非法 | 请求的method无效 | 查看接口文档，使用正确的request method |
| 1203 | 请求参数非法 | 请求的资源不存在，如模型 | 参考返回体中message字段的具体信息，修改请求参数 |
| 1300 | 触发策略 | 触发平台策略 | 检查是否触发平台策略 |
| 1301 | 触发策略 | 触发平台的内容安全策略 | 检查输入内容，修改后重新发起请求 |
| 5000 | 内部错误 | 服务器内部错误 | 稍后重试，或联系客服 |
| 5001 | 内部错误 | 服务器暂时不可用，通常是在维护 | 稍后重试，或联系客服 |
| 5002 | 内部错误 | 服务器内部超时，通常是发生积压 | 稍后重试，或联系客服 |
视频模型通用错误码
| 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 |