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

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

Leia um ativo por ID. Use esta rota para pesquisar um upload assíncrono até que Status seja Active ou Failed.

Campo	Tipo	Obrigatório	Descrição	Exemplo
Id	string	Sim	ID do ativo a ser consultado.	asset-20260528140922-d9646

Exemplo JSON:

JSON

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

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

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.	character-reference
URL	string	Não	URL do arquivo temporário. A vida útil documentada é de 12 horas; não persista como referência de geração.	https://example.com/temporary-asset
AssetType	Image	Video	Audio	Não
GroupId	string	Não	ID do grupo proprietário.	group-20260320141746-zsf6b
Status	Processing	Active	Failed	Não
ProjectName	string	Não	Nome do projeto.	default
CreateTime / UpdateTime	string	Não	Carimbos de data e hora ISO 8601.	2026-05-28T06:09:31Z

Exemplo de resposta:

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

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.