Face Enhancer API

關於 Face Enhancer

Face Enhancer 可以修復並銳化一張照片中最多三張臉，從最大的開始處理。畫面中其他部分保持不變，解析度也不變，結果以 JPEG、PNG 或 WebP 返回。無需撰寫提示詞。

在 POST /jobs/createTask 把模型名稱填成 popnow/face-enhancer-v1/edit 就能呼叫，US$0.012 起。

請求參數

價格

價格以美元計。API 使用獨立的美元餘額。網站點數不能用於 API，也不能轉入 API 餘額；API 餘額同樣不能轉為網站點數。 任務受理時，從 API 餘額中保留報價的最高金額；完成後按實際用量結算，實際扣款不超過保留金額，並釋放剩餘金額。任務失敗則釋放保留金額。

執行前，將相同請求內容傳送至 POST /jobs/quote，即可查看預估費用與最高費用，單位為美元。報價不會執行任務或扣款。

API 快速上手

三步驟呼叫 Face Enhancer API

1. 建立 API 金鑰. 登入 PopNow，在 API 主控台建立金鑰。金鑰以 sk-popnow- 開頭，API 呼叫使用獨立的美元餘額。
2. 送出請求. 對 POST /jobs/createTask 送出請求，model 填 popnow/face-enhancer-v1/edit，input 依照參數表填寫。回應會立即傳回任務 ID。
3. 取得結果. 用任務 ID 輪詢 GET /jobs/recordInfo，或帶上 callBackUrl，結果會推送到該網址。任務成功後下載輸出連結。

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "popnow/face-enhancer-v1/edit",
  "input": {
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "output_format": "jpeg"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

請把提示詞和連結換成你自己的。API 頁籤裡有回應、輪詢和回呼的參考。

Face Enhancer API 常見問題

所有 Face Enhancer 模型

Image Upscaler 會放大整張圖片；Face Enhancer 則是在保持臉部尺寸不變的前提下修復臉部。

• Face Enhancer API修復照片中最多三張臉，解析度不變US$0.012 起 /張
• Video Face Enhancer API在片段每一幀上穩定修復臉部US$0.012 起 /秒

更多 Face Enhancer 相關內容

試用

Face Enhancer AI 生成圖片 線上使用在 PopNow 用 Face Enhancer 生成圖片

文件

API 文件中的 Face Enhancer 模型名稱與輸入格式PopNow API 快速入門：五分鐘送出第一個請求PopNow API 圖片生成指南Webhook：不用輪詢也能取得 Face Enhancer 的結果