Produção
Documentação da API do Mixanalytic
Referência oficial da API de https://mixanalytic.com. Use esta API para enviar áudio e receber análises de mixagem com IA, com módulos selecionáveis e respostas compactas ou completas.
URL base: https://mixanalytic.com/api
Autenticação
Envie sua chave de API no cabeçalho X-API-Key em todas as solicitações.
curl -X GET "https://mixanalytic.com/api/test-data" \
-H "X-API-Key: YOUR_API_KEY"
- 401 chave ausente ou inválida
- 403 chave de plano gratuito sem acesso à API
- 429 limite de solicitações excedido
Escopos: write serve para envio e análise no Mix Analyzer. content lê dados de pesquisa de conteúdo com dados sensíveis ocultados. content_write salva rascunhos de conteúdo não públicos. Os escopos de conteúdo são exclusivos de administradores.
Endpoints
| Método | Caminho | Finalidade |
|---|---|---|
| GET | /api/test-data | Verificação de conectividade e autenticação. |
| POST | /api/upload | Enviar e analisar arquivo de áudio. |
| GET | /api/analyze/<file_id> | Analisar novamente pelo ID do arquivo (se o arquivo original ainda existir). |
| GET | /api/content/analysis-feed | Feed de pesquisa com dados sensíveis ocultados para agentes de conteúdo, exclusivo de administradores. |
| POST | /api/content/drafts | Endpoint para salvar ou atualizar rascunhos para agentes de conteúdo, exclusivo de administradores. |
| GET | /api/ai-stats?days=30 | Estatísticas de uso da análise de IA. |
Solicitação de envio
POST/api/upload
| Campo | Tipo | Obrigatório | Notas |
|---|---|---|---|
| file | multipart file | Sim | Permitidos: mp3, wav, flac, m4a, aac, ogg. Máx. 100MB. |
| modules | string/list | Não | Se omitido, todos os módulos são usados por padrão. |
| detail_level | string | Não | full (padrão) ou summary. |
Um valor inválido de detail_level retorna 400. Arquivos grandes demais retornam 413.
Seleção de módulos
Controle quais módulos de análise são retornados (e calculados) com modules.
Formatos aceitos:
- String separada por vírgulas: modules=frequency_balance,clarity,mood
- String de array JSON: modules=["frequency_balance","clarity","mood"]
- Chave repetida (consulta/formulário): modules=frequency_balance&modules=clarity
- Todos os módulos: modules=all ou modules=*
| Módulo | Descrição |
|---|---|
| frequency_balance | Pontuação de frequência e equilíbrio em 7 bandas. |
| dynamic_range | Faixa dinâmica, fator de crista, PLR. |
| stereo_field | Métricas de largura, fase e correlação. |
| clarity | Métricas de clareza e definição espectral. |
| harmonic_content | Tonalidade e complexidade harmônica. |
| transients | Dados de ataque, densidade de transientes e impacto dos graves. |
| 3d_spatial | Consistência de altura, profundidade e largura. |
| surround_compatibility | Compatibilidade mono e pontuação de fase. |
| headphone_optimization | Pontuação de otimização da reprodução com fones de ouvido. |
| speaker_optimization | Pontuação de otimização da reprodução com alto-falantes. |
| genre | Classificação de gênero e confiança. |
| voice | Presença vocal e características da voz. |
| instruments | Detecção de instrumentos e informações do arranjo. |
| mood | Perfil de humor com energia e valência. |
| keywords | Palavras-chave e tags semânticas. |
| loudness | Meça LUFS, true peak, clipping e metas de streaming para manter o master alto o bastante sem distorção, picos do codec ou surpresas nas plataformas. |
| noise | Meça ruído de fundo, zumbido de rede, chiado e artefatos para limpar gravações antes de ficarem mais altos, brilhantes e difíceis de esconder na masterização. |
| format_quality | Confira codificação com perdas, corte espectral e profundidade de bits para não masterizar MP3, AAC ou fontes ampliadas e degradadas por engano antes de lançar. |
| reference | Referência |
| visualizations | URLs dos recursos visuais gerados para a análise. |
| ai_insights | Resumo e recomendações gerados por LLM. |
Controle do tamanho da resposta
Use detail_level:
- full (padrão): resposta completa
- summary: resposta compacta para clientes web e móveis
Exemplos
1) Envio e análise completa
curl -X POST "https://mixanalytic.com/api/upload" \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@/path/to/track.mp3"
2) Envio e módulos selecionados
curl -X POST "https://mixanalytic.com/api/upload" \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@/path/to/track.mp3" \
-F "modules=frequency_balance,dynamic_range,genre,mood,keywords"
3) Envio, módulos selecionados e resposta resumida
curl -X POST "https://mixanalytic.com/api/upload" \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@/path/to/track.mp3" \
-F "modules=frequency_balance,stereo_field,clarity,ai_insights" \
-F "detail_level=summary"
4) Endpoint de teste
curl -X GET "https://mixanalytic.com/api/test-data" \
-H "X-API-Key: YOUR_API_KEY"
5) JavaScript do lado do cliente
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('modules', 'frequency_balance,dynamic_range,mood,ai_insights');
formData.append('detail_level', 'summary');
const res = await fetch('https://mixanalytic.com/api/upload', {
method: 'POST',
headers: { 'X-API-Key': 'YOUR_API_KEY' },
body: formData
});
const data = await res.json();
console.log(data.analysis, data.returned_modules);
Metadados padrão da resposta
As respostas de análise bem-sucedidas incluem:
- requested_modules
- returned_modules
- detail_level
- available_modules
Códigos de erro
| Status | Significado | Causa típica |
|---|---|---|
| 400 | Solicitação inválida | Módulo/detail_level inválido, campo de arquivo ausente ou arquivo vazio. |
| 401 | Não autorizado | Chave de API ausente, inválida ou expirada. |
| 403 | Proibido | O nível da conta não permite acesso à API. |
| 404 | Não encontrado | /api/analyze/<file_id> arquivo não está mais disponível (exclusão por privacidade). |
| 413 | Conteúdo grande demais | Arquivo maior que 100MB. |
| 429 | Limite de solicitações excedido | Solicitações demais por minuto, hora ou dia. |
| 500 | Erro do servidor | Falha de análise ou de execução. |
Notas para o frontend
- Para clientes web e móveis, prefira detail_level=summary.
- Solicite apenas os módulos necessários para a primeira renderização para reduzir a latência e o tamanho da resposta.
- Trate 429 e 500 com novas tentativas e intervalos de espera crescentes.
- Não exponha chaves de produção de longa duração em pacotes públicos.