Listar activos

Disponibilidad

Esta página documenta la ruta de gestión de activos de Modelflare. Las llamadas requieren una clave API inteligente válida o una clave API de grupo de medios, un canal de medios disponible y el permiso requerido.

Nota

La puerta de enlace registra los ID de los activos del proveedor, el estado y la propiedad del usuario. La biblioteca local de Castaly permanece separada del espacio de nombres de activos del proveedor.

Punto final

POST https://modelflare.dev/volc/asset/ListAssets

Autenticación

Utilice una clave API de Modelflare:

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Enviar Idempotency-Key con solicitudes de creación, actualización y eliminación. Al volver a intentar la misma clave para el mismo usuario, se reproduce la respuesta guardada sin repetir la mutación.

Solicitud

Lista de activos con filtros opcionales de nombre, grupo y tipo de grupo. Espere Status: Active antes de usar una ID en una solicitud de Seedance.

Campo	Tipo	Requerido	Descripción	Ejemplo
model	string	Sí	Modelo de facturación. El valor predeterminado es volc-asset.	volc-asset
Filter.Name	string	No	Filtro de nombre de activo difuso.	character
Filter.GroupIds	string[]	No	Filtrar por ID de grupo.	["group-20260320141746-zsf6b"]
Filter.GroupType	AIGC	LivenessFace	No	Filtrar por tipo de grupo.
PageNumber	integer	No	Número de página. El valor predeterminado es 1.	1
PageSize	integer	No	Artículos por página. El valor predeterminado es 10.	10

Ejemplo JSON:

JSON

{
  "model": "volc-asset",
  "Filter": {
    "Name": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

Ejemplo de cURL:

bash

curl --request POST https://modelflare.dev/volc/asset/ListAssets \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Filter": {
    "Name": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}'

Respuesta

La solicitud tuvo éxito.

Campo	Tipo	Requerido	Descripción	Ejemplo
Items[]	object[]	No	Objetos de activo con identidad, tipo, grupo, estado, proyecto y marcas de tiempo.	{ Id, Name, AssetType, GroupId, Status, ... }
Items[].Id / Name	string	No	Identidad del activo y nombre para mostrar.	asset-20260528140922-d9646 / character-reference
Items[].AssetType / GroupId	string	No	Tipo de activo y grupo propietario.	Image / group-20260320141746-zsf6b
Items[].Status / ProjectName	string	No	Estado de procesamiento y nombre del proyecto.	Active / default
Items[].CreateTime / UpdateTime	string	No	Marcas de tiempo de creación y actualización de ISO 8601.	2026-03-20T14:25:01Z
Items[].URL	string	No	URL del archivo temporal. La vida útil documentada es de 12 horas; utilice asset://<ID> para solicitudes de generación.	https://example.com/temporary-asset
Items[].Error	object	No	Error de procesamiento con Code y Message cuando Status es Failed.	{ Code, Message }
PageNumber	integer	No	Número de página devuelto.	1
PageSize	integer	No	Tamaño de página devuelto.	10
TotalCount	integer	No	Activos totales de contrapartida.	2

Ejemplo de respuesta:

JSON

{
  "Items": [
    {
      "Id": "asset-20260528140922-d9646",
      "Name": "character-reference",
      "AssetType": "Image",
      "GroupId": "group-20260320141746-zsf6b",
      "Status": "Active",
      "ProjectName": "default"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

Errores

Estado	Significado
400	La solicitud no es válida.
401	Falta la clave API o no está autorizada.

Ejemplo del cuerpo del error (cuando se devuelve):

JSON

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

La creación de imágenes, videos y audio es asíncrona. Después de recibir una ID de activo, llame a GetAsset y use la referencia asset://<ID> solo cuando el estado sea Active.