Real Face

What is Real Face

Token360 RealFace integrates with the BytePlus ModelArk real-human asset library. RealFace assets are verified real-person images that can be referenced in video generation tasks to produce consistent character appearances.

Each asset is identified by a Token360 asset ID in the format ta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

Supported Models

RealFace assets are currently supported for the following video generation models:

Note: seedance-1.5-pro and other non-BytePlus video models do not support RealFace assets.

Setting Up Real Face Assets

Setting Up Real Face Assets in Assets page

Before you can use RealFace in the Playground, create a Real Face asset group on the unified Assets page, complete real-person verification, and upload images into that group.

1. Open Assets

Click your avatar in the top-right corner and select Assets from the dropdown menu.

2. Create a Real Face group

In the Asset groups section, click New group. In the Create asset group dialog, select Real Face, enter a Group name, and click Create. Real Face groups use the server default retention of No fixed expiry for uploaded files; this field is read-only in the dialog.

After creation, the dialog shows a verification link and QR code. Send either one to the real person so they can complete H5 real-person verification. The link is valid for 2 minutes (120 seconds). If it expires before verification is completed, create a new Real Face group.

The group appears in the Asset groups table. Use the Status column to confirm the group is active before uploading images into it.

3. Upload assets

In the Assets section, click Upload and choose an image file. In the Upload file dialog, enter a Display name, set Asset group to the active Real Face group, and click Upload. The Retention selector is locked for Real Face groups because these uploads do not use a per-file expiry date.

• The asset appears in the Assets table under the selected group
• Each asset has a unique Asset ID in the format ta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
• Click the Asset ID to copy it for API usage
• Assets may show Processing while BytePlus registers and validates them

Use the Asset group filter in the Assets table when you want to show only one Real Face group. The filter changes the visible rows only; the upload destination is selected in the Upload file dialog.

Only assets with Active status can be used in video generation. RealFace inputs must come from Real Face groups as provider-backed assets; generic user uploads are not valid RealFace asset references.

Setting Up Real Face Assets via API

Use the Assets API when you need to create and prepare RealFace assets outside the UI.

1. Create a Real Person group

Create a RealFace group with POST /v1/asset-groups and groupKind=REAL_FACE. The response includes the canonical assetGroupId and may include an h5Link verification URL.

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": "Real Person Name",
6    "groupKind": "REAL_FACE"
7  }'

Send the h5Link to the real person so they can complete H5 real-person verification. The link is valid for 2 minutes (120 seconds). If it expires before verification is completed, call GET /v1/asset-groups/{assetGroupId} to get a fresh link.

2. Get the verified asset group ID

After verification is complete, use the returned assetGroupId as the upload groupId. You can also call GET /v1/asset-groups with groupKind=REAL_FACE to find active RealFace groups.

1curl "https://api.token360.ai/v1/asset-groups?groupKind=REAL_FACE&current=1&size=100" \
2  -H "Authorization: Bearer sk-your-api-key"

3. Upload RealFace assets

Upload image files with POST /v1/assets using multipart form data. Set groupId to the active Real Face group assetGroupId.

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

The upload response returns an asset record id and an assetId. The assetId uses the ta_ prefix and is the only asset ID to use in asset:// video inputs for RealFace.

4. Poll until the asset is active

Poll GET /v1/assets/{assetId} or GET /v1/assets?groupId=your-asset-group-id until the asset status is active.

Use asset://{assetId} in video generation requests after the asset becomes active. Use the asset assetId, not the asset record id, Real Person id, or asset group ID.

Do not use generic user-upload asset IDs, such as IDs with the ua_ prefix, as RealFace references. If an image was uploaded as a generic asset, upload it again into the active Real Face group.

Using Real Face

Using RealFace in the Playground

1. Select a Supported Model

In the Playground, choose from Supported Models.

2. Choose a Video Mode

RealFace can be used in the following video modes:

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

3. Select a RealFace Asset

For supported Seedance video modes, each compatible media block, such as First frame, Last frame, or Reference images, has source buttons in its header:

• Click the upload icon to add a local file from your device
• Click the library icon, labeled From assets, to open Choose from your library

In Choose from your library, set the type dropdown to Real Face, or search by asset name or asset ID. Image slots are locked to images, and you can also filter by group. The picker only allows active, non-expired assets.

For single-image slots such as first frame or last frame, click an asset card to use it immediately. For multi-image slots such as reference images, select one or more asset cards and click Use selected. Selected RealFace inputs are marked with an Asset badge in the Playground.

4. Generate the Video

After selecting the RealFace asset(s), fill in the prompt and other parameters, then click Generate.

Using RealFace via API

You can find the asset ID on the Assets page. Filter by the Real Face group, then click the Asset ID to copy it.

Reference a RealFace asset with the asset:// protocol and the asset's Token360 asset ID, for example asset://ta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Use the asset assetId, not the Real Person group ID, asset group ID, or asset record ID.

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 verified person 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_first_frame_asset_id" }
12      }
13    ],
14    "duration": 5,
15    "resolution": "720p",
16    "generate_audio": false
17  }'

Limitations

• RealFace assets are only available for BytePlus Seedance 2.0 series models
• Each asset must belong to an active Real Person and itself be in active status
• Asset availability is subject to BytePlus ModelArk service status