Actualizar 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/UpdateAsset

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

Actualizar el nombre de un activo o moverlo a otro grupo.

Campo	Tipo	Requerido	Descripción	Ejemplo
Id	string	Sí	ID de activo.	asset-20260528140922-d9646
Name	string	No	Nuevo nombre del activo.	updated-character-reference
GroupId	string	No	ID del grupo de destino.	group-20260320141746-zsf6b
model	string	No	Modelo de facturación. El valor predeterminado es volc-asset.	volc-asset

Ejemplo JSON:

JSON

{
  "model": "volc-asset",
  "Id": "asset-20260528140922-d9646",
  "Name": "updated-character-reference",
  "GroupId": "group-20260320141746-zsf6b"
}

Ejemplo de cURL:

bash

curl --request POST https://modelflare.dev/volc/asset/UpdateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Id": "asset-20260528140922-d9646",
  "Name": "updated-character-reference",
  "GroupId": "group-20260320141746-zsf6b"
}'

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 actualizado.	updated-character-reference
GroupId	string	No	ID del grupo de activos.	group-20260320141746-zsf6b
UpdateTime	string	No	Actualizar marca de tiempo.	2026-05-28T06:09:31Z

Ejemplo de respuesta:

JSON

{
  "Id": "asset-20260528140922-d9646",
  "Name": "updated-character-reference",
  "GroupId": "group-20260320141746-zsf6b",
  "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.