Crie um ativo de vídeo

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 um vídeo a um grupo existente. O ID retornado pode ser usado por fluxos de trabalho Seedance compatíveis após o processamento.

Campo	Tipo	Obrigatório	Descrição	Exemplo
GroupId	string	Sim	ID do grupo de ativos alvo.	group-20260320141746-zsf6b
AssetType	Video	Sim	Deve ser Video.	Video
URL	string	Sim	URL do vídeo público. Vídeo Base64 não é aceito. Use MP4 ou MOV, 2–30 segundos, 24–60 FPS, 300–6000 px em cada lado, proporção de 0,4–2,5, 480p/720p/1080p/4K, 407696–2086876 pixels totais e não mais que 200 MB.	https://example.com/video.mp4
file	binary	Não	Alternativa multiparte para URL com as mesmas restrições de vídeo.	video.mp4
Name	string	Não	Nome de exibição/pesquisa, até 64 caracteres.	scene-clip
model	string	Sim		volc-asset-video
ProjectName	string	Não	Nome do projeto. Deve corresponder ao grupo-alvo; o padrão é default.	default

Exemplo JSON:

JSON

{
  "model": "volc-asset-video",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "scene-clip",
  "AssetType": "Video",
  "URL": "https://example.com/video.mp4",
  "ProjectName": "default"
}

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-video" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@video.mp4"

Resposta

O vídeo entrou em processamento assíncrono. Pesquise GetAsset até que Status seja Active ou Failed. Não há SLA de tempo de upload; um vídeo típico leva cerca de 9 a 12 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.