大头贴

简介

HI,您好,欢迎使用腾讯AI开放平台大头贴特效API接口服务。

本文档主要针对需要集成HTTP API的技术研发工程师,详细描述大头贴特效能力相关的技术内容。

如果您对文档内容有任何疑问,可以通过以下几种方式联系我们:

官方交流一群:581197347

官方交流二群:705874401

官方交流三群:415349651

联系邮箱:aicamp@tencent.com

接口能力

接口名称 接口描述 API地址
大头贴 给定图片和大头贴编码,对原图进行大头贴特效处理 https://api.ai.qq.com/fcgi-bin/ptu/ptu_facesticker

更多更强大的接口能力正在开发中,并逐步开放,敬请期待!

协议须知

调用方集成大头贴特效API时,请遵循以下规则。

规则 描述
传输方式 HTTPS
请求方法 POST
原图限制 仅支持JPG、PNG类型图片,尺寸长宽不超过1080
效果图说明 JPG类型图片
字符编码 统一采用UTF-8编码
响应格式 统一采用JSON格式
接口鉴权 签名机制,详情请阅接口鉴权

大头贴

1. 接口描述

大头贴接口提供大头贴特效功能,可以帮您快速实现原始图片的大头贴特效处理。

2. 请求参数

参数名称 是否必选 数据类型 数据约束 示例数据 描述
app_id int 正整数 1000001 应用标识(AppId)
time_stamp int 正整数 1493468759 请求时间戳(秒级)
nonce_str string 非空且长度上限32字节 fa577ce340859f9fe 随机字符串
sign string 非空且长度固定32字节 签名信息,详见接口鉴权
sticker int 正整数 1 大头贴编码,定义见下文描述
image string 原始图片的base64编码数据(原图大小上限500KB) ... 待处理图片

3. 响应参数

参数名称 是否必选 数据类型 描述
ret int 返回码; 0表示成功,非0表示出错
msg string 返回信息;ret非0时表示出错时错误原因
data object 返回数据;ret为0时有意义
+ image string 效果图片的base64编码数据

4. 请求限制

单用户单接口的QPS(每秒请求次数)上限如下,如需更多请联系QQ客服反馈。

未认证用户 个人认证用户 企业认证用户
1 2 10

5. 参考示例

假设示例请求数据如下。

参数名称 参数数据 描述
app_id 1000001 仅供参考
image 实时计算base64
sticker 1 仅供参考
time_stamp 实时计算
nonce_str 实时计算
sign 实时计算

假设应用密钥为:a95eceb1ac8c24ee28b70f7dbba912bf,示例图片文件存储路径为:/path/to/image

下面使用PHP实现该HTTP API调用,其中getReqSigndoHttpPost可以从接口鉴权获取。

// 图片base64编码
$path   = '/path/to/image';
$data   = file_get_contents($path);
$base64 = base64_encode($data);

// 设置请求数据
$appkey = 'a95eceb1ac8c24ee28b70f7dbba912bf';
$params = array(
    'app_id'     => '1000001',
    'image'      => $base64,
    'sticker'    => '1',
    'time_stamp' => strval(time()),
    'nonce_str'  => strval(rand()),
    'sign'       => '',
);
$params['sign'] = getReqSign($params, $appkey);

// 执行API调用
$url = 'https://api.ai.qq.com/fcgi-bin/ptu/ptu_facesticker';
$response = doHttpPost($url, $params);
echo $response;

上述echo $response的输出结果即API的响应结果(注意使用UTF-8编码):

{
    "ret": 0,
    "msg": "ok",
    "data": {
        "image": "..."
    }
}

6. 大头贴编码

编码 名称 效果 编码 名称 效果
1 NewDay NewDay        2 欢乐球吃球1 欢乐球吃球1
3 Bonvoyage Bonvoyage     4 Enjoy Enjoy
5 ChickenSpring ChickenSpring 6 ChristmasShow ChristmasShow
7 ChristmasSnow ChristmasSnow 8 CircleCat CircleCat
9 CircleMouse CircleMouse   10 CirclePig CirclePig
11 Comicmn Comicmn       12 CuteBaby CuteBaby
13 Envolope Envolope      14 Fairytale Fairytale
15 GoodNight GoodNight     16 HalloweenNight HalloweenNight
17 LovelyDay LovelyDay     18 Newyear2017 Newyear2017
19 PinkSunny PinkSunny     20 KIRAKIRA KIRAKIRA
21 欢乐球吃球2 欢乐球吃球2   22 SnowWhite SnowWhite
23 SuperStar SuperStar     24 WonderfulWork WonderfulWork
25 Cold Cold          26 狼人杀守卫 狼人杀守卫
27 狼人杀猎人 狼人杀猎人    28 狼人杀预言家 狼人杀预言家
29 狼人杀村民 狼人杀村民    30 狼人杀女巫 狼人杀女巫
31 狼人杀狼人 狼人杀狼人

更多大头贴特效正在开发中,并逐步开放,敬请期待!

AI开放平台公众号
关注公众号

打造升级AI项目
推送全球AI热点