视频与素材

创建素材

把图片、视频或音频保存为可复用的 Seedance 素材。

POST
/v1/videos/assets

提交一个可公开访问的文件 URL,TokenLab 会将它保存到 Seedance 素材组。后续生成使用返回的素材 id。

library_type: "aigc_avatar" 可以省略 group_id,素材会进入组织的默认虚拟人物素材组(不存在时自动创建)。library_type: "liveness_face" 必须传入 视觉验证结果 返回的素材组 ID。project_name 不是 default 时也必须传 group_id。素材组必须属于同一个 project_name 和 library_type,否则返回 400。

类型支持的输入
图像jpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; ≤30 MiB; 宽度和高度 [300, 6000] px; 宽高比 [0.4, 2.5].
视频mp4, mov; ≤200 MiB.
音频aac, wav, mp3; ≤15 MiB.

TokenLab 会在受理请求前检查来源 URL、媒体类型、文件大小,以及可读取图像的尺寸。来源未通过检查时返回 400 和 seedance_material_source_* 错误码,例如 seedance_material_source_invalid(图像尺寸或宽高比超出范围)、seedance_material_source_type_mismatch、seedance_material_source_too_large、seedance_material_source_url_unreachable。其他媒体及人脸要求在处理期间校验,所以受理不代表素材已就绪:请等待 ACTIVE,处理失败时查看 error_message。

创建成功返回 201,此时 status 为 PROCESSING。通过 获取素材 查询状态;status 变为 ACTIVE 后即可使用。真人素材组只对应一位已验证人员,图片中出现多张人脸或人员不一致时会处理失败。

project_name 用于同一组织内的资源隔离,默认为 default。相关素材组和素材须使用相同且区分大小写的值;POST/PUT 在 JSON 请求体中传入,GET/DELETE 在查询参数中传入。

请求示例

curl https://api.tokenlab.sh/v1/videos/assets \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_id":"group-20260720123456-vrt01","asset_url":"https://example.com/reference.png","asset_type":"Image","asset_name":"Front view","project_name":"default"}'

响应示例

{
  "id": "asset-20260720123456-qn7wr",
  "object": "seedance.material_asset",
  "project_name": "default",
  "group_id": "group-20260720123456-vrt01",
  "library_type": "aigc_avatar",
  "asset_name": "Front view",
  "asset_type": "Image",
  "status": "PROCESSING",
  "ready": false,
  "error_message": null,
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X POST "https://example.com/v1/videos/assets" \  -H "Content-Type: application/json" \  -d '{    "asset_url": "https://example.com/reference.png",    "asset_name": "Front view",    "asset_type": "Image",    "library_type": "aigc_avatar",    "group_id": "group-20260720123456-vrt01"  }'
{  "id": "asset-20260720123456-qn7wr",  "object": "seedance.material_asset",  "group_id": "group-20260720123456-vrt01",  "library_type": "aigc_avatar",  "asset_name": "Front view",  "asset_type": "Image",  "status": "PROCESSING",  "ready": false,  "error_message": null,  "metadata": null,  "created_at": 1782998400000}

授权

BearerAuth
AuthorizationBearer <token>

API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。

位置: header

请求体

application/json

响应

application/json

application/json

application/json

application/json

application/json

application/json