人像風(fēng)格重繪API詳情
人像風(fēng)格重繪
支持的領(lǐng)域 / 任務(wù)：aigc /人像風(fēng)格化
通義萬相-人像風(fēng)格重繪可以將輸入的人物圖像進(jìn)行多種風(fēng)格化的重繪生成，使新生成的圖像在兼顧原始人物相貌的同時，帶來不同風(fēng)格的繪畫效果。當(dāng)前支持預(yù)置重繪風(fēng)格和客戶上傳風(fēng)格參考圖，預(yù)置重繪風(fēng)格有復(fù)古漫畫、3D童話、二次元、小清新、未來科技、國畫古風(fēng)、將軍百戰(zhàn)等。
人像風(fēng)格效果示意：
預(yù)置重繪風(fēng)格：僅需上傳一張?jiān)瓐D，選擇預(yù)置風(fēng)格序號，即可生成不同風(fēng)格的精美人像。
上傳風(fēng)格參考圖：上傳風(fēng)格圖像進(jìn)行參考生成，上傳一張?jiān)瓐D和一張風(fēng)格參考圖，即可生成參考指定圖片風(fēng)格的精美人像。
應(yīng)用場景
創(chuàng)意廣告與市場營銷：企業(yè)可利用人像風(fēng)格重繪創(chuàng)造與眾不同的廣告素材，如將代言人形象轉(zhuǎn)化為未來科技風(fēng)格，用于宣傳高科技產(chǎn)品，既保留了代言人的識別度，又貼合產(chǎn)品定位，吸引目標(biāo)消費(fèi)群體。
個性化人物形象定制：電商平臺可提供人物形象個性化的商品定制服務(wù)，如將客戶提供的人物照片轉(zhuǎn)換為國畫古風(fēng)或二次元風(fēng)格，應(yīng)用于手機(jī)殼、T恤、壁畫等商品上，滿足消費(fèi)者對獨(dú)特和定制化商品的需求。
數(shù)字藝術(shù)創(chuàng)作與展覽：藝術(shù)家和設(shè)計(jì)師可以利用人像風(fēng)格重繪技術(shù)創(chuàng)作具有特定主題或風(fēng)格的藝術(shù)作品，如結(jié)合小清新或3D童話風(fēng)格創(chuàng)作系列人像畫作，用于線上或線下的藝術(shù)展覽，拓寬藝術(shù)表達(dá)的邊界。
影視娛樂與游戲角色設(shè)計(jì)：在電影制作、動畫片或游戲開發(fā)中，通過對真實(shí)演員或概念草圖進(jìn)行風(fēng)格重繪，可以高效地探索和確定角色設(shè)計(jì)方向，將演員照片轉(zhuǎn)為符合游戲世界觀的二次元或復(fù)古風(fēng)格，加速角色視覺設(shè)計(jì)進(jìn)程，提升項(xiàng)目整體的視覺吸引力。
特色優(yōu)勢
高度逼真與風(fēng)格化：先進(jìn)的人像重繪算法能夠精確捕捉人像的特征細(xì)節(jié)，同時賦予其特定的藝術(shù)風(fēng)格，無論是復(fù)古漫畫、小清新、二次元還是其他風(fēng)格，都能在保持人像細(xì)節(jié)的同時賦予圖像不同的藝術(shù)風(fēng)格。這種能力讓每幅重繪作品都成為獨(dú)一無二的藝術(shù)品。
穩(wěn)定、易用平臺服務(wù)：提供在高并發(fā)、大流量下的穩(wěn)定寫真圖片生成響應(yīng)和99.99%的可靠性保障，可直接調(diào)用的簡單訓(xùn)練和推理API 接口，服務(wù)簡單易用，易被集成，兼容性強(qiáng)。
模型概覽
模型名 | 模型簡介 |
wanx-style-repaint-v1 | 通義萬相-人像風(fēng)格重繪可以將輸入的人物圖像進(jìn)行多種風(fēng)格化的重繪生成，使新生成的圖像在兼顧原始人物相貌的同時，帶來不同風(fēng)格的繪畫效果。 |
輸入限制
人物圖像輸入限制：
圖片分辨率：可支持輸入分辨率范圍：不小于256*256，不超過5760*3240, 長寬比不超過1.5:1，若超出1.5:1將自適應(yīng)裁剪到1.5:1。
圖片質(zhì)量：確保生成質(zhì)量，請上傳臉部清晰照片，人臉比例不宜過小，并避免夸張姿勢和表情。
圖片格式：JPEG，PNG，JPG，BMP，WEBP。
圖片大小：不超過10M。
URL地址中不能包含中文字符。
風(fēng)格參考圖輸入限制：
圖片分辨率：可支持輸入分辨率范圍：不小于256*256，不超過5760*3240, 長寬比不超過2:1。
圖片格式：JPEG，PNG，JPG，BMP，WEBP。
圖片大小：不超過10M。
URL地址中不能包含中文字符。
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的獲取與配置。
接口限制：對單賬戶（含主賬號與RAM子賬號）任務(wù)下發(fā)接口限制QPS為2，并發(fā)任務(wù)數(shù)量限制為1。
作業(yè)提交接口調(diào)用
POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation
入?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)用的模型，固定值 | wanx-style-repaint-v1 |
input.image_url | String | 是 | 輸入的圖像 URL，
| http://abc.com/a.jpg | |
input.style_index | Integer | 是 | 想要生成的風(fēng)格化類型索引： -1 參考上傳圖像風(fēng)格 0 復(fù)古漫畫 1 3D童話 2 二次元 3 小清新 4 未來科技 5 國畫古風(fēng) 6 將軍百戰(zhàn) 7 炫彩卡通 8 清雅國風(fēng) 9 喜迎新年 | "style_index": 3 | |
input.style_ref_url | String | 當(dāng)input.style_index=-1時，必須傳入； 其他風(fēng)格，無需傳入 | 輸入的圖像 URL，
| http://abc.com/a.jpg |
出參描述
字段 | 類型 | 描述 | 示例值 |
output.task_id | String | 本次請求的異步任務(wù)的作業(yè) id，實(shí)際作業(yè)結(jié)果需要通過異步任務(wù)查詢接口獲取。 | 13b1848b-5493-4c0e-8c44-68d038b492af |
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 ，代碼才能正常運(yùn)行。
1.使用預(yù)置風(fēng)格模板：
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer <YOUR-DASHSCOPE-API-KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx-style-repaint-v1",
"input": {
"image_url": "https://public-vigen-video.oss-cn-shanghai.aliyuncs.com/public/dashscope/test.png",
"style_index": 3
}
}'2.上傳參考風(fēng)格圖像：
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer <YOUR-DASHSCOPE-API-KEY>' \
--header 'Content-Type: application/json' \
--data '{
"model": "wanx-style-repaint-v1",
"input": {
"image_url": "https://public-vigen-video.oss-cn-shanghai.aliyuncs.com/public/dashscope/test.png",
"style_index": -1,
"style_ref_url": "https://vigen-video.oss-cn-shanghai.aliyuncs.com/VideoGeneration/Data/cosplay%E8%A7%92%E8%89%B2%E5%BA%93/%E6%96%B0%E7%89%88%E9%9D%A2%E5%BD%A2%E8%B1%A1%E5%BA%93/ACG%E9%A3%8E%E6%A0%BC%EF%BC%88%E7%94%B7%EF%BC%89/65ba3ee96b1b868dfad0cf96c52c86112e035bb893329b8dda2a90b8a38485e0.png"
}
}'響應(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，實(shí)際作業(yè)結(jié)果需要通過異步任務(wù)查詢接口獲取。 | 13b1848b-5493-4c0e-8c44-68d038b492af |
output.task_status | String | 被查詢作業(yè)的作業(yè)狀態(tài) | 任務(wù)狀態(tài)： PENDING 排隊(duì)中 RUNNING 處理中 SUCCEEDED 成功 FAILED 失敗 UNKNOWN 作業(yè)不存在或狀態(tài)未知 |
output.result_url | String |
| "result_url": "http://oss.aliyuncs.com/xxx/abc.jpg" |
usage.image_count | Integer | 本次請求生成圖像計(jì)量 | "image_count": 1 |
request_id | String | 本次請求的系統(tǒng)唯一碼 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
請求示例
以下示例展示通過CURL命令來調(diào)用本模型的腳本
需要使用您的API-KEY替換示例中的 your-dashscope-api-key ，代碼才能正常運(yùn)行。
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è)提交后將處于排隊(duì)狀態(tài)，在得到調(diào)度之后將轉(zhuǎn)為運(yù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",
"error_message":"Success",
"start_time":"xxx",
"style_index":0,
"error_code":0,
"results":[
{
"url":"http://oss.aliyuncs.com/xxx/abc.jpg"
}
]
},
"usage":{
"image_count":1
}
}響應(yīng)示例（作業(yè)失敗）
如果因?yàn)槟撤N原因作業(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 | 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 | 輸入圖像分辨率過大或過小 |