Documentação da API

Obter e armazenar uma chave API

A autenticação deve acontecer no servidor da aplicação. Nunca coloque uma chave de produção no navegador, aplicativo móvel, logs ou repositório público.

1. 1Crie uma conta e abra a área de chaves API no painel.
2. 2Copie a chave e guarde-a no gerenciador de segredos ou ambiente protegido do servidor.
3. 3Envie-a no cabeçalho Authorization como token Bearer e troque-a imediatamente se for exposta.

Início rápido

Crie uma tarefa de música assíncrona, salve o workId retornado e consulte o endpoint feed até concluir. A solicitação funciona após configurar a chave do servidor.

export UDIOAPI_KEY='replace-with-your-server-key'

curl --request POST \
  --url 'https://udioapi.pro/api/v2/generate' \
  --header "Authorization: Bearer $UDIOAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "chirp-v5-5",
    "gpt_description_prompt": "Warm indie pop with acoustic guitar",
    "make_instrumental": true
  }'

# Save workId from the response, then poll:
curl 'https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID'

Os arquivos usam UDIOAPI_KEY, polling limitado e erros estruturados, sem dependências externas. Remova todos os segredos antes de publicar um fork no GitHub.

Endpoints da API

Use /v2/generate como endpoint padrão de Music Generate. MiniMax é um provedor integrado disponível em /v2/minimax/generate, não o modelo padrão de geração de música.

Tratamento de erros

Trate o status HTTP e o corpo estruturado como parte do contrato de integração. Registre o workId e seu ID de solicitação, mas nunca a chave API.

Não repita falhas de moderação ou outros erros finais da tarefa. Exiba fail_message ou error_message para que o usuário possa alterar a entrada.

Resumo das alterações

Alterações da API relevantes para compatibilidade são resumidas aqui e vinculadas ao endpoint afetado.