# AI 形象照

# 概述
用我們的 AI 形象照，將您的照片轉換為令人驚豔的專業形象照。運用我們強大的 AI 工具，快速有效地提升您的形象照，提供專業品質的結果。
* 多元風格：從精緻的 LinkedIn 形象照、專業商務形象照，到創意模特兒形象照，我們的 AI 形象照幫助您選擇最適合需求的完美外觀。
* 專業結果：運用 AI 確保您的形象照自然且得體，給潛在雇主與客戶留下深刻印象。
* 便利：隨時隨地生成多張 AI 形象照，無需攝影師。最適合忙碌的專業人士。

更多 AI 商務形象照風格，請參考 https://yce.makeupar.com/ai-headshot-generator。
應用案例：
![AI Headshot Generator](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_headshot_s2_img_03_4b55742358.jpg)
![AI Headshot Generator](https://bcw-media.s3.ap-northeast-1.amazonaws.com/yce_headshot_s1_img_1_d03183d7e0.jpg)
拍攝建議：
![拍攝建議](https://bcw-media.s3.ap-northeast-1.amazonaws.com/AI_Hair_Extension_recommendation_ba24bd5d92.png)


---

## 檔案規格與錯誤
* 支援的格式與尺寸

| AI 功能 | 支援的尺寸 | 支援的檔案大小 | 支援的格式 |
|  --- | --- | --- | --- |
| AI 形象照 | 請確保輸入圖片包含單人，且 OpenPose 可見兩側肩膀點與完整臉部，短邊 ≤ 1024 像素——否則引擎會自動調整為 1024。輸出：長邊 <= 1024 | < 10MB | jpg/jpeg/png |

* 錯誤代碼

| 錯誤代碼 | 說明 |
|  --- | --- |
| exceed_max_filesize | 輸入檔案大小超過上限 |
| invalid_parameter | 參數值無效 |
| error_download_image | 下載來源圖片錯誤 |
| error_decode_image | 解碼來源圖片錯誤 |
| error_nsfw_content_detected | 在來源圖片中偵測到 NSFW 內容 |



---

## 點數消耗
| AI 功能 | 消耗的點數 |
|  --- | --- |
| AI 形象照 V1.0 | 2 張圖片 1 點 * |

> *若圖片數量或影片長度無法整除，點數無條件進位。



---

License: Privacy policy

## Servers

```
https://yce-api-01.makeupar.com
```

## Security

### BearerAuthenticationV2

使用標準的 'Bearer authentication'。請在標頭中放入您的 'API Key'：`Authorization:Bearer YOUR_API_KEY`。請注意 'Bearer' 與 'YOUR_API_KEY' 之間有一個空格。

Type: http
Scheme: bearer

## Download OpenAPI description

 - [AI 形象照](https://docs.perfectcorp.com/_bundle/@l10n/zh-TW/reference/ai_headshot_generator.yaml)

## V1.0

 - [GET /s2s/v2.0/task/template/headshot](https://docs.perfectcorp.com/zh-tw/reference/ai_headshot_generator/v1.0/paths/~1s2s~1v2.0~1task~1template~1headshot/get.md)
 - [POST /s2s/v2.0/task/headshot](https://docs.perfectcorp.com/zh-tw/reference/ai_headshot_generator/v1.0/paths/~1s2s~1v2.0~1task~1headshot/post.md): AI 任務是非同步的。當功能支援 webhook 時，請優先使用以 webhook 為基礎的完成處理。設定您的 webhook 端點、驗證 webhook 簽章，並在收到 `success` 或 `error` 通知後，使用收到的 `task_id` 查詢任務結果。設定與驗證細節請見 [webhook 整合指南](/develop/webhook)。 若您的整合不支援 webhook 或無法使用
 - [GET /s2s/v2.0/task/headshot/{task_id}](https://docs.perfectcorp.com/zh-tw/reference/ai_headshot_generator/v1.0/paths/~1s2s~1v2.0~1task~1headshot~1%7Btask_id%7D/get.md)