Crie um ativo de imagem

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

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

Adicione uma imagem a um grupo existente. Após o processamento, referencie-o como asset://<ID> em uma solicitação Seedance compatível.

Campo	Tipo	Obrigatório	Descrição	Exemplo
GroupId	string	Sim	ID do grupo de ativos alvo.	group-20260320141746-zsf6b
AssetType	Image	Sim	Deve ser Image.	Image
URL	string	Sim	URL público, URI de dados ou Base64 bruto. As imagens devem ter menos de 30 MB, 300–6000 px em cada lado e ter uma proporção de 0,4–2,5.	https://example.com/image.jpg
file	binary	Não	Alternativa multiparte para URL. JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC e HEIF são aceitos.	image.jpg
Name	string	Não	Nome de exibição/pesquisa, até 64 caracteres. Não é enviado para o modelo.	character-reference
model	string	Não		volc-asset
ProjectName	string	Não	Nome do projeto. Deve corresponder ao grupo-alvo; o padrão é default.	default

Exemplo JSON:

JSON

{
  "model": "volc-asset",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "character-reference",
  "AssetType": "Image",
  "URL": "https://example.com/image.jpg"
}

exemplo multipart/form-data:

bash

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@image.jpg"

Resposta

A imagem entrou em processamento assíncrono. Pesquise GetAsset até que Status seja Active ou Failed. Não há SLA de tempo de upload; uma imagem típica leva cerca de 6 a 9 segundos, enquanto uma fila de revisão ocupada pode levar cerca de 10 segundos a 2 minutos.

Campo	Tipo	Obrigatório	Descrição	Exemplo
Id	string	Sim	ID do ativo. Use asset://<ID> somente depois que o status for Active.	asset-20260528140922-d9646

Exemplo de resposta:

JSON

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

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.