AI人臉屬性編輯

專用API

【更新時間: 2024.03.08】 AI 人臉屬性編輯，主要針對含有人臉的圖像進行風格化處理。它能夠?qū)崿F(xiàn)娃娃臉、變老、變胖等多種有趣效果，適用于特效制作以及互動娛樂等場景，為相關(guān)領(lǐng)域提供了便捷而強大的功能支持，可帶來豐富多樣的體驗。

0元起（支持套餐）去服務商官網(wǎng)采購>

瀏覽次數(shù)

采購人數(shù)

試用次數(shù)

SLA: N/A

響應: N/A

適用于個人&企業(yè)

試用

選擇書簽:

完成

取消

書簽名稱

確定

相似API

人臉屬性-曠視

人臉屬性服務，可對人臉的諸多屬性進行精準分析，涵蓋年齡、性別、頭部朝向、情緒、顏值以及視線等方面的屬性。其能夠提供詳細且準確的人臉屬性信息，以便于在各種場景中實現(xiàn)多樣化的應用與需求。

3D人臉重建-曠視

3D 人臉重建，通過基于 8000 個 3D 人臉關(guān)鍵點，能夠利用單張亦或是多張圖像來精準地重建出 3D 人臉模型。其具備強大的功能，可廣泛應用于人臉識別、虛擬形象等諸多領(lǐng)域，為相關(guān)需求提供可靠的技術(shù)支持。

人臉關(guān)鍵點-曠視

人臉關(guān)鍵點能夠精確檢測人臉五官與輪廓的諸多關(guān)鍵點及其位置。這些關(guān)鍵點涵蓋了人臉輪廓、眼睛、眉毛、嘴唇以及鼻子輪廓等，可助力相關(guān)應用實現(xiàn)對人臉特征的準確分析與處理。

API詳情
接口文檔
定價
常見 FAQ
關(guān)于我們
相關(guān)推薦

產(chǎn)品介紹

什么是AI人臉屬性編輯?

服務詳情

對含有人臉的圖像，進行風格化處理，可返回娃娃臉、變老、變胖等效果。

能力特點

核心優(yōu)勢

應用場景

什么是AI人臉屬性編輯接口？

由服務使用方的應用程序發(fā)起，以Restful風格為主、通過公網(wǎng)HTTP協(xié)議調(diào)用AI人臉屬性編輯，從而實現(xiàn)程序的自動化交互，提高服務效率。

產(chǎn)品價格

需使用請先聯(lián)系商務同學（E-mail：haozhiliu@kuaishou.com）免費獲取1000次額度，有效期3個月。超過免費額度后可聯(lián)系商務進行購買續(xù)費

計費模式一：后付費-按調(diào)用量計費（計費周期：月，月累計調(diào)用量達到對應檔位后享受對應折扣）

價格檔位	調(diào)用量梯度（次）	單價（元/次）
檔位一	【5W<調(diào)用次數(shù)<=10W】	0.1
檔位二	【10W<調(diào)用次數(shù)<=100W】	0.08
檔位三	【100W<調(diào)用次數(shù)<=500W】	0.06
檔位四	【500W<調(diào)用次數(shù)<=1000W】	0.05
檔位五	【調(diào)用次數(shù)>1000W】	0.04

計費模式二：預付費-按購買資源包計費

價格檔位	資源包（調(diào)用次數(shù)）	價格（元）	單價（元/次）
檔位一	10W	8000	0.08
檔位二	100W	60000	0.06
檔位三	500W	250000	0.05
檔位四	1000W	400000	0.04

計費模式三：預付費-按照QPS并發(fā)計費（按照QPS并發(fā)計費，不限制調(diào)用量次數(shù)，確定支持周期后專項資源部署支持，計費周期1月（30天）起售，超出日期可按照單日計費單價計算）

服務項目	價格（元/QPS/日）	價格（元/QPS/月）
人臉融合	100	2000
表情套系	200	4000
人臉屬性編輯	200	4000
人像風格化	200	4000
新技術(shù)美化	200	4000
淺色染發(fā)/頭發(fā)生長	200	4000

產(chǎn)品問答

已經(jīng)獲取到了access_token，為什么在調(diào)用open api時卻報錯返回ACCESS_DENI...

每一個open api都有對應的scope。scope代表在拉起用戶授權(quán)時，需要用戶授予此App什么樣的權(quán)限，不同的scope會在授權(quán)頁給出用戶不同的提示說明。遇到這樣的報錯時，請再次檢查一下在授權(quán)流程的參數(shù)中，是否指定了對應open api所需的scope。

我們想請求用戶授權(quán)內(nèi)容發(fā)布相關(guān)的權(quán)限，在授權(quán)流程中也添加了相應的scope參數(shù)，為什么返回錯誤信息為...

請求用戶某scope的授權(quán)之前首先要保證自己的APP已經(jīng)申請過相應的接口并審核通過。請求用戶授權(quán)的scope超出此APP已經(jīng)申請開通的接口權(quán)限時，就會報這個錯。請先在管理中心->APP詳情頁的最下方申請相應的接口權(quán)限。

關(guān)于我們

北京快手科技有限公司

企業(yè)

北京快手科技有限公司是一家領(lǐng)先的短視頻社交平臺，致力于為用戶提供豐富、多元的內(nèi)容。公司成立于2011年，總部位于中國北京?？焓滞ㄟ^先進的技術(shù)，為用戶打造了一個互動性強、參與度高的社區(qū)環(huán)境。用戶可以在這里分享生活點滴、展示才藝，享受社交樂趣?？焓植粩嗤苿蛹夹g(shù)創(chuàng)新，優(yōu)化用戶體驗，已成為中國乃至全球短視頻行業(yè)的領(lǐng)軍企業(yè)。

聯(lián)系信息

郵箱： ir@kuaishou.com

最可能同場景使用的其他API

人臉關(guān)鍵點-曠視專用API

【更新時間：2024.03.08】人臉關(guān)鍵點能夠精確檢測人臉五官與輪廓的諸多關(guān)鍵點及其位置。這些關(guān)鍵點涵蓋了人臉輪廓、眼睛、眉毛、嘴唇以及鼻子輪廓等，可助力相關(guān)應用實現(xiàn)對人臉特征的準確分析與處理。

開發(fā)者工具 > 人像工具

人臉融合-曠視專用API

【更新時間：2024.03.08】對模板圖和融合圖中的人臉進行融合操作。融合后的圖片中將包含融合圖中的人臉特征，以及模板圖中的其他外貌特征與內(nèi)容。

開發(fā)者工具 > 人像工具

美顏-曠視專用API

【更新時間：2024.03.08】美顏基于高精度的人臉關(guān)鍵點技術(shù)，能夠精準地實現(xiàn)貼合各種臉型的智能美顏處理。它可以對人臉進行細致優(yōu)化，讓肌膚更加光滑細膩，五官更顯精致，從而為用戶帶來自然且極具魅力的美顏效果。

開發(fā)者工具 > 人像工具

試妝-曠視專用API

【更新時間：2024.03.08】試妝支持實時的虛擬試妝以及在圖片上進行上妝操作，能做到精準貼合，呈現(xiàn)出立體飽滿效果，將色彩質(zhì)地完美展現(xiàn)。同時還搭配了實時調(diào)色工具，能夠輕松實現(xiàn)一鍵批量上新，為用戶帶來便捷高效的美妝體驗。

開發(fā)者工具 > 人像工具

模糊圖像背景-Simplified 專用API

【更新時間：2024.03.08】模糊圖像背景-Simplified 這項服務，主要用于對圖像的背景進行模糊處理。它能夠巧妙地將圖像背景變得模糊，進而突出圖像的主體部分，以達到特定的視覺效果或滿足相關(guān)需求，操作簡便且效果顯著。

AI技術(shù) > AI繪畫

變老

變性別

變小孩

變年輕-提交任務

變年輕-取消任務

變美胖-提交任務

變美胖-取消任務

變丑胖-提交任務

變丑胖-取消任務

變老

1.1 簡要描述

變老

1.2 請求URL

/openapi/effects/create/older?app_id=xxx&access_token=xxx

1.3 請求方式

POST

1.4 入?yún)?

參數(shù)名	參數(shù)類型	是否必傳	描述
openId	string	是	openId
input	list	是	輸入素材，圖片/視頻等
input[].name	string	否	素材名稱
input[].dataUrl	string	否	dataUrl和dataBytes二選一
input[].dataBytes	string	否	Base64字符串，
argument	map	否	額外參數(shù)，參見具體方法說明
requestId	string	否	請求id

1.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
data	object
data.image	string	圖片Base64字符串，例如

1.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

1.7 示例

  "result": 0,
  "errorMsg": "",
  "data": {
    "image":"data:image/png;base64,/9j/4AA"
  }
}

變性別

2.1 簡要描述

變性別

2.2 請求URL

/openapi/effects/create/gender?app_id=xxx&access_token=xxx

2.3 請求方式

POST

2.4 入?yún)?

參數(shù)名	參數(shù)類型	是否必傳	描述
openId	string	是	openId
input	list	是	輸入素材，圖片/視頻等
input[].name	string	否	素材名稱
input[].dataUrl	string	否	dataUrl和dataBytes二選一
input[].dataBytes	string	否	Base64字符串，如何從圖片的二進制獲得base64字符串：
argument	map	否	額外參數(shù)，參見具體方法說明
requestId	string	否	請求id

2.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
data	object
data.image	string	圖片Base64字符串，例如

2.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

2.7 示例

  "result": 0,
  "errorMsg": "",
  "data": {
    "image":"data:image/png;base64,/9j/4AA"
  }
}

變小孩

3.1 簡要描述

變小孩

3.2 請求URL

/openapi/effects/create/back2three?app_id=xxx&access_token=xxx

3.3 請求方式

POST

3.4 入?yún)?

參數(shù)名	參數(shù)類型	是否必傳	描述
openId	string	是	openId
input	list	是	輸入素材，圖片/視頻等
input[].name	string	否	素材名稱
input[].dataUrl	string	否	dataUrl和dataBytes二選一
input[].dataBytes	string	否	Base64字符串，如何從圖片的二進制獲得base64字符串：
argument	map	否	額外參數(shù)，參見具體方法說明
requestId	string	否	請求id

3.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
data	object
data.image	string	圖片Base64字符串，例如

3.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

3.7 示例

  "result": 0,
  "errorMsg": "",
  "data": {
    "image":"data:image/png;base64,/9j/4AA"
  }
}

變年輕-提交任務

4.1 簡要描述

變年輕-提交任務

4.2 請求URL

/openapi/queue/effects/submit/young?app_id=xxx&access_token=xxx

4.3 請求方式

POST

4.4 入?yún)?

參數(shù)名	參數(shù)類型	是否必傳	描述
openId	string	是	openId
input	list	是	輸入素材，圖片/視頻等
input[].name	string	否	素材名稱
input[].dataUrl	string	否	dataUrl和dataBytes二選一
input[].dataBytes	string	否	Base64字符串，如何從圖片的二進制獲得base64字符串：org.apache.commons.codec.binary.Base64.encodeBase64String(bytes.toByteArray())
effect	string	是	能力名稱，具體支持列表參見
argument	map	否	額外參數(shù)，參見具體方法說明

4.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
requestId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100
data	object
data.image	string	圖片Base64字符串，例如
data.type	string	image：圖片
data.video	string	視頻Base64字符串

4.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

4.7 示例

{
  "result": 0,
  "errorMsg": "",
  "requestId":"請求id", // 查詢?nèi)蝿账枳侄?  "effect":"",
  "taskInfo":{
    "taskStatus":"", //排隊中、運行中、已完成、已取消、已失敗
    "etaTime":"", // 預計完成時間
    "queueSize":0, // 隊列位置
    "beginTime":"時間戳",
    "endTime":"實際完成時間",
    "taskPercent":"1" // 進度百分比0-100
  },
  "data": {
    "image":"data:image/png;base64,/9j/4AA",
    "video":"",
    "type":"image" // video / image
  }
}

變年輕-查詢?nèi)蝿?

5.1 簡要描述

變年輕-查詢?nèi)蝿?

5.2 請求URL

/openapi/queue/effects/query?app_id=xxx&access_token=xxx

5.3 請求方式

POST

5.4 入?yún)?

參數(shù)名	參數(shù)類型	默認值	是否必傳	描述
openId	string		是	openId
requestId	string		是	提交任務返回的requestId

5.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
requestId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100
data	object
data.image	string	圖片Base64字符串，例如
data.type	string	image：圖片
data.video	string	視頻Base64字符串

5.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

5.7 示例

變年輕-取消任務

6.1 簡要描述

變年輕-取消任務

6.2 請求URL

/openapi/queue/effects/cancel?app_id=xxx&access_token=xxx

6.3 請求方式

POST

6.4 入?yún)?

參數(shù)名	參數(shù)類型	默認值	是否必傳	描述
openId	string		是	openId
requestId	string		是	提交任務返回的requestId

6.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
requestId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100
data	object
data.image	string	圖片Base64字符串，例如
data.type	string	image：圖片
data.video	string	視頻Base64字符串

6.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

6.7 示例

變年輕-查詢?nèi)蝿樟斜?

7.1 簡要描述

變年輕-查詢?nèi)蝿樟斜?

7.2 請求URL

/openapi/queue/effects/list?app_id=xxx&access_token=xxx

7.3 請求方式

POST

7.4 入?yún)?

參數(shù)名	參數(shù)類型	是否必傳	描述
openId	string	是	openId
pageNum	int	否	頁碼，從1開始
pageSize	int	否	一頁數(shù)量，最大值:100
effect	string	否	特效名稱
task_status	string	否	排隊中、已完成、已取消、已失敗

7.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
totalSize	int	總數(shù)量
dataList	list
requesstring,tId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object	任務排隊等信息
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100

7.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

7.7 示例

變美胖-提交任務

8.1 簡要描述

變美胖-提交任務

8.2 請求URL

/openapi/queue/effects/submit/fmfat?app_id=xxx&access_token=xxx

8.3 請求方式

POST

8.4 入?yún)?

參數(shù)名	參數(shù)類型	是否必傳	描述
openId	string	是	openId
input	list	是	輸入素材，圖片/視頻等
input[].name	string	否	素材名稱
input[].dataUrl	string	否	dataUrl和dataBytes二選一
input[].dataBytes	string	否	Base64字符串，如何從圖片的二進制獲得base64字符串：org.apache.commons.codec.binary.Base64.encodeBase64String(bytes.toByteArray())
effect	string	是	能力名稱，具體支持列表參見
argument	map	否	額外參數(shù)，參見具體方法說明

8.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
requestId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100
data	object
data.image	string	圖片Base64字符串，例如
data.type	string	image：圖片
data.video	string	視頻Base64字符串

8.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

8.7 示例

{
  "result": 0,
  "errorMsg": "",
  "requestId":"請求id", // 查詢?nèi)蝿账枳侄?  "effect":"",
  "taskInfo":{
    "taskStatus":"", //排隊中、運行中、已完成、已取消、已失敗
    "etaTime":"", // 預計完成時間
    "queueSize":0, // 隊列位置
    "beginTime":"時間戳",
    "endTime":"實際完成時間",
    "taskPercent":"1" // 進度百分比0-100
  },
  "data": {
    "image":"data:image/png;base64,/9j/4AA",
    "video":"",
    "type":"image" // video / image
  }
}

變美胖-查詢?nèi)蝿?

9.1 簡要描述

變美胖-查詢?nèi)蝿?

9.2 請求URL

/openapi/queue/effects/query?app_id=xxx&access_token=xxx

9.3 請求方式

POST

9.4 入?yún)?

參數(shù)名	參數(shù)類型	默認值	是否必傳	描述
openId	string		是	openId
requestId	string		是	提交任務返回的requestId

9.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
requestId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100
data	object
data.image	string	圖片Base64字符串，例如
data.type	string	image：圖片
data.video	string	視頻Base64字符串

9.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

9.7 示例

變美胖-取消任務

10.1 簡要描述

變美胖-取消任務

10.2 請求URL

/openapi/queue/effects/cancel?app_id=xxx&access_token=xxx

10.3 請求方式

POST

10.4 入?yún)?

參數(shù)名	參數(shù)類型	默認值	是否必傳	描述
openId	string		是	openId
requestId	string		是	提交任務返回的requestId

10.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
requestId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100
data	object
data.image	string	圖片Base64字符串，例如
data.type	string	image：圖片
data.video	string	視頻Base64字符串

10.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

10.7 示例

變美胖-查詢?nèi)蝿樟斜?

11.1 簡要描述

變美胖-查詢?nèi)蝿樟斜?

11.2 請求URL

/openapi/queue/effects/list?app_id=xxx&access_token=xxx

11.3 請求方式

POST

11.4 入?yún)?

參數(shù)名	參數(shù)類型	是否必傳	描述
openId	string	是	openId
pageNum	int	否	頁碼，從1開始
pageSize	int	否	一頁數(shù)量，最大值:100
effect	string	否	特效名稱
task_status	string	否	排隊中、已完成、已取消、已失敗

11.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
totalSize	int	總數(shù)量
dataList	list
requesstring,tId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object	任務排隊等信息
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100

11.6 錯誤碼

錯誤碼	錯誤信息	描述
SUCCESS0	成功
UNRECOGNIZED-1	未識別
NO_RESULTS1	沒有結(jié)果
NO_FACE2	沒有人臉
NO_HUMAN3	沒有人
SIZE_MISMATCH4	輸入圖片大小/通道不匹配
RUN_ERROR5	運行錯誤
PARAM_ERROR6	無效輸入?yún)?shù)
NO_BANDWIDTH12	無帶寬
OUT_OF_QUOTA20	特效被限流
ERR_CV201	cv異常（輸入圖片錯誤）
ERR_STD202	std異常
ERR_OTHER203	其他錯誤

11.7 示例

{
  "result": 0,
  "errorMsg": "",
  "dataList":[
    {
      "requestId":"請求id",
      "effect":"",
      "taskInfo":{
        "taskStatus":"",
        "etaTime":"", // 預計完成時間
        "queueSize":0, // 隊列位置
        "beginTime":"時間戳",
        "endTime":"實際完成時間",
        "taskPercent":"1" // 進度百分比0-100
      }
    }
  ]
}

變丑胖-提交任務

12.1 簡要描述

變丑胖-提交任務

12.2 請求URL

/queue/effects/submit/ugly?app_id=xxx&access_token=xxx

12.3 請求方式

POST

12.4 入?yún)?

參數(shù)名	參數(shù)類型	是否必傳	描述
openId	string	是	openId
input	list	是	輸入素材，圖片/視頻等
input[].name	string	否	素材名稱
input[].dataUrl	string	否	dataUrl和dataBytes二選一
input[].dataBytes	string	否	Base64字符串，如何從圖片的二進制獲得base64字符串：org.apache.commons.codec.binary.Base64.encodeBase64String(bytes.toByteArray())
effect	string	是	能力名稱，具體支持列表參見
argument	map	否	額外參數(shù)，參見具體方法說明

12.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
requestId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100
data	object
data.image	string	圖片Base64字符串，例如
data.type	string	image：圖片
data.video	string	視頻Base64字符串

12.6 錯誤碼

錯誤碼	錯誤信息	描述

12.7 示例

{
  "result": 0,
  "errorMsg": "",
  "requestId":"請求id", // 查詢?nèi)蝿账枳侄?  "effect":"",
  "taskInfo":{
    "taskStatus":"", //排隊中、運行中、已完成、已取消、已失敗
    "etaTime":"", // 預計完成時間
    "queueSize":0, // 隊列位置
    "beginTime":"時間戳",
    "endTime":"實際完成時間",
    "taskPercent":"1" // 進度百分比0-100
  },
  "data": {
    "image":"data:image/png;base64,/9j/4AA",
    "video":"",
    "type":"image" // video / image
  }
}

變丑胖-查詢?nèi)蝿?

13.1 簡要描述

變丑胖-查詢?nèi)蝿?

13.2 請求URL

/openapi/queue/effects/query?app_id=xxx&access_token=xxx

13.3 請求方式

POST

13.4 入?yún)?

參數(shù)名	參數(shù)類型	默認值	是否必傳	描述
openId	string		是	openId
requestId	string		是	提交任務返回的requestId

13.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
requestId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100
data	object
data.image	string	圖片Base64字符串，例如
data.type	string	image：圖片
data.video	string	視頻Base64字符串

13.6 錯誤碼

錯誤碼	錯誤信息	描述

13.7 示例

變丑胖-取消任務

14.1 簡要描述

變丑胖-取消任務

14.2 請求URL

/openapi/queue/effects/cancel?app_id=xxx&access_token=xxx

14.3 請求方式

POST

14.4 入?yún)?

參數(shù)名	參數(shù)類型	默認值	是否必傳	描述
openId	string		是	openId
requestId	string		是	提交任務返回的requestId

14.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
requestId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100
data	object
data.image	string	圖片Base64字符串，例如
data.type	string	image：圖片
data.video	string	視頻Base64字符串

14.6 錯誤碼

錯誤碼	錯誤信息	描述

14.7 示例

變丑胖-查詢?nèi)蝿樟斜?

15.1 簡要描述

變丑胖-查詢?nèi)蝿樟斜?

15.2 請求URL

/openapi/queue/effects/list?app_id=xxx&access_token=xxx

15.3 請求方式

POST

15.4 入?yún)?

參數(shù)名	參數(shù)類型	是否必傳	描述
openId	string	是	openId
pageNum	int	否	頁碼，從1開始
pageSize	int	否	一頁數(shù)量，最大值:100
effect	string	否	特效名稱
task_status	string	否	排隊中、已完成、已取消、已失敗

15.5 出參

參數(shù)名	參數(shù)類型	描述
result	int	錯誤碼，0為成功，其它失敗，參見返回錯誤碼說明
errorMsg	string	錯誤信息
totalSize	int	總數(shù)量
dataList	list
requesstring,tId	string	請求id，可用于查詢?nèi)蝿?/td>
taskInfo	object	任務排隊等信息
taskStatus	string	排隊中、運行中、已完成、已取消、已失敗
etaTime	long	預計完成時間戳
queueSize	int	隊列位置
beginTime	long	開始時間戳
endTime	long	完成時間戳
taskPercent	string	進度百分比0-100

15.6 錯誤碼

錯誤碼	錯誤信息	描述

15.7 示例

{
  "result": 0,
  "errorMsg": "",
  "dataList":[
    {
      "requestId":"請求id",
      "effect":"",
      "taskInfo":{
        "taskStatus":"",
        "etaTime":"", // 預計完成時間
        "queueSize":0, // 隊列位置
        "beginTime":"時間戳",
        "endTime":"實際完成時間",
        "taskPercent":"1" // 進度百分比0-100
      }
    }
  ]
}

產(chǎn)品價格

需使用請先聯(lián)系商務同學（E-mail：haozhiliu@kuaishou.com）免費獲取1000次額度，有效期3個月。超過免費額度后可聯(lián)系商務進行購買續(xù)費

計費模式一：后付費-按調(diào)用量計費（計費周期：月，月累計調(diào)用量達到對應檔位后享受對應折扣）

價格檔位	調(diào)用量梯度（次）	單價（元/次）
檔位一	【5W<調(diào)用次數(shù)<=10W】	0.1
檔位二	【10W<調(diào)用次數(shù)<=100W】	0.08
檔位三	【100W<調(diào)用次數(shù)<=500W】	0.06
檔位四	【500W<調(diào)用次數(shù)<=1000W】	0.05
檔位五	【調(diào)用次數(shù)>1000W】	0.04

計費模式二：預付費-按購買資源包計費

價格檔位	資源包（調(diào)用次數(shù)）	價格（元）	單價（元/次）
檔位一	10W	8000	0.08
檔位二	100W	60000	0.06
檔位三	500W	250000	0.05
檔位四	1000W	400000	0.04

服務項目	價格（元/QPS/日）	價格（元/QPS/月）
人臉融合	100	2000
表情套系	200	4000
人臉屬性編輯	200	4000
人像風格化	200	4000
新技術(shù)美化	200	4000
淺色染發(fā)/頭發(fā)生長	200	4000