lianfan.huiwa.task.video.submit (视频生成)

视频任务的提交

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
batch_gen_video_top_req BatchGenVideoTopReq 必须 请求接口的参数,目前支持自定义动作的模式
  • request
  • BatchGenVideoRequest
  • 必须
  • 业务生图视频的参数
  • gen_video_requests
  • GenVideoRequest []
  • 必须
  • {}
  • 生图请求,目前仅支持一次一个请求
  • └ duration
  • Number
  • 可选
  • 5
  • 视频时长,单位 s,支持如下数值:5,10,15,30,60,90 以及-1。-1仅用于爆款裂变,表示时长接近参考视频
  • └ pass_through
  • String
  • 可选
  • {}
  • 透传参数
  • └ description
  • String
  • 可选
  • 天上下着雨
  • 生成视频的描述
  • input_images
  • AigcVideoInputImgDTO
  • 可选
  • 输入图片
  • image_info_list
  • VideoInputImageDTO []
  • 可选
  • https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg
  • 图片列表
  • └ original_image_url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg
  • 生成视频的图片
  • last_frame_list
  • VideoInputImageDTO []
  • 可选
  • https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg
  • 图片列表
  • └ image_url
  • String
  • 可选
  • https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg
  • 尾帧图参数
  • └ neg_description
  • String
  • 可选
  • 抖动
  • 负向描述
  • └ gen_ratio
  • String
  • 可选
  • 3:4
  • 生成视频比例,支持3:4,1:1,9:16,16:9
  • └ custom_video_mode
  • String
  • 可选
  • std
  • 清晰度,std标准,pro高清
  • └ count
  • Number
  • 可选
  • 1
  • 一次生成视频个数,最多4个
  • video_templates
  • AigcVideoTemplateGroupDTO
  • 可选
  • 参考视频,视频复刻只能传1个
  • template_list
  • AigcVideoTemplateDTO []
  • 可选
  • [1]
  • 参考视频,视频复刻,爆款裂变只能传1个
  • └ template_id
  • String
  • 可选
  • 1
  • 参考视频id
  • └ video_url
  • String
  • 可选
  • https://cloud.video.taobao.com/vod/l-iiwZUuAPIo0Um-EyEFYjl0cRB3ZajC5CouGjz7Kf8.mp4
  • 参考视频url,在需要参考视频的情况下,url和id这两个属性必须指定一个
  • └ per_tmpl_output_size
  • Number
  • 可选
  • 8
  • 用每个参考视频生成的视频条数,默认为8。[爆款裂变使用]
  • └ sub_action
  • Number
  • 可选
  • 1
  • 视频复刻使用,0表示更像参考视频,1更自然
  • input_videos
  • AigcVideoMaterialDTO []
  • 可选
  • [ { "video_url": "https://cloud.video.taobao.com/vod/l-iiwZUuAPIo0Um-EyEFYjl0cRB3ZajC5CouGjz7Kf8.mp4" } ]
  • 输入视频列表
  • └ video_url
  • String
  • 可选
  • https://cloud.video.taobao.com/vod/l-iiwZUuAPIo0Um-EyEFYjl0cRB3ZajC5CouGjz7Kf8.mp4
  • 输入视频url
  • advanced_config
  • AigcVideoAdvancedConfigDTO
  • 可选
  • 高级参数
  • └ tone_style_id
  • String
  • 可选
  • general
  • 音色id
  • └ open_subtitle
  • Boolean
  • 可选
  • true
  • 视频字幕的开关,默认为开
  • └ keep_original_audio
  • Boolean
  • 可选
  • false
  • 保留原视频的音频,默认不保留
  • item_info
  • AigcVideoItemInfoDTO
  • 可选
  • 商品信息
  • └ item_name
  • String
  • 可选
  • 小黑金香水
  • 商品名
  • └ item_sellingpoint
  • String
  • 可选
  • 方方瓶身沉稳大气;英文标签很有质感;玻璃瓶身拿在手里有分量;香水礼盒包装送礼有面子;盒子背面有使用说明;金色瓶盖小细节设计
  • 商品卖点
  • └ task_biz_type
  • Number
  • 必须
  • 16
  • 生成视频类型,目前15表示动作复刻,16表示图生视频, 47表示商品替换,49表示视频去字幕,52表示爆款裂变,50表示视频分镜切分,55表示萌宠替换
  • └ sub_task_type
  • Number
  • 可选
  • 22
  • 视频的子类型,目前23对应分镜视频

响应参数

名称 类型 示例值 描述
succeed Boolean true 是否成功
error_codes ErrorCodeDTO errorCodes
  • └ code
  • String
  • error
  • 错误码
  • └ message
  • String
  • error
  • 错误描述
model GenVideoSubmitResult [] model
  • └ task_id
  • Number
  • 12
  • 任务id
  • └ pass_through
  • String
  • {}
  • 透传参数
  • └ error_msg
  • String
  • error
  • 错误信息
  • └ error_code
  • String
  • error
  • 错误码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LianfanHuiwaTaskVideoSubmitRequest req = new LianfanHuiwaTaskVideoSubmitRequest();
LianfanHuiwaTaskVideoSubmitRequest.BatchGenVideoTopReq obj1 = new LianfanHuiwaTaskVideoSubmitRequest.BatchGenVideoTopReq();
LianfanHuiwaTaskVideoSubmitRequest.BatchGenVideoRequest obj2 = new LianfanHuiwaTaskVideoSubmitRequest.BatchGenVideoRequest();
List<LianfanHuiwaTaskVideoSubmitRequest.GenVideoRequest> list4 = new ArrayList<LianfanHuiwaTaskVideoSubmitRequest.GenVideoRequest>();
LianfanHuiwaTaskVideoSubmitRequest.GenVideoRequest obj5 = new LianfanHuiwaTaskVideoSubmitRequest.GenVideoRequest();
list4.add(obj5);
obj5.setDuration(5L);
obj5.setPassThrough("{}");
obj5.setDescription("天上下着雨");
LianfanHuiwaTaskVideoSubmitRequest.AigcVideoInputImgDTO obj7 = new LianfanHuiwaTaskVideoSubmitRequest.AigcVideoInputImgDTO();
List<LianfanHuiwaTaskVideoSubmitRequest.VideoInputImageDTO> list9 = new ArrayList<LianfanHuiwaTaskVideoSubmitRequest.VideoInputImageDTO>();
LianfanHuiwaTaskVideoSubmitRequest.VideoInputImageDTO obj10 = new LianfanHuiwaTaskVideoSubmitRequest.VideoInputImageDTO();
list9.add(obj10);
obj10.setOriginalImageUrl("https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg");
obj7.setImageInfoList(list9);
List<LianfanHuiwaTaskVideoSubmitRequest.VideoInputImageDTO> list12 = new ArrayList<LianfanHuiwaTaskVideoSubmitRequest.VideoInputImageDTO>();
LianfanHuiwaTaskVideoSubmitRequest.VideoInputImageDTO obj13 = new LianfanHuiwaTaskVideoSubmitRequest.VideoInputImageDTO();
list12.add(obj13);
obj13.setImageUrl("https://img.alicdn.com/imgextra/i2/2217654845903/O1CN01JhFZiG1tTcwJqSUj9_!!2217654845903-0-aigc_business_user.jpg");
obj7.setLastFrameList(list12);
list6.setInputImages(obj7);
obj5.setNegDescription("抖动");
obj5.setGenRatio("3:4");
obj5.setCustomVideoMode("std");
obj5.setCount(1L);
LianfanHuiwaTaskVideoSubmitRequest.AigcVideoTemplateGroupDTO obj15 = new LianfanHuiwaTaskVideoSubmitRequest.AigcVideoTemplateGroupDTO();
List<LianfanHuiwaTaskVideoSubmitRequest.AigcVideoTemplateDTO> list17 = new ArrayList<LianfanHuiwaTaskVideoSubmitRequest.AigcVideoTemplateDTO>();
LianfanHuiwaTaskVideoSubmitRequest.AigcVideoTemplateDTO obj18 = new LianfanHuiwaTaskVideoSubmitRequest.AigcVideoTemplateDTO();
list17.add(obj18);
obj18.setTemplateId("1");
obj18.setVideoUrl("https://cloud.video.taobao.com/vod/l-iiwZUuAPIo0Um-EyEFYjl0cRB3ZajC5CouGjz7Kf8.mp4");
obj15.setTemplateList(list17);
obj15.setPerTmplOutputSize(8L);
list14.setVideoTemplates(obj15);
obj5.setSubAction(1L);
List<LianfanHuiwaTaskVideoSubmitRequest.AigcVideoMaterialDTO> list21 = new ArrayList<LianfanHuiwaTaskVideoSubmitRequest.AigcVideoMaterialDTO>();
LianfanHuiwaTaskVideoSubmitRequest.AigcVideoMaterialDTO obj22 = new LianfanHuiwaTaskVideoSubmitRequest.AigcVideoMaterialDTO();
list21.add(obj22);
obj22.setVideoUrl("https://cloud.video.taobao.com/vod/l-iiwZUuAPIo0Um-EyEFYjl0cRB3ZajC5CouGjz7Kf8.mp4");
list19.setInputVideos(list21);
LianfanHuiwaTaskVideoSubmitRequest.AigcVideoAdvancedConfigDTO obj24 = new LianfanHuiwaTaskVideoSubmitRequest.AigcVideoAdvancedConfigDTO();
obj24.setToneStyleId("general");
obj24.setOpenSubtitle(true);
obj24.setKeepOriginalAudio(false);
list23.setAdvancedConfig(obj24);
LianfanHuiwaTaskVideoSubmitRequest.AigcVideoItemInfoDTO obj26 = new LianfanHuiwaTaskVideoSubmitRequest.AigcVideoItemInfoDTO();
obj26.setItemName("小黑金香水");
obj26.setItemSellingpoint("方方瓶身沉稳大气;英文标签很有质感;玻璃瓶身拿在手里有分量;香水礼盒包装送礼有面子;盒子背面有使用说明;金色瓶盖小细节设计");
list25.setItemInfo(obj26);
obj2.setGenVideoRequests(list4);
obj2.setTaskBizType(16L);
obj2.setSubTaskType(22L);
obj1.setRequest(obj2);
req.setBatchGenVideoTopReq(obj1);
LianfanHuiwaTaskVideoSubmitResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<lianfan_huiwa_task_video_submit_response>
    <succeed>true</succeed>
    <error_codes>
        <code>error</code>
        <message>error</message>
    </error_codes>
    <model>
        <gen_video_submit_result>
            <task_id>12</task_id>
            <pass_through>{}</pass_through>
            <error_msg>error</error_msg>
            <error_code>error</error_code>
        </gen_video_submit_result>
    </model>
</lianfan_huiwa_task_video_submit_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部