查询主体列表
更新时间：2026-03-09
GET
https://qianfan.baidubce.com/beta/video/generations/qianfan-video
本接口用于查询自定义或预置主体的任务详情。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Query 参数
model
string
查询主体类型。
- 自定义主体列表：
Custom-Elements - 预置主体列表：
Presets-Elements
必选
pageNum
integer
页码，默认值为1，取值范围：[1,1000]
可选
pageSize
integer
每页数据量，默认值30，取值范围：[1,500]
可选
请求结构
GET /beta/video/generations/qianfan-video?model={model}&pageNum={pageNum}&pageSize={pageSize} HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>示例代码
curl
curl -X GET "https://qianfan.baidubce.com/beta/video/generations/qianfan-video?model=Presets-Elements" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408"返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
data
array
主体信息列表。
必选
显示子属性
隐藏子属性
items
object {7}
显示子属性
隐藏子属性
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 编码。
可选
tag_list
array
主体关联的分类标签列表。
必选
显示子属性
隐藏子属性
items
object {3}
显示子属性
隐藏子属性
id
string
标签唯一标识 ID。
可选
name
string
标签名称。
可选
description
string
标签描述。
可选
owned_by
string
主体所有者。
必选
message
string
响应消息状态。
必选
request_id
string
请求ID。
必选
json
{
"data": [
{
"element_id": 171,
"element_name": "天台",
"element_description": "天台",
"element_frontal_image": "https://p2-****.***ai.com/bs2/upload-ylab-stunt/element/%E5%A4%A9%E5%8F%B0-%E4%B8%BB%E8%A6%81%E5%8F%82%E8%80%83.jpeg?x-kcdn-pid=112452",
"element_refer_list": [
{
"image_url": "https://p2-****.***ai.com/bs2/upload-ylab-stunt/element/%E5%A4%A9%E5%8F%B0-%E5%85%B6%E4%BB%96%E5%8F%82%E8%80%831.png?x-kcdn-pid=112452"
}
],
"tag_list": [
{
"id": "o_106",
"name": "场景",
"description": "None"
}
],
"owned_by": "****"
}
],
"message": "SUCCEED",
"request_id": "as-aebw4esxxh"
}错误码
如果调用失败并返回报错信息，请参见错误码进行解决。
公共错误码：查看公共错误码
视频模型通用错误码
| 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 |
评价此篇文章