Atualizar um ativo

Disponibilidade

Esta página documenta a rota de gerenciamento de ativos do Modelflare. As chamadas exigem uma chave de API inteligente válida ou uma chave de API de grupo de mídia, um canal de mídia disponível e a permissão necessária.

Nota

O gateway registra IDs de ativos do provedor, status e propriedade do usuário. A biblioteca local Castaly permanece separada do namespace do ativo do provedor.

Ponto final

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

Autenticação

Use uma chave de API Modelflare:

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Envie Idempotency-Key com solicitações de criação, atualização e exclusão. Tentar novamente a mesma chave para o mesmo usuário reproduz a resposta salva sem repetir a mutação.

Solicitação

Atualize o nome de um ativo ou mova-o para outro grupo.

Campo	Tipo	Obrigatório	Descrição	Exemplo
Id	string	Sim	ID do ativo.	asset-20260528140922-d9646
Name	string	Não	Novo nome do ativo.	updated-character-reference
GroupId	string	Não	ID do grupo de destino.	group-20260320141746-zsf6b
model	string	Não	Modelo de cobrança. O padrão é volc-asset.	volc-asset

Exemplo JSON:

JSON

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

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

Resposta

A solicitação foi bem-sucedida.

Campo	Tipo	Obrigatório	Descrição	Exemplo
Id	string	Sim	ID do ativo.	asset-20260528140922-d9646
Name	string	Não	Nome do ativo atualizado.	updated-character-reference
GroupId	string	Não	ID do grupo de ativos.	group-20260320141746-zsf6b
UpdateTime	string	Não	Atualização do carimbo de data/hora.	2026-05-28T06:09:31Z

Exemplo de resposta:

JSON

{
  "Id": "asset-20260528140922-d9646",
  "Name": "updated-character-reference",
  "GroupId": "group-20260320141746-zsf6b",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

Erros

Estado	Significado
400	A solicitação é inválida.
401	A chave API está faltando ou não foi autorizada.

Exemplo de corpo de erro (quando retornado):

JSON

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

A criação de imagem, vídeo e áudio é assíncrona. Após receber um ID de ativo, chame GetAsset e utilize a referência asset://<ID> somente quando o status for Active.