人物寫真生成API詳情
人物寫真生成API調(diào)用需“申請體驗”并通過后才可使用，否則API調(diào)用將返回錯誤狀態(tài)碼。
人物寫真生成
支持的領(lǐng)域 / 任務(wù)：aigc /facechain2.0人物寫真生成
人物寫真2.0支持人物形象訓(xùn)練lora模式和人物形象免訓(xùn)練trainfree模式。
1）人物形象訓(xùn)練lora模式：基于人物形象訓(xùn)練模型已經(jīng)得到的人物形象lora，可以繼續(xù)通過人物生成寫真模型完成該形象的高保真寫真生成，支持多種預(yù)設(shè)風(fēng)格，包括證件照、商務(wù)寫真、復(fù)古風(fēng)、夏日運動等風(fēng)格，同時支持客戶自定義風(fēng)格模板上傳方式生成自定義人物寫真照。
2）人物形象免訓(xùn)練trainfree模式【推薦】：同時上傳一組包含用戶正臉單人照（至少一張）和客戶自定義風(fēng)格模板，通過人物生成寫真模型直接一鍵免訓(xùn)練極速生成人物寫真照，僅支持客戶自定義風(fēng)格模板上傳方式免訓(xùn)練trainfree生成寫真。
人物形象訓(xùn)練lora方式說明：
人物形象訓(xùn)練lora方式流程圖：
人物形象訓(xùn)練lora方式上，人物寫真基于擴(kuò)散模型的圖像生成能力，結(jié)合LoRA訓(xùn)練實現(xiàn)人像和風(fēng)格融合，并疊加一系列后處理能力，實現(xiàn)兼具相似度、真實感、美觀度的寫真生成能力，人物寫真可以實現(xiàn)高度個性化、高保真、高品質(zhì)水位。
關(guān)于該接口功能的示例圖如下：
輸入圖像
生成結(jié)果（商務(wù)寫真）
預(yù)設(shè)風(fēng)格模板
客戶自定義模板：
輸入圖像
自定義模板
生成結(jié)果
人物形象免訓(xùn)練trainfree方式說明：
人物形象免訓(xùn)練trainfree方式流程圖：
人物形象免訓(xùn)練trainfree方式上，基于內(nèi)置強大的人物寫真照預(yù)訓(xùn)練大模型技術(shù)，實現(xiàn)人物寫真擴(kuò)散模型的圖像極速生成能力，一鍵免訓(xùn)練極速生成人物寫真照，并疊加一系列后處理能力，實現(xiàn)兼具相似度、真實感、美觀度的寫真生成能力，人物寫真可以實現(xiàn)高度個性化、高品質(zhì)、高豐富度、極速出圖能力。
關(guān)于該接口功能的示例圖如下：
輸入圖像
自定義模板
生成結(jié)果
應(yīng)用場景
職場證件照制作：一鍵訓(xùn)練證件照人物形象風(fēng)格，專為用戶打造符合各類企業(yè)招聘、求職簡歷等場景的高質(zhì)量、規(guī)范化的職場證件照，輕松完成高質(zhì)量的職場證件照制作，大大節(jié)省時間、精力和成本。
AI寫真照相館應(yīng)用：通過構(gòu)建智能寫真照相館應(yīng)用程序，為用戶提供便捷、高效且高度個性化的在線攝影體驗，讓用戶無論何時何地都能拍出媲美專業(yè)攝影師水準(zhǔn)的高品質(zhì)多樣化風(fēng)格個人寫真照片。
環(huán)球旅拍寫真生成：線上數(shù)字化創(chuàng)新旅拍寫真生成應(yīng)用，為用戶提供仿佛親身游歷世界各地拍攝專業(yè)級旅行寫真的體驗。用戶無需實際出行，即可在家中或任何地方輕松獲得全球各地風(fēng)景、著名景點下的精美個人寫真照片。
商業(yè)人物寫真創(chuàng)作：一鍵批量生成商業(yè)人物寫真，對于商業(yè)人物、模特、網(wǎng)紅或企業(yè)高管群體高質(zhì)量的人物寫真批量生成，可用于社交媒體展示、宣傳資料、雜志封面等商業(yè)推廣活動。
特色優(yōu)勢
高保真畫質(zhì)寫真創(chuàng)作：人物寫真融合后的人臉無違和感，寫真生成效果自然，實現(xiàn)融合后的人臉面目表情、細(xì)節(jié)特征、膚色高度一致性，同時確保成像清晰度高、色彩還原準(zhǔn)確，輸出的人物寫真照畫質(zhì)上乘。
個性化人物風(fēng)格定制：人物寫真拍攝可以高度個性化定制，支持場景選擇、拍攝風(fēng)格等不同模板風(fēng)格。
人物形象生成設(shè)計：與傳統(tǒng)攝影相比，AIGC技術(shù)無需實際拍攝過程，大大節(jié)省了時間成本和人力成本。它能夠在短時間內(nèi)生成大量不同風(fēng)格的人物肖像，滿足C端客戶對多元化、快速化的需求響應(yīng)。
人物寫真訓(xùn)練人臉質(zhì)量評估：判斷真實上傳人臉圖片是否符合人物寫真生成微調(diào)所需的標(biāo)準(zhǔn)，人臉數(shù)量、大小、角度、光照、清晰度等多維度質(zhì)量評估檢測。
穩(wěn)定、易用平臺服務(wù)：提供在高并發(fā)、大流量下的穩(wěn)定寫真圖片生成響應(yīng)和99.99%的可靠性保障，可直接調(diào)用的簡單訓(xùn)練和推理API 接口，服務(wù)簡單易用，易被集成，兼容性強。
模型概覽
模型名 | 模型簡介 |
facechain-generation | 人物寫真2.0支持人物形象訓(xùn)練lora模式和人物形象免訓(xùn)練trainfree模式。 支持多種預(yù)設(shè)風(fēng)格，包括證件照、商務(wù)寫真、復(fù)古風(fēng)、夏日運動等風(fēng)格，同時支持客戶自定義風(fēng)格模板上傳方式生成自定義人物寫真照。 |
輸入限制
人物單人照輸入限制：
圖像格式：JPEG、JPG、PNG。
圖像大?。翰怀^3MB。
圖像分辨率：大于256×256像素，小于2048x2048像素，人臉占比不低于128×128像素。
URL地址中不能包含中文字符。
包含清晰正臉單人人物照，人臉角度不超過15度。
輸入人物圖像至少1張，最多5張，需要事先通過人物圖像檢測API（facechain-facedetect）判斷符合要求。
客戶自定義模板輸入限制：
圖像格式：JPEG、JPG、PNG。
圖像大?。翰怀^5MB。
圖像分辨率：大于512*512像素，小于1680*1260像素。
URL地址中不能包含中文字符。
單人的，清晰且高質(zhì)量的風(fēng)格模板圖，人臉無遮擋和模糊。
HTTP調(diào)用接口
功能描述
本模型需要相對較長的算法調(diào)用時間，所以在接口層面采用了異步調(diào)用的方式進(jìn)行任務(wù)提交，在通過任務(wù)接口提交作業(yè)之后，系統(tǒng)會返回對應(yīng)的作業(yè)ID，隨后可以通過對應(yīng)的異步作業(yè)查詢接口獲取任務(wù)的狀態(tài)并且在作業(yè)到達(dá)最終完成態(tài)后取回對應(yīng)的作業(yè)結(jié)果。
前提條件
已開通服務(wù)并獲得API-KEY：API-KEY的獲取與配置。
已經(jīng)通過人物形象訓(xùn)練API，完成定制形象的模型訓(xùn)練，并獲取其相應(yīng)的resource_id。詳情參考人物形象訓(xùn)練API詳情。
接口限制：對單賬戶（含主賬號與RAM子賬號）任務(wù)下發(fā)接口限制QPS為2，并發(fā)任務(wù)數(shù)量限制為1。
作業(yè)提交接口調(diào)用
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/album/gen_potrait
入?yún)⒚枋?/b>
傳參方式 | 字段 | 類型 | 必選 | 描述 | 示例值 |
Header | Content-Type | String | 是 | 請求類型：application/json | application/json |
Authorization | String | 是 | API-Key，例如：Bearer d1**2a | Bearer d1**2a | |
X-DashScope-Async | String | 是 | 使用 enable，表明使用異步方式提交作業(yè)。 | enable | |
Body | model | String | 是 | 指明需要調(diào)用的模型，此處用facechain-generation | facechain-generation |
resources[list] | Array | 否 | 指明之前通過模型定制得到的 lora 層對應(yīng)的數(shù)據(jù)。當(dāng)進(jìn)行非免訓(xùn)練生成時此參數(shù)為必選參數(shù)。 當(dāng)進(jìn)行免訓(xùn)練生成時，不需要填寫此參數(shù)，且此參數(shù)的輸入會被忽略。 | "resources": [ { "resource_id": "realistic_v1_12345", "resource_type": "facelora" } ] | |
resources[0].resource_type | String | 否 | 模型定制的相關(guān)數(shù)據(jù)類型，此處使用 facelora。當(dāng)進(jìn)行非免訓(xùn)練生成時為必選參數(shù)。 當(dāng)進(jìn)行免訓(xùn)練生成時，不需要填寫此參數(shù)，且此參數(shù)的輸入會被忽略。 | ||
resources[0].resource_id | String | 否 | 模型定制得到的 lora 層的數(shù)據(jù) id，從模型定制的成功任務(wù)的 finetuned_output 處獲?。槐热鏵acechain-png-ft-202308291948-edc2。當(dāng)進(jìn)行非免訓(xùn)練生成時為必選參數(shù)。 當(dāng)進(jìn)行免訓(xùn)練生成時，不需要填寫此參數(shù)，且此參數(shù)的輸入會被忽略。 | ||
parameters.style | String | 否 | 選擇輸出圖像的預(yù)設(shè)風(fēng)格或者選擇自定義模板模式以及自定義模板免訓(xùn)練模式 預(yù)設(shè)風(fēng)格： 目前支持以下預(yù)設(shè)風(fēng)格： f_idcard_male（證件照男） f_business_male（商務(wù)寫真男） f_idcard_female（證件照女） f_business_female（商務(wù)寫真女） m_springflower_female（春日花園） f_summersport_female（夏日運動） f_autumnleaf_female（秋日印象） m_winterchinese_female（冬日國風(fēng)） f_hongkongvintage_female（港風(fēng)復(fù)古） f_lightportray_female（輕寫真） 自定義模板寫真生成： portrait_url_template 自定義模板免訓(xùn)練寫真生成： train_free_portrait_url_template | "style": "f_business_female" | |
parameters.size | String | 否 | 生成圖像的分辨率，目前支持 '768*1024' 自定義模板模式以及自定義模板免訓(xùn)練模式時，不需要該參數(shù)。 | "parameters": { "size": "768*1024", "n": 4 } | |
parameters.n | Integer | 否 | 圖片生成的數(shù)量，目前支持 1~4 張，默認(rèn)值 4。 | ||
input.template_url | String | 否 | 當(dāng)parameters.stytle為"portrait_url_template"和"train_free_portrait_url_template"時，需要由用戶上傳自定義模板進(jìn)行寫真生成。此時該參數(shù)為必選參數(shù)，傳入用戶自定義模板的url鏈接。 | template_url: "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFace/CompareFace-left3.png" | |
input.user_urls | Array | 否 | 當(dāng)parameters.stytle為"train_free_portrait_url_template"時，表示進(jìn)行用戶自定義模板的免訓(xùn)練寫真生成，此時該參數(shù)為必選參數(shù)，傳入一組包含用戶正臉單人照的url鏈接。至少1張最多5張，且是通過人物圖像檢測API（facechain-facedetect）驗證通過的人物圖像。 | user_urls:[ "http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/CompareFace/CompareFace-right1.png"] |
出參描述
字段 | 類型 | 描述 | 示例值 |
output.task_id | String | 提交異步任務(wù)的作業(yè) id，實際作業(yè)結(jié)果需要通過異步任務(wù)查詢接口獲取。 | xxxxxxxxx |
output.task_status | String | 提交異步任務(wù)后的 作業(yè)狀態(tài)。 | “PENDING” |
request_id | String | 本次請求的系統(tǒng)唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
請求示例
以下示例展示通過CURL命令來調(diào)用本模型的腳本
需要使用您的API-KEY替換示例中的 your-dashscope-api-key ，代碼才能正常運行。
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/album/gen_potrait' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer <your-dashscope-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"model": "facechain-generation",
"parameters": {
"style": "f_idcard_female",
"size": "512*512",
"n":4
},
"resources": [
{
"resource_id": "women_model",
"resource_type": "facelora"
}
]
}'以下示例展示通過CURL命令來調(diào)用本模型進(jìn)行用戶自定義模板寫真生成的腳本
需要使用您的API-KEY替換示例中的 your-dashscope-api-key ，用實際用戶指定模板圖片對應(yīng)的url鏈接地址代替template_pic_url，代碼才能正常運行。
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/album/gen_potrait' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer <your-dashscope-api-key>' \
--header 'Content-Type: application/json' \
--data '{
"model": "facechain-generation",
"parameters": {
"style": "portrait_url_template",
"n":1
},
"input":
{
"template_url": "<template_pic_url>"
},
"resources": [
{
"resource_id": "women_model",
"resource_type": "facelora"
}
]
}'以下示例展示通過CURL命令來調(diào)用本模型進(jìn)行用戶自定義模板免訓(xùn)練寫真生成的腳本
需要使用您的API-KEY替換示例中的 your-dashscope-api-key ，用實際用戶指定模板圖片對應(yīng)的url鏈接地址代替template_pic_url，用包含用戶正面人臉單人圖片對應(yīng)的url鏈接地址代替user_pic_url，代碼才能正常運行。
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/album/gen_potrait' \
--header 'Authorization: Bearer <your-dashscope-api-key>' \
--header 'X-DashScope-Async: enable' \
--header 'Content-Type: application/json' \
--data '{
"model": "facechain-generation",
"parameters":
{
"style": "train_free_portrait_url_template",
"n": 1
},
"input":
{
"template_url": "<template_pic_url>",
"user_urls": ["<user_pic_url>"]
}
}'響應(yīng)示例
{
"output": {
"task_id": "xxxxxxxx",
"task_status": "PENDING"
}
"request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}異常響應(yīng)示例
在提交作業(yè)請求出錯的情況下，輸出的結(jié)果中會通過 code 和 message 指明出錯原因。
{
"code":"InvalidApiKey",
"message":"Invalid API-key provided.",
"request_id":"fb53c4ec-1c12-4fc4-a580-cdb7c3261fc1"
}作業(yè)任務(wù)狀態(tài)查詢和結(jié)果獲取接口
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
入?yún)⒚枋?/b>
傳參方式 | 字段 | 類型 | 必選 | 描述 | 示例值 |
Url Path | task_id | String | 是 | 需要查詢作業(yè)的 task_id | 13b1848b-5493-4c0e-8c44-68d038b492af |
Header | Authorization | String | 是 | API-Key，例如：Bearer d1**2a | Bearer d1**2a |
出參描述
字段 | 類型 | 描述 | 示例值 |
output.task_id | String | 本次請求的異步任務(wù)的作業(yè) id，實際作業(yè)結(jié)果需要通過異步任務(wù)查詢接口獲取。 | 13b1848b-5493-4c0e-8c44-68d038b492af |
output.task_status | String | 被查詢作業(yè)的作業(yè)狀態(tài) | 任務(wù)狀態(tài)： PENDING 排隊中 RUNNING 處理中 SUCCEEDED 成功 FAILED 失敗 UNKNOWN 作業(yè)不存在或狀態(tài)未知 |
output.results | Array | 如果作業(yè)成功，包含模型生成的結(jié)果圖像的 URL，可以在 24 小時之內(nèi)隨時下載。 | "results":[{'url': "http://oss.aliyuncs.com/xxx/abc.jpg"}] |
usage.image_count | Int | 本次請求生成圖像計量 | "image_count": 1 |
request_id | String | 本次請求的系統(tǒng)唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
請求示例
以下示例展示通過CURL命令來調(diào)用本模型的腳本
需要使用您的API-KEY替換示例中的 your-dashscope-api-key ，代碼才能正常運行。
curl -X GET \
--header 'Authorization: Bearer <your-dashscope-api-key>' \
https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-af6e-a0c6a421c010響應(yīng)示例（作業(yè)執(zhí)行中）
作業(yè)提交后將處于排隊狀態(tài)，在得到調(diào)度之后將轉(zhuǎn)為運行狀態(tài)，此時作業(yè)的狀態(tài)為RUNNING，task_metrics將給出具體batch狀態(tài)；
{
"request_id":"e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
"output":{
"task_id":"86ecf553-d340-4e21-af6e-a0c6a421c010",
"task_status":"RUNNING",
"task_metrics":{
"TOTAL":1,
"SUCCEEDED":1,
"FAILED":0
}
}
}響應(yīng)示例（作業(yè)成功執(zhí)行完畢）
如果作業(yè)執(zhí)行完成并成功之后，再次查詢作業(yè)狀態(tài)，接口將在告知作業(yè)狀態(tài)的同時，一并將作業(yè)的結(jié)果返回。對于本模型，作業(yè)在結(jié)束之后的狀態(tài)會持續(xù)保留24小時以備客戶隨時查詢，24小時之后，作業(yè)將從系統(tǒng)中清除，相關(guān)的結(jié)果也將一并清除；對應(yīng)的，作業(yè)生成的結(jié)果為圖像的URL地址，出于安全考慮，該URL的下載有效期也是24小時，需要用戶在獲取作業(yè)結(jié)果后根據(jù)需要及時使用或者轉(zhuǎn)存。
{
"request_id": "<your request id>",
"output": {
"task_id": "<your task id>",
"task_status": "SUCCEEDED",
"submit_time": "xxx",
"scheduled_time": "xxx",
"end_time": "xxx",
"style_index": 0,
"runtime": "xxx",
"region": "cn-beijing",
"results": [{
"url": "http://oss.aliyuncs.com/xxx/abc.jpg"
}]
},
"usage": {
"image_count": 1
}
}響應(yīng)示例（作業(yè)失敗）
如果因為某種原因作業(yè)失敗，則作業(yè)狀態(tài)會設(shè)置為FAILED，并且通過code和message字段指明錯誤原因。
{
"request_id": "<your request id>",
"output": {
"task_id": "<your task id>",
"task_status": "FAILED",
"submit_time": "xxx",
"scheduled_time": "xxx",
"end_time": "xxx",
"code": "InvalidImageResolution",
"message": "The input image resolution is too large or small"
},
"usage": {
"image_num": 0
}
}狀態(tài)碼說明
DashScope通用狀態(tài)碼請查閱：返回狀態(tài)碼說明
同時本模型還有如下特定錯誤碼：
http 返回碼* | 錯誤碼（code） | 錯誤信息（message） | 含義說明 |
400 | InvalidParameter | The request is missing required parameters or the parameters are out of the specified range, please check the parameters that you send | 缺少必要的接口調(diào)用參數(shù)或參數(shù)越界 |
400 | InvalidURL | The request URL is invalid, make sure the url is correct and is an image | 輸入url錯誤，請確保url鏈接的正確性 |
400 | InvalidImageResolution | The input image resolution is too large or small | 輸入圖像分辨率過大或過小 |
500 | InternalError:Algo | An internal error occurs during computation, please try this model later | 算法內(nèi)部錯誤，請稍后重試、 |