POST https://api.acedata.cloud/suno/projects é a interface Beta para gerenciar projetos multifaixa. Use action para distinguir entre criar, salvar, gerar candidatos, submeter candidatos e exportar.
retrieve, cada operação requer Idempotency-Key. A mesma chave com a mesma requisição apenas retorna o resultado original; a mesma chave com uma requisição diferente retorna 409. Quando uma geração cobrada encontrar um timeout de rede ou o resultado da submissão for incerto, primeiro consulte usando o ID da tarefa original ou a mesma chave de idempotência; não troque diretamente a chave para reenviar.
Identificadores e unidades de tempo
start_seconds / end_seconds são segundos dentro do áudio de origem; start_beats / end_beats são batidas na linha do tempo do projeto. state.timing.bps é o número de batidas por segundo, com padrão 2. Por exemplo, um clipe de 41 segundos que começa na batida 0 terá como ponto final padrão a batida 82. O intervalo de segundos de generate_track é usado para especificar a referência de geração e não garante que o candidato tenha apenas a duração desse intervalo.
Fluxo de operações
Se for feita apenas uma substituição local, basta haver um áudio de origem utilizável, não sendo necessário executar
render primeiro; se o áudio de origem já estiver no projeto, também é possível pular upload e add_track. render_audio_id é apenas a referência obrigatória de generate_track.
Ao submeter uma operação assíncrona, primeiro é retornado { "task_id": "...", "trace_id": "..." }, o que não significa que a geração foi bem-sucedida. Consulte periodicamente:
finished_at e o response.success contido nela é true; quando response.success=false, leia response.error. Embora save possa incluir task_id, ele é concluído de forma síncrona nesta interface. upload, render, generate_track e replace_section não modificam a versão do projeto; após o sucesso de save, add_track, commit_candidate e remove_track, deve-se obter o novo version_id.
Convenções de requisição
Os exemplos a seguir demonstram de forma encadeada a transmissão de IDs e versões entre as operações. As respostas listam apenas os campos relacionados à etapa atual; durante a integração, substitua os IDs de exemplo pelos valores de resposta da aplicação atual.

