Introdução ao Produto

O AudioSeal Pixel Studio é uma ferramenta avançada para marca d'água em áudio, desenvolvida com base no algoritmo AudioSeal de código aberto do Meta. Ele permite a inserção discreta de marcas d'água digitais em arquivos de áudio, preservando a qualidade sonora original. Além disso, oferece funcionalidades robustas de detecção, tornando-o uma solução eficaz para proteção de direitos autorais de áudio e identificação de conteúdo gerado por IA.

Exportando Relatórios de Detecção em PDF

Geração de Relatórios

Após a conclusão da análise de áudio na interface de detecção, o sistema exibirá automaticamente os resultados. O relatório gerado inclui informações cruciais como:

• Probabilidade de detecção da marca d'água (escala de 0 a 1).
• Análise da cobertura da marca d'água.
• Mensagem da marca d'água extraída (se aplicável).
• Informações básicas do arquivo de áudio analisado.

Processo de Exportação para PDF

1. Localize o botão "Exportar Relatório" na página de resultados da detecção.
2. Selecione a opção "Formato PDF".
3. O sistema gerará um arquivo PDF contendo todos os dados da detecção.
4. O nome do arquivo seguirá o padrão: Relatorio_Deteccao_AAAA-MM-DD_HH-MM-SS.pdf.

Estrutura Típica do Relatório:

• Cabeçalho: Logo do AudioSeal Pixel Studio e título do relatório.
• Corpo: Tabela com os resultados da detecção e gráficos ilustrativos.
• Rodapé: Timestamp da detecção e informações do sistema.

Integração via API

Configuração Inicial da API

O AudioSeal Pixel Studio disponibiliza interfaces RESTful para integração automatizada:

import requests

# Substitua pelo endereço da sua instância
ENDERECO_API = "http://seu-endereco-instancia/api/v1"
CHAVE_API = "sua_chave_api_aqui"

cabecalhos = {
   "Authorization": f"Bearer {CHAVE_API}",
   "Content-Type": "application/json"
}
 

Endpoints Principais da API

API para Inserção de Marca d'Água

def inserir_marca_dagua(caminho_arquivo_audio, mensagem=None):
   """Insere uma marca d'água em um arquivo de áudio."""
   url = f"{ENDERECO_API}/embed"
   arquivos = {'file': open(caminho_arquivo_audio, 'rb')}
   dados = {'message': mensagem} if mensagem else {}
   
   resposta = requests.post(url, files=arquivos, data=dados, headers=cabecalhos)
   return resposta.json()
 

API para Detecção de Marca d'Água

def detectar_marca_dagua(caminho_arquivo_audio):
   """Detecta a presença de uma marca d'água em um arquivo de áudio."""
   url = f"{ENDERECO_API}/detect"
   arquivos = {'file': open(caminho_arquivo_audio, 'rb')}
   
   resposta = requests.post(url, files=arquivos, headers=cabecalhos)
   return resposta.json()
 

API para Geração de Relatórios

def gerar_relatorio(id_deteccao, formato="pdf"):
   """Gera um relatório de detecção em formato especificado."""
   url = f"{ENDERECO_API}/report"
   dados = {
       "detection_id": id_deteccao,
       "format": formato
   }
   
   resposta = requests.post(url, json=dados, headers=cabecalhos)
   # Retorna o conteúdo binário do arquivo gerado
   return resposta.content 
 

Exemplo de Resposta da API (Detecção)

{
   "status": "success",
   "data": {
       "detection_probability": 0.87,
       "message": "1A2B3C4D5E6F7G8H",
       "coverage": 0.92,
       "audio_info": {
           "duration": 125.4,
           "format": "mp3",
           "sample_rate": 44100
       }
   }
}
 

Solução de Problemas Comuns

Problemas com Exportação de PDF

• Relatório incompleto: Verifique se pop-ups estão permitidos no navegador, se há espaço de armazenamento suficiente e tente regenerar o relatório.
• Arquivo PDF não abre: Utilize um leitor de PDF atualizado, tente exportar novamente ou contate o suporte técnico.

Problemas de Integração API

• Erro 401 (Não Autorizado): Confirme a validade da sua chave de API, a correta formatação do cabeçalho Authorization e se a chave não expirou.
• Falha no upload de áudio: Certifique-se de que o tamanho do arquivo não excede o limite (padrão de 50MB), que o formato é suportado (WAV, MP3, M4A, FLAC) e verifique a estabilidade da conexão de rede.

O AudioSeal Pixel Studio oferece funcionalidades completas para exportação de relatórios e uma API flexível, atendendo desde o uso manual até a automação avançada. Este guia cobriu a geração e exportação de relatórios em PDF, a automação de inserção e detecção de marcas d'água via API, e a resolução de probelmas comuns.