如何在 AIHubMix 真人素材中使用 Seedance 2.5 的真实人脸

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 图片 URL。该 URL 必须无需登录或自定义请求头即可返回图片文件，并且在 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。在浏览器中打开该 URL，并请图片中的人物查看用途说明后完成授权流程。

该 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 步：添加人像照片

提交直接图片 URL：

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，然后及时下载输出结果，因为视频 URL 是临时的。

Seedance 2.5 与 Seedance 2.0

Seedance 2.5 使用上文所述的原生 /ai/v1/videos 端点。较早的集成可能使用 Seedance 2.0，并采用兼容的 /v1/videos 协议以及不同的内容结构。

请勿混用两种请求格式。投入生产使用前，请检查实时模型架构中支持的时长、分辨率、参考类型、音频行为以及端点路径。

提示词最佳实践

描述环境、动作、时间节奏、镜头运动、声音和约束条件。一个较好的提示词可以指定和服、飘落的樱花、轻柔的挥手、日语对白、同步的口型、自然的发丝摆动，以及不显示字幕。

对于简短的问候，五秒钟效果很好。如果视频包含多个动作或较长的句子，请使用更长的时长，或缩短台词，使表演不会显得仓促。

进行简单测试时，使用一个身份参考即可。只有在模型架构支持且每个素材都属于同一素材组时，才添加其他参考。

常见问题

素材组未激活：请等待验证会话变为 verified，并等待素材组变为 active。
素材正在处理中：请轮询原始素材 ID，不要使用新 ID 创建重复素材。
图片 URL 请求失败：请使用公开的 HTTPS 文件 URL，而不是本地路径、登录页面或分享页面。
视频请求拒绝该素材：请确认素材为 active 状态，属于同一账户，并且媒体类型正确。
Playground 中不显示 asset://：Playground 的图片上传与真人素材注册是两套独立的流程。对于已注册的素材，请使用 API 参考中的字段。

最终检查清单

API 密钥已安全配置。
素材组已创建。
人物授权已完成。
素材组状态为 active。
人像素材状态为 active。
视频请求使用 asset://<asset_id>。
视频任务已轮询直至 completed。

AIHubMix 真人素材为开发者提供了一种切实可行的方式，借助 Seedance 构建基于授权同意、身份保持一致的视频体验。可以先从一张经过批准的人像照片和一段短测试视频开始，然后将同一工作流扩展到创作者工具、品牌内容和生产级应用中。