Actualizar un grupo de 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/UpdateAssetGroup

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

Cambiar el nombre de un grupo de activos existente.

Campo	Tipo	Requerido	Descripción	Ejemplo
Id	string	Sí	ID del grupo de activos.	group-20260320141746-zsf6b
Name	string	No	Nuevo nombre del grupo.	updated-project-assets
model	string	No	Modelo de facturación. El valor predeterminado es volc-asset.	volc-asset

Ejemplo JSON:

JSON

{
  "model": "volc-asset",
  "Id": "group-20260320141746-zsf6b",
  "Name": "updated-project-assets"
}

Ejemplo de cURL:

bash

curl --request POST https://modelflare.dev/volc/asset/UpdateAssetGroup \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Id": "group-20260320141746-zsf6b",
  "Name": "updated-project-assets"
}'

Respuesta

La solicitud tuvo éxito.

Campo	Tipo	Requerido	Descripción	Ejemplo
Id	string	Sí	ID del grupo de activos.	group-20260320141746-zsf6b
Name	string	Sí	Nombre del grupo actualizado.	updated-project-assets
UpdateTime	string	No	Actualizar marca de tiempo.	2026-05-28T06:09:31Z

Ejemplo de respuesta:

JSON

{
  "Id": "group-20260320141746-zsf6b",
  "Name": "updated-project-assets",
  "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.