Video y recursos

Crear activo de material

Sube un activo de material de Seedance a un grupo de materiales de TokenLab.

POST
/v1/videos/assets

Importe una URL de origen accesible públicamente a un grupo de materiales de Seedance. TokenLab almacena el material para su uso posterior; utilice el id del activo de material devuelto para la generación, no la URL de origen.

Para library_type: "aigc_avatar", group_id es opcional; si no se proporciona, TokenLab utiliza o crea el grupo de avatares virtuales predeterminado de la organización. Para library_type: "liveness_face", group_id es obligatorio y debe ser el grupo de TokenLab devuelto por Obtener resultado de validación visual. group_id también es obligatorio cuando project_name no es default. El grupo debe pertenecer al mismo project_name y library_type, o la solicitud devolverá un error 400.

TipoEntrada admitida
Imagenjpeg, jpg, png, webp, bmp, tiff, gif, heic, heif; ≤30 MiB; ancho y alto [300, 6000] px; relación de aspecto [0.4, 2.5].
Videomp4, mov; ≤200 MiB.
Audioaac, wav, mp3; ≤15 MiB.

TokenLab verifica la URL de origen, el tipo de medio, el tamaño del archivo y, cuando la imagen puede leerse, sus dimensiones antes de aceptar la solicitud. Una fuente que no supere estas comprobaciones devolverá un error 400 con un código seedance_material_source_*, por ejemplo seedance_material_source_invalid (dimensiones de imagen o relación de aspecto fuera de rango), seedance_material_source_type_mismatch, seedance_material_source_too_large o seedance_material_source_url_unreachable. Otros requisitos de medios y rostros se evalúan durante el procesamiento, por lo que la aceptación no significa que el activo esté listo: espere a que el estado sea ACTIVE e inspeccione error_message si el procesamiento falla.

Una solicitud exitosa devuelve 201 con status: "PROCESSING". Realice consultas a Obtener activo de material hasta que el status sea ACTIVE. Para grupos de personas reales, un grupo se asigna a una persona verificada; las subidas con múltiples rostros o un rostro que no coincida con la persona verificada pueden fallar.

project_name delimita los recursos dentro de su organización y tiene como valor predeterminado default. Utilice el mismo valor (sensible a mayúsculas y minúsculas) para los grupos y activos relacionados. Envíelo en el cuerpo JSON para POST/PUT y en la cadena de consulta para GET/DELETE.

Ejemplo de solicitud

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"}'

Ejemplo de respuesta

{
  "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}

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Cuerpo de la solicitud

application/json

Respuesta

application/json

application/json

application/json

application/json

application/json

application/json