Obtener un activo

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/GetAsset

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

Leer un activo por ID. Utilice esta ruta para sondear una carga asincrónica hasta que Status sea Active o Failed.

Campo	Tipo	Requerido	Descripción	Ejemplo
Id	string	Sí	ID del activo a consultar.	asset-20260528140922-d9646

Ejemplo JSON:

JSON

{
  "Id": "asset-20260528140922-d9646"
}

Ejemplo de cURL:

bash

curl --request POST https://modelflare.dev/volc/asset/GetAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Id": "asset-20260528140922-d9646"
}'

Respuesta

La solicitud tuvo éxito.

Campo	Tipo	Requerido	Descripción	Ejemplo
Id	string	Sí	ID de activo.	asset-20260528140922-d9646
Name	string	No	Nombre del activo.	character-reference
URL	string	No	URL del archivo temporal. La vida útil documentada es de 12 horas; no lo conserve como referencia de generación.	https://example.com/temporary-asset
AssetType	Image	Video	Audio	No
GroupId	string	No	ID del grupo propietario.	group-20260320141746-zsf6b
Status	Processing	Active	Failed	No
ProjectName	string	No	Nombre del proyecto.	default
CreateTime / UpdateTime	string	No	Marcas de tiempo ISO 8601.	2026-05-28T06:09:31Z

Ejemplo de respuesta:

JSON

{
  "Id": "asset-20260528140922-d9646",
  "Name": "character-reference",
  "AssetType": "Image",
  "GroupId": "group-20260320141746-zsf6b",
  "Status": "Active",
  "ProjectName": "default",
  "CreateTime": "2026-05-28T06:09:22Z",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

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.