You need to enable JavaScript to run this app.
导航

调用方式(V2-公测中)

最近更新时间2023.11.03 10:59:54

首次发布时间2023.03.08 12:18:54

接口简介

基于深度学习算法,支持运用3D变焦技术以人像为聚焦,形成远近景拉伸的效果。

限制条件

名称内容

图片要求

1. 图片格式:JPG、JPEG、PNG、BMP等常见格式,建议使用JPG格式。
2.输入资源分辨率:大于64x64,小于2048x2048
3. 图片文件大小:最大 5 MB。

请求说明

名称内容
接口地址https://visual.volcengineapi.com
请求方式POST
Content-Typeapplication/json

请求参数

(1)header请求参数

以下请求参数列表仅列出了接口请求参数和必要公共参数,完整公共参数列表见 公共参数

名称类型是否必填描述
X-DateString使用UTC时间,精确到秒。请使用格式:YYYYMMDD'T'HHMMSS'Z' ,例如:20201103T104027Z

Authorization

String

HMAC-SHA256:签名方法
-Credential为签名凭证,其中:
-AccessKeyId为访问密钥ID,可在 访问密钥(Access Key) 获取;
-ShortDate为请求的短时间,使用UTC时间,精确到日。请使用格式:YYYYMMDD,例如:20180201
-Region为请求地区,国内一般为为cn-north-1
-Service为请求的服务,一般为cv
-SignedHeaders为参与签名计算的头部信息,content-typehost 为必选头部;
-Signature为签名,可在 签名方法 获取。
注:我们提供了SDK及签名示例供您实现服务快速接入,具体可参考 快速接入
例如:HMAC-SHA256 Credential={AccessKeyId}/{ShortDate}/{Region}/{Service}/request, SignedHeaders={SignedHeaders}, Signature={Signature}

X-Security-TokenString指安全令牌服务(Security Token Service,STS) 颁发的临时安全凭证中的SessionToken,使用长期密钥时无需填写该参数。

(2)Query参数

业务请求参数

参数可选/必选类型说明
Action必选String接口名,取值:Img2Video3D
Version必选String版本号,取值:2022-08-31

(3)Body参数

业务请求参数

参数可选/必选类型说明备注
req_key必选String算法名称,固定取值为img2video3d
binary_data_base64必选(二选一,优先生效)Array of string输入图片的base64数组。此算法需要输入1张图片
image_urls必选(二选一)Array of string图片文件URL
render_spec可选Dict<String, Any>输入图片的渲染参数

RenderSpec渲染参数

参数可选/必选类型说明备注

mode

可选

int

运镜模式选择,默认为 0:
* mode=0 为向前推镜,默认带流动效果
* mode=1 为大角度运镜
* mode=2 为希区柯克运镜
* mode=3 为摇摆运镜
* mode=4 为弹跳运镜

从上到下mode依次为0,1,2,3,4altaltaltaltalt

long_side可选int渲染视频的长边尺寸,默认为 960 (最大1920)值越大耗时越长,二次幂形式增长
frame_num可选int视频帧数(无变速情况下),默认为 90值越大耗时越长,线性增长
fps可选int视频帧率,默认为 30frame_num/fps为视频时长

use_flow

可选

int

是否叠加【图片流动】效果,默认为 -1:
* use_flow=-1 算法根据mode值判断是否流动
* use_flow=0 强制关闭流动效果
* use_flow=1 强制开启流动效果

一般情况开启流动效果会增加约20%~30%的耗时

speed_shift可选array of float视频曲线变速,默认匀速。每相邻两值表示一个控制点的x,y值,x范围[0, 1]表示原视频开始到结尾的进程,y范围[0.1, 10]表示速率,每相邻两个控制点表示一条变速曲线,曲线函数为三角函数例如 speed_shift=[0,1,0.5,4, 0.5,4,1,1] 表示下图曲线alt

输出说明

(1)通用输出参数

请参考通用返回字段及错误码

(2)业务输出参数

data 字段说明

字段类型说明备注
videoString返回生成视频的base64编码字符串

(3)输出示例

{
    {
    "code":10000,
    "data":{
        "algorithm_base_resp":{
            "status_code":0,
            "status_message":"success"
        },
        "binary_data_base64": "/9xxxx"
    },
    "message":"Success",
    "request_id":"20230314141459F8C14402FC09F4781E1F",
    "status":10000,
    "time_elapsed":"3.288347778s"
}

错误码

(1)通用错误码

请参考通用返回字段及错误码

(2)业务错误码

HttpCode错误码错误消息描述
20010000请求成功