{"templateId":"api_docs","sharedDataIds":{"apiDocsStore":"api-docs-@l10n/zh-TW/reference/ai_beard_style.yaml","sidebar":"sidebar-@l10n/zh-TW/reference/sidebars.yaml"},"props":{"definitionId":"@l10n/zh-TW/reference/ai_beard_style.yaml","settings":{"baseUrlPath":"/zh-tw/reference/ai_beard_style"},"disableAutoScroll":true,"seo":{"title":"AI 虛擬鬍鬚造型","description":"YouCam API documentation by Perfect Corp. Learn how to use Skin analysis API, Virtual try-on API, Image editing API, and Video generative AI APIs.","siteUrl":"https://docs.perfectcorp.com","keywords":"AI Skin Analysis, AI Clothes, AI Hairstyle, AI Outfits","image":"/assets/favicon.cd6fa4d833b2a573b3c6dae68386b293da205b203402cb0c97b80bd2acc07ea2.8351e24f.png"},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"AI 虛擬鬍鬚造型","version":"","description":"# 概述\n男士鬍型生成的 AI 模擬\n\nAI 演算法也賦能男性完全自由地，以高度精緻的鬍型模擬技術虛擬嘗試不同的鬍型，包括整齊短鬍、短鬚、全鬍、圓鬍、八字鬍、山羊鬍等。\n\n購物者也能看見前後結果，無需承擔動刀的承諾。\n鬍型濾鏡包括八字鬍、短方鬍、鴨尾鬍、圓鬍等十余種。\n\n## 整合指南\n\n1. **上傳自拍**\n 您可以透過兩種方式之一提供來源圖片：\n\n - **使用現有的公開圖片網址**\n 無需上傳，您可以在啟動 AI 任務時直接提供可公開存取的圖片網址。\n\n - **透過 File API 上傳**\n 使用端點：\n ```\n POST /s2s/v2.0/file\n ```\n 這會回傳用於後續任務執行的 `file_id`。\n\n - ***重要***：僅呼叫 File API 並不會上傳您的檔案。您必須**手動上傳**檔案到**File API 回應中提供的網址**。該網址就是您的上傳目的地，請確保檔案成功傳輸到該處後再繼續。

\n 在呼叫 AI API 之前，請確保您的檔案已成功上傳。使用 File API 取得上傳網址，然後將檔案上傳到該位置。上傳完成後，您會在回應中取得 ***file_id***，這個 ID 就是您用於存取該檔案相關 AI 功能的依據。\n\n > **警告：** 請注意，若您未將檔案上傳到 File API 回應中提供的網址，使用 AI API 時會得到 500 Server Error / unknown_internal_error 或 404 Not Found 錯誤。\n\n2. **列出預先定義的風格**\n * 使用 /s2s/v2.0/task/template/beard-style 取得預先定義的範本清單，並選擇 ``template_id`` 執行 AI 任務。\n\n3. **執行 AI 任務以取得任務 ID**\n 使用 /s2s/v2.0/task/beard-style 執行 AI 任務。對於目標使用者圖片，提供 ``src_file_url`` 或 ``src_file_id``。並提供要套用的 ``template_id`` 以取得 ``task_id``。\n\n4. **輪詢以查詢任務狀態直到成功或失敗**\n 使用 ``task_id``，透過輪詢 GET /s2s/v2.0/task/beard-style 監控任務狀態，以取得目前的引擎狀態。在引擎完成任務之前，狀態會維持為 running，此階段不會消耗點數。\n 您也可以實作 webhook，在 AI 任務成功或失敗時接收通知。細節請參考 **[Webhook](../../../develop/webhook)** 章節。\n\n > **警告：** 必須在任務的保留期間內輪詢以查詢任務狀態。若在保留期間內沒有輪詢請求，任務將會逾時，即使任務已成功處理。您的點數仍會被消耗。\n\n > **警告：** 若您查詢已逾時任務的狀態，會收到 InvalidTaskId 錯誤。因此，執行 AI 任務後，您必須在保留期間內輪詢以查詢狀態，直到狀態變為 success 或 error。\n\n5. **成功後取得 AI 任務的結果**\n 引擎處理您的輸入檔案並生成結果影像後，任務狀態會變為 success。您會取得處理後圖片的網址。\n\n---\n\n## 檔案規格與錯誤\n * 支援的格式與尺寸\n\n|AI 功能|支援的尺寸|支援的檔案大小|支援的格式|\n| ---- | ---- | ---- | ---- |\n|AI 虛擬鬍鬚造型|解析度：長邊 < 1024
臉寬 > 256
臉部姿勢：-30 < yaw < 30,
僅限單張臉部,
需呈現完整臉部|< 10MB|jpg/jpeg|\n\n * 錯誤代碼\n\n|錯誤代碼|說明|\n| ---- | ---- |\n|error_no_face\t|來源圖片中臉部不可見\n|error_src_face_too_small\t|臉部過小\n|error_inference\t|鬍型移除錯誤或鬍型生成錯誤\n|error_face_pose\t|來源圖片的臉部姿勢不受支援\n\n * 環境與相依性\n\n| 範例程式語言 / 工具 | 建議的執行環境版本 |\n|---|---|\n| cURL | - bash >= 3.2
- curl >= 7.58（現代 TLS/HTTP 支援）
- jq >= 1.6（穩健的 JSON 解析） |\n| Node.js（JavaScript） | Node >= 18（支援全域 fetch） |\n| JavaScript | - Chrome / Edge >= 80
- Firefox >= 74
- Safari >= 13.1 |\n| PHP | PHP >= 7.4（現代 TLS/相容性），ext-curl（建議）或 allow_url_fopen=On + ext-openssl、ext-json |\n| Python | Python >= 3.10（支援 f-strings），requests >= 2.20.0 |\n| Java | Java 11+（支援 HttpClient），Jackson Databind >= 2.12.0 |\n\n---\n\n## 點數消耗\n\n| AI 功能 | 消耗的點數 |\n|---|---|\n| AI 虛擬鬍鬚造型 V1.0 | 2 |\n\n---\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"docs.perfectcorp.com","port":4000,"ipAddress":"216.73.216.199"},"lang":"zh-TW","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"master"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh-tw/reference/ai_beard_style","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}