Crie um ativo de áudio

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 faixa de áudio a um grupo existente para fluxos de trabalho Seedance compatíveis.

Campo	Tipo	Obrigatório	Descrição	Exemplo
GroupId	string	Sim	ID do grupo de ativos alvo.	group-20260320141746-zsf6b
AssetType	Audio	Sim	Deve ser Audio.	Audio
URL	string	Sim	URL público, URI de dados ou Base64 bruto. Somente WAV ou MP3, 2–30 segundos, não mais que 15 MB.	https://example.com/audio.mp3
file	binary	Não	Alternativa multiparte para URL com as mesmas restrições de áudio.	audio.mp3
Name	string	Não	Nome de exibição/pesquisa, até 64 caracteres.	background-music
model	string	Sim		volc-asset-audio
ProjectName	string	Não	Nome do projeto. Deve corresponder ao grupo-alvo; o padrão é default.	default

Exemplo JSON:

JSON

{
  "model": "volc-asset-audio",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "background-music",
  "AssetType": "Audio",
  "URL": "https://example.com/audio.mp3",
  "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-audio" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@audio.mp3"

Resposta

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