如何在 Seedance 2.5 中使用 AIHubMix 真人資產呈現真實人臉

當畫面中的人物在不同場景中都能維持一致、讓人認得出來時，AI 影片就會實用得多。AIHubMix 真人資產提供一種經當事人同意的使用方式，讓您在 Seedance 影片生成中使用經授權的人臉，並將授權、資產處理與生成拆分為不同且可驗證的步驟。

本指南將說明什麼是真人影片、AIHubMix 的工作流程如何運作、這種方式有哪些優點，以及如何使用真人臉建立 Seedance 2.5 影片。此外，也會說明原生 Seedance 2.5 API 與相容 Seedance 2.0 整合方案的差異。

什麼是真人影片？

真人影片是以經授權的人物作為身分參照所生成的 AI 影片。模型可以變更場景、服裝、動作、鏡頭運動、語音或語言，同時保留該人物可辨識的外貌。

這與一般的文字轉影片生成不同。提示詞可以描述要發生什麼事，但無法可靠地指定某位真實人物。真人資產則會提供經核准的視覺參照，讓模型能在多部影片中重複使用。

常見應用包括創作者虛擬分身、虛擬主持人、產品解說、在地化行銷活動、訓練影片、品牌角色，以及社群短影音。

AIHubMix 工作流程如何運作

此工作流程包含五個主要階段：

為一位人物建立資產群組。
請照片中的人物完成授權流程。
新增肖像照，並等待資產啟用。
使用 asset:// URI 參照已啟用的資產。
提交 Seedance 影片任務，並持續輪詢直到完成。

刻意將這些步驟分開處理。生成前會先完成授權，您可以獨立確認資產是否就緒，而每個重要階段也都會提供應用程式可監控的狀態。

為什麼選擇 AIHubMix？

一個 API 完成整套工作流程

AIHubMix 提供資產群組、驗證工作階段、真人資產及非同步影片生成的端點。您可以使用同一個帳戶和 API 金鑰管理整個流程。

明確的授權流程

肖像照中的人物會完成授權頁面上的流程。這能在將影像作為可重複使用的真人參照前，明確完成同意步驟。

可重複使用的身分資產

影像啟用後，應用程式即可在多個影片請求中重複使用其資產 ID，不必每次都上傳原始影像。

支援 Seedance 生成

原生 Seedance 2.5 端點支援文字、影像、影片和音訊參照，也提供影片長度、解析度、長寬比和音訊生成等控制選項。

狀態明確，適合正式環境使用

應用程式可以等待狀態變為 verified、active 和 completed，而不必猜測作業是否已完成。如此一來，實作重試與錯誤處理也會更容易。

逐步教學

步驟 1：準備 API 金鑰和肖像照

在 AIHubMix 控制台建立 API 金鑰，並妥善保管。在終端機中將它設為環境變數：

export AIHUBMIX_API_KEY="your_api_key"

準備一個可直接存取的 HTTPS 影像網址。該網址必須能直接傳回影像檔案，不需要登入或自訂標頭，且在 AIHubMix 處理期間必須保持有效。

建議的影像條件：

JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC 或 HEIF
小於 30 MB
寬度和高度皆大於 300 像素且小於 6000 像素
長寬比大於 0.4 且小於 2.5
清晰的肖像照，且照片中的人物須與完成授權的人物相同

步驟 2：建立真人資產群組

在終端機中執行此指令：

curl -sS -X POST "https://aihubmix.com/ai/v1/asset-groups" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"My real-human asset"}'

儲存傳回的 id，其格式類似 ag_...：

GROUP_ID="ag_your_group_id"

新群組的初始狀態通常為 pending_auth。

步驟 3：建立授權工作階段

使用群組 ID 請求驗證工作階段：

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/verification-sessions" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

回應中會包含一個臨時的 verification_url。在瀏覽器中開啟該網址，並請肖像照中的人物閱讀用途說明並完成授權流程。

該網址具有敏感性且僅限短時間使用。請勿公開、提交到程式碼儲存庫，或將其放入螢幕截圖中。

步驟 4：確認授權和群組狀態

人物完成瀏覽器中的流程後，查詢這兩項資源：

curl -sS "https://aihubmix.com/ai/v1/verification-sessions/$SESSION_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

curl -sS "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

只有在驗證工作階段狀態為 verified，且資產群組狀態為 active 時，才繼續操作。瀏覽器錯誤頁面無法判定最終結果，請以 API 狀態為準。

步驟 5：新增肖像照

提交影像的直接網址：

curl -sS -X POST \
  "https://aihubmix.com/ai/v1/asset-groups/$GROUP_ID/assets" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: portrait-001" \
  -d '{
    "url":"https://cdn.example.com/portrait.jpg",
    "asset_type":"image",
    "client_reference_id":"portrait-001"
  }'

儲存傳回的資產 ID，並持續輪詢該資產：

ASSET_ID="ast_your_asset_id"
curl -sS "https://aihubmix.com/ai/v1/assets/$ASSET_ID" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY"

只有在資產狀態為 active 時才能使用。creating 和 processing 代表資產尚未就緒。

步驟 6：生成 Seedance 2.5 影片

真人資產應放在 input_references[].url 中，不要貼到提示詞文字裡：

curl -sS -X POST "https://aihubmix.com/ai/v1/videos" \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"model\":\"doubao-seedance-2-5-260628\",
    \"prompt\":\"A realistic vertical vlog. The person smiles, waves, and says in Japanese: やっほー！今日も笑顔でね！ Keep the face consistent, synchronize lip movement, use natural hand motion, and add no subtitles.\",
    \"duration\":5,
    \"resolution\":\"720p\",
    \"aspect_ratio\":\"3:4\",
    \"generate_audio\":true,
    \"input_references\":[{\"type\":\"image_url\",\"url\":\"asset://$ASSET_ID\"}]
  }"

回應會傳回影片任務 ID。持續輪詢 GET /ai/v1/videos/{id}，直到任務狀態變為 completed，然後盡快下載輸出影片，因為影片網址僅暫時有效。

Seedance 2.5 與 Seedance 2.0

Seedance 2.5 使用上述原生的 /ai/v1/videos 端點。舊版整合可能使用 Seedance 2.0，搭配相容的 /v1/videos 通訊協定和不同的內容結構。

請勿混用這兩種請求格式。投入正式環境前，請查看目前的模型結構描述，確認支援的影片長度、解析度、參照類型、音訊行為和端點路徑。

提示詞撰寫最佳做法

描述環境、動作、時間安排、鏡頭運動、語音和限制條件。好的提示詞可以指定和服、飄落的櫻花、輕柔揮手、日語對白、同步唇形、自然的頭髮擺動，以及不加字幕。

五秒適合用來製作簡短問候影片。如果影片包含多個動作或較長的句子，請延長影片時間，或縮短腳本，避免表演顯得倉促。

簡單測試時使用一個身分參照。只有在模型結構描述支援時才新增其他參照，且每項資產都必須屬於同一個資產群組。

常見問題

群組尚未啟用：等待驗證工作階段狀態變為 verified，且群組狀態變為 active。
資產仍在處理中：持續輪詢原本的資產 ID；不要用新的 ID 建立重複資產。
影像網址無法使用：請使用公開的 HTTPS 檔案網址，而非本機路徑、登入頁面或分享頁面。
影片生成拒絕使用該資產：確認資產狀態為 active、屬於同一個帳戶，且使用正確的媒體類型。
Playground 未顯示 asset://：Playground 的影像上傳與真人資產登錄是不同的工作流程。已登錄的資產請使用 API 的參照欄位。

最後檢查清單

已安全設定 API 金鑰。
已建立資產群組。
人物已完成授權。
群組狀態為 active。
肖像資產狀態為 active。
影片請求使用 asset://<asset_id>。
持續輪詢影片任務，直到狀態變為 completed。

AIHubMix 真人資產讓開發者能以實用方式，運用 Seedance 打造經當事人同意且身分一致的影片體驗。先使用一張已核准的肖像照製作短片進行測試，再將相同工作流程擴展至創作者工具、品牌內容和正式應用程式。