视频与素材
获取素材
通过素材 ID 获取一个 Seedance 素材。
获取素材及其处理状态。ready 为 true 且 status 为 ACTIVE 时即可用于视频生成。
如果返回 Seedance material asset not found or not accessible,请确认传入的是素材 id,不是 group_id。
project_name 用于同一组织内的资源隔离,默认为 default。相关素材组和素材须使用相同且区分大小写的值;POST/PUT 在 JSON 请求体中传入,GET/DELETE 在查询参数中传入。
请求示例
curl "https://api.tokenlab.sh/v1/videos/assets/asset-20260720123456-qn7wr?project_name=default" \
-H "Authorization: Bearer $TOKENLAB_API_KEY"响应示例
{
"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": "ACTIVE",
"ready": true,
"error_message": null,
"metadata": null,
"created_at": 1782998400000
}curl -X GET "https://example.com/v1/videos/assets/asset-20260720123456-qn7wr"{ "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": "ACTIVE", "ready": true, "error_message": null, "metadata": null, "created_at": 1782998400000}授权
BearerAuth AuthorizationBearer <token>
API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。
位置: header
路径参数
assetId*string
查询参数
project_name?string
素材资源的项目范围。
长度
1 <= length <= 128默认值
"default"响应
application/json
application/json
application/json
application/json
application/json