8005400010(数字角色视频生成-V1.0.1)

接口信息

API Path
/aipass/aipassweb-api/application/lm/openApi/v1/largeModel/algorithm/8005400010

请求协议
HTTPS

请求方法
POST

请求头部 ：

头部标签	必填	说明	类型	数据字典	限制	头部内容	示例
Content-Type	是	内容类型				application/json	application/json
X-APP-ID	是	控制台--应用管理--创建应用--AppID
Device-Uuid	是	设备管理-设备uuid
Authorization	是	鉴权信息

请求参数 Json
Object

参数名	说明	必填	类型	数据字典	限制	示例
seq_id	请求序列号，请求的唯一标识，长度限制32	是	[string]		0
task_id	能力编号 角色生视频-30010	否	[int]		0
image_type	0,url；1,base64；默认0，本服务仅支持0	否	[int]		0
image	url，仅支持单张图输入	否	[array]		0
video_type	视频类型：0-video必须为url【默认】，1-video必须为base64	否	[int]		0
video	视频url或base64【单视频为字符串，多视频为数组】	否	[string]		0
audio_type	0,url；1,base64；默认0，本服务仅支持0	否	[int]		0
audio	url，仅支持单音频输入	否	[array]		0
prompt	文本内容，支持中英文，建议长度小于200	否	[string]		0
style	生成风格【各算法自定义并在接口文档中体现】	否	[int]		0
batch_size	生成图片/视频等数量【默认1】	否	[int]		0
resolution_ratio	输出结果分辨率比例【各算法自定义并在接口文档中体现，默认[1,1]】；固定2位数组，如[1,1]、[9,16]、[16,9]、[	否	[array]		0
resolution	[480,480],[720,720]，默认值[720,720]	否	[array]		0
expand_ratio	扩图任务扩图比例，list参数为四个float，分别是上下左右扩图比例，如[1.5, 2.0, 1.2, 1.5]	否	[array]		0
poster_material	是否生成海报	否	[boolean]		0
mask_area	["http:xxxx"]，以图片url形式给出，编辑区域的mask，与input_image大小相等，建议单通道的灰度图，需要	否	[array]		0
add_logo	是否添加电信logo，不传则默认不加	否	[boolean]		0
logo_image	logo图base64，如果add_logo为true但logo_image没传则使用默认logo图	否	[string]		0
callback_url	接收回调结果的url地址，return_mode为0是必传	否	[string]		0
extra_message	扩展参数列表	否	[array]		0
extra_message>>key	参数名称	否	[string]		0
extra_message>>value	参数值	否	[object]		0

成功示例

{
    "msg": "调用成功",
    "code": "10000",
    "requestId": "tushengshipin"
}

1、能力简介

数字角色视频生成支持输入图片和音频，输入提示词，输出角色视频。输入符合要求得图片和音频，输入提示词，创作角色视频，控制视频中角色唇形准确说出输入的语音内容。

2、修订历史

修订日期	算法版本号	修订内容
2025-12-01	V1.0.1	初始化API文档

3、服务鉴权

服务接口调用时需要严格遵循服务鉴权规则，服务调用鉴权规则请参见：开发指南 - 接口签名认证。

4、请求参数说明

5、响应结果说明

6、请求示例

{
	"seq_id": "seq_id",
	"task_id": 30010,
	"image": ["<http://xxxx.jpg>"],
	"audio": ["<http://xxxx.wav>"],
	"prompt": "she is dancing in the sun",
	"callback_url": "<http://callbackUrl>",
}

7、状态码说明

状态码	状态描述	状态说明
10000	服务执行成功	服务执行成功
10100	算法模型异常	算法模型调用失败(超时)
10101	结果图片不合规	算法生成图片存在不合规元素，不进行输出
10200	图片下载异常	图片url访问失败，下载异常
10201	图片格式错误	下载后的图片格式不对，非图片（除jpeg, png, jpg）
10202	算法推理异常	算法推理失败
10203	文件上传异常	结果图片上传ceph/minIO失败
10204	图片分辨率过小	图片分辨率过小，算法无法正常生成结果
10205	图片检测到多个人脸	图片检测到多个人脸
10206	图片面部较小	图片检测到脸部过小
10207	人脸仅检测到侧脸	人脸只检测到侧脸
10208	图片不存在人脸	图片不存在人脸
10209	图片姿态不符合要求	人脸朝向不符合要求
10210	图片面部存在遮挡	人脸存在遮挡情况
10211	图片面部模糊	图片人脸过于模糊
10212	图片不完整	图片中的人物非全身照，可能存在人体部分被遮挡情况
10213	图片脸部不完整	图片脸部不完整
10214	图片宽高比不符	图生视频任务中图片宽高比不符
10215	输入提示词违禁	10005对输入提示词有限制，20009无法处理输入提示词
10216	实例数量与位置框数量不一致	10008实例数量与位置框数量不一致
10217	位置框坐标未归一化	10008位置框坐标未归一化
10218	位置框中存在坐标列表不为4个的	10008位置框中存在坐标列表不为4个的
10219	图片不符合算法要求	20017输入图像不是方图
10220	自定义图片不符合算法要求	20017输入自定义背景图不是方图
10221	图片分辨率过大	20016-号百三节：图片分辨率过大，图片面积超出10000px*10000px
10222	结果图片分辨率太小
10223	输入图像与mask尺寸不一致
10224	输入图片分辨不符
10301	服务必填参数缺失	服务必填参数缺失或未填写
10304	服务入参错误	部分参数存在限制说明，会针对入参做校验返回；例如传入的style风格不在范围内，prompt入参不合规等情况
10400	视频下载异常	视频url访问失败，下载异常
10401	任务繁忙	30001生成视频任务排队超出限制数量
10402	视频格式错误	算法不支持的视频，视频文件损坏无法读取等
10403	视频分辨率不符	视频分辨率不符合算法要求
10404	视频时长不符	视频时长不在算法处理范围内
10405	视频人物未检测	视频未检测到人物
10406	视频首图获取错误	视频截取首帧图异常
10500	设备未授权
10600	音频下载异常	音频url访问失败
10601	音频格式错误	非音频文件，音频文件损坏无法正常保存等情况
10903	服务执行失败	服务执行失败(可能存在组件连接异常、算法模型程序运行异常等情况，导致服务无法正常运行)