{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh-TW/develop/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"快速上手指南","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":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"快速上手指南","__idx":0},"children":["快速上手指南"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["首先，請在 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://yce.makeupar.com/ai-api"},"children":["https://yce.makeupar.com/ai-api"]}," 免費註冊 YouCam API 帳號。接著您可以購買或訂閱，取得用於服務的點數。您可以在 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://yce.makeupar.com/api-console/en/api-keys/"},"children":["https://yce.makeupar.com/api-console/en/api-keys/"]}," 查看您的訂閱方案、按量計費點數與使用紀錄。請前往帳號頁面中的 API Key 分頁，產生並管理您的 API 金鑰，即可開始使用 YouCam API。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"工作流程步驟","__idx":1},"children":["工作流程步驟："]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"1-認證","__idx":2},"children":["1. 認證"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["使用 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bearer Token"]}," 在請求標頭中納入您的 API 金鑰：",{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer YOUR_API_KEY\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["您可以在 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://yce.makeupar.com/api-console/en/api-keys/"},"children":["https://yce.makeupar.com/api-console/en/api-keys/"]}," 找到您的 API Key。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"2-上傳檔案或準備一個公開可存取的圖片-url","__idx":3},"children":["2. 上傳檔案，或準備一個公開可存取的圖片 URL"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["呼叫 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["File API"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["從 File API 回應中取得上傳網址 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requests.url"]}," 與對應的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["file_id"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["使用 File API 回應中的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requests.url"]}," 上傳圖片"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"3-啟動-ai-任務並取得任務-id","__idx":4},"children":["3. 啟動 AI 任務並取得任務 ID："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["將已上傳的圖片與 AI 任務設定，透過 HTTP POST 請求送至 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/s2s/v2.0/task/skin-analysis"]},"。此處以 AI 肌膚檢測任務為例。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["等待回應中一個唯一的任務 ID，用以識別這次互動。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"4-輪詢任務狀態持續檢查","__idx":5},"children":["4. 輪詢任務狀態（持續檢查）："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["使用取得的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["task_id"]},"，透過 HTTP GET 請求（例如 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /skin-analysis/${task_id}"]},"）定期輪詢任務狀態。此處以 AI 肌膚檢測任務為例。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["持續監控：",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Task_status = \"success\""]},"（處理完成）。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Task_status = \"error\""]},"（視情況排除問題或重試）。"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["狀態轉為 success 後，依情況更新工作流程。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"5-取得結果","__idx":6},"children":["5. 取得結果"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["成功的回應會包含結果圖片的下載網址。"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"快速上手指南","id":"快速上手指南","depth":1},{"value":"工作流程步驟：","id":"工作流程步驟","depth":3},{"value":"1. 認證","id":"1-認證","depth":4},{"value":"2. 上傳檔案，或準備一個公開可存取的圖片 URL","id":"2-上傳檔案或準備一個公開可存取的圖片-url","depth":4},{"value":"3. 啟動 AI 任務並取得任務 ID：","id":"3-啟動-ai-任務並取得任務-id","depth":4},{"value":"4. 輪詢任務狀態（持續檢查）：","id":"4-輪詢任務狀態持續檢查","depth":4},{"value":"5. 取得結果","id":"5-取得結果","depth":4}],"frontmatter":{"seo":{"title":"快速上手指南"}},"lastModified":"2026-10-30T07:26:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh-tw/develop/quick_start_guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}