Virtual Portrait

什么是 Virtual Portrait

Token360 Virtual Portrait 集成了 BytePlus ModelArk AIGC 资产库，可将 AI 生成的角色图像作为视频生成工作流中的参考资产使用，无需真人验证。

每个资产通过 Token360 资产 ID 标识，格式为 ta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。

与 RealFace 的主要区别

Supported Models

Virtual Portrait 资产目前支持以下视频生成模型：

注意： seedance-1.5-pro 和其他非 BytePlus 视频模型不支持 Virtual Portrait 资产。

设置 Virtual Portrait 资产

在 Assets 页面设置 Virtual Portrait 资产

在 Playground 中使用 Virtual Portrait 之前，请先在统一的 Assets 页面创建 Virtual Portrait 资产组，并将图像上传到该分组。

1. 打开 Assets

点击右上角头像，在下拉菜单中选择 Assets。

2. 创建 Virtual Portrait 分组

在 Asset groups 区域点击 New group。在 Create asset group 弹窗中选择 Virtual Portrait，输入 Group name，然后点击 Create。Virtual Portrait 分组上传使用服务器默认的 No fixed expiry 保留策略，该字段在弹窗中为只读。

该分组会显示在 Asset groups 表格中，创建后即可使用，无需 H5 真人验证步骤。

3. 上传资产

在 Assets 区域中点击 Upload 并选择图像文件。在 Upload file 弹窗中填写 Display name，将 Asset group 设置为 Virtual Portrait 分组，然后点击 Upload。Virtual Portrait 分组的 Retention 选择器会被锁定，因为这类上传不使用单文件过期时间。

• 资产会显示在所选分组下的 Assets 表格中
• 每个资产都有唯一 Asset ID，格式为 ta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
• 点击 Asset ID 可复制，用于 API 调用
• 资产可能会先显示为 Processing，BytePlus 注册和验证完成后才能使用

如需只查看某个 Virtual Portrait 分组的资产，请使用 Assets 表格中的 Asset group 筛选器。该筛选器只改变表格显示内容；上传目标需要在 Upload file 弹窗中选择。

只有状态为 已激活 的资产才能在视频生成中使用。Virtual Portrait 输入必须来自 Virtual Portrait 分组中由服务商注册的资产；普通用户上传资产不能作为 Virtual Portrait 资产引用。

通过 API 设置 Virtual Portrait 资产

如需在 UI 之外创建和准备 Virtual Portrait 资产，请使用 Assets API。

1. 创建 Virtual Portrait 分组

调用 POST /v1/asset-groups 并设置 groupKind=VIRTUAL_PORTRAIT 创建 Virtual Portrait 分组。响应会返回标准 assetGroupId，并且分组会立即处于 active 状态。

1curl -X POST https://api.token360.ai/v1/asset-groups \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "name": "Virtual Portrait Name",
6    "groupKind": "VIRTUAL_PORTRAIT"
7  }'

2. 上传 Virtual Portrait 资产

使用 POST /v1/assets 通过 multipart form data 上传图像文件。把 Virtual Portrait 分组的 assetGroupId 作为 groupId。

1curl -X POST https://api.token360.ai/v1/assets \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -F "groupId=your-virtual-portrait-group-id" \
4  -F "file=@your-image-file.jpg" \
5  -F "name=Asset Name"

上传响应会返回资产记录 id 和 assetId。assetId 使用 ta_ 前缀，是 Virtual Portrait 在 asset:// 视频输入中唯一应使用的资产 ID。

3. 轮询直到资产变为 active

请轮询 GET /v1/assets/{assetId} 或 GET /v1/assets?groupId=your-virtual-portrait-group-id，直到资产状态变为 active。

资产变为 active 后，可在视频生成请求中使用 asset://{assetId} 引用。请使用资产的 assetId，不要使用资产记录 id 或 Virtual Portrait 分组 ID。

不要使用普通用户上传资产 ID（例如 ua_ 前缀的 ID）作为 Virtual Portrait 引用。如果图片是作为普通资产上传的，请重新上传到已激活的 Virtual Portrait 分组。

使用 Virtual Portrait

在 Playground 中使用 Virtual Portrait

1. 选择支持的模型

在 Playground 中，从 Supported Models 中选择模型。

2. 选择视频模式

Virtual Portrait 资产可在以下视频模式中使用：

• First-frame I2V
• First & last frame
• Reference images
• Multimodal reference
• Edit video
• Extend video

3. 选择资产

对于支持的 Seedance 视频模式，每个兼容的媒体区块（例如 First frame、Last frame 或 Reference images）标题栏中都有来源按钮：

• 点击上传图标，从本机添加文件
• 点击资源库图标（提示文字为 From assets），打开 Choose from your library

在 Choose from your library 中，将类型下拉框设置为 Virtual Portrait，或按资产名称、资产 ID 搜索。图像槽位会锁定为只显示图片，也可以按分组筛选。选择器只允许选择 active 且未过期的资产。

对于首帧、尾帧等单图槽位，点击资产卡片后会立即使用该资产。对于参考图等多图槽位，先选择一个或多个资产卡片，再点击 Use selected。在 Playground 中，已选择的 Virtual Portrait 输入会显示 资产 标记。

4. 生成视频

选择 Virtual Portrait 资产后，填写提示词和其他参数，然后点击 生成。

通过 API 使用 Virtual Portrait

您可以在 Assets 页面找到资产 ID。按 Virtual Portrait 分组筛选，然后点击 Asset ID 即可复制。

使用 asset:// 协议和资产的 Token360 资产 ID 引用 Virtual Portrait 资产，例如 asset://ta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。请使用资产的 assetId，不要使用 Virtual Portrait 分组 ID 或资产记录 ID。

请使用各视频模型输入参数 schema 中显示的媒体输入字段：

• 首帧或尾帧：使用 frame_images[].image_url.url
• 参考图和其他图像参考：使用 input_references[].image_url.url

1curl -X POST https://api.token360.ai/v1/videos \
2  -H "Authorization: Bearer sk-your-api-key" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "model": "seedance-2.0",
6    "prompt": "A stylized virtual character smiles and turns toward the camera in soft studio light",
7    "frame_images": [
8      {
9        "type": "image_url",
10        "frame_type": "first_frame",
11        "image_url": { "url": "asset://ta_virtual_portrait_asset_id" }
12      }
13    ],
14    "duration": 6,
15    "resolution": "720p",
16    "generate_audio": false
17  }'

限制

• Virtual Portrait 资产仅适用于 BytePlus Seedance 2.0 系列模型
• 每个资产必须属于已激活的 Virtual Portrait Group，且资产本身也必须为已激活状态
• 资产可用性受 BytePlus ModelArk 服务状态影响