LogoAI Music API
Entrar
APIRegistro de alterações (2/9)

Atualizações para desenvolvedores

Registro de alterações da API

Acompanhe recursos publicados da API, notas de compatibilidade e ações necessárias para sua integração.

Atualização mais recente

5 de nov. de 2026

Histórico de versões

7 atualizações
  1. Adicionado
    Compatível com versões anterioresPOST /v2/replace-sectionAll models

    Novo: a substituição de trecho gera novamente uma parte da música

    POST /v2/replace-section gera novamente uma janela de tempo de uma música criada com /v2/generate ou /v2/extend e retorna a música completa com esse trecho refeito.

    O que mudou

    • A janela deve ter pelo menos 10 segundos, no máximo 50% da música e 480 segundos, e terminar antes do fim da música. Janelas inválidas são rejeitadas antes de qualquer cobrança de créditos.
    • Cerca de 10 segundos de cada lado da janela também são renderizados novamente para que o novo trecho se encaixe; o restante da música não muda.
    • Quando lyrics é omitido, a letra cantada dentro da janela é preenchida automaticamente.
    • Resultados cuja duração difere da original em mais de 15 segundos são descartados. Se não sobrar nenhum, a tarefa fica como FAILED e é reembolsada.
    • 5 créditos por solicitação; solicitações rejeitadas e tarefas que falham são reembolsadas automaticamente.

    Impacto na integração

    Nenhuma alteração é necessária nas integrações existentes. Envie origin_task_id, audio_id, infill_start_s, infill_end_s e prompt para começar a usar.

    Ver documentação do endpoint
  2. Alterado
    Compatível com versões anterioresPOST /v2/generate · /v2/extend · /v2/upload-cover/generateAll models

    Solicitações rejeitadas retornam 422 ou 500 e são reembolsadas imediatamente

    Os endpoints de criação agora informam rejeições de validação de forma síncrona e reembolsam os créditos, em vez de retornar 200 com uma tarefa que nunca termina.

    O que mudou

    • 422 significa que um parâmetro foi rejeitado na validação; a mensagem indica o campo a corrigir (por exemplo title ou extensionStartTime).
    • 500 significa uma falha temporária; tente novamente mais tarde.
    • Ambas as respostas incluem data.task_id, data.refunded e workId, e a tarefa é marcada como FAILED.
    • Tarefas que falham após serem aceitas, incluindo extensões, são marcadas como FAILED com fail_message e têm os créditos reembolsados automaticamente.
    • Antes, essas solicitações retornavam 200 e a tarefa permanecia IN_PROGRESS indefinidamente.

    Impacto na integração

    Em 422 corrija o parâmetro indicado; em 500 tente novamente mais tarde. Ambas as respostas incluem data.refunded.

    Ver documentação do endpoint
  3. Alterado
    Compatível com versões anterioresPOST /v2/extendAll models

    Solicitações extend normalizam texto e tempo inicial em vez de falhar

    POST /v2/extend agora trunca textos longos do Custom Mode e limita extensionStartTime, de modo que esses campos não causam mais rejeição.

    O que mudou

    • title é limitado a 80 caracteres; valores maiores são truncados.
    • prompt é limitado a 5000 caracteres e style a 1000; valores maiores são truncados.
    • extensionStartTime é limitado a 1 … (duração da origem - 1) segundos; valores ausentes ou inválidos usam o fim da faixa original.
    • Extensões são cobradas pelo preço do modelo da faixa original e produzidas por chirp-v6 (faixas chirp-v5 / chirp-v5-5) ou chirp-v6-mini (faixas legadas mais antigas).

    Impacto na integração

    Esta atualização é retrocompatível. Mantenha title com até 80 caracteres para evitar truncamento.

    Ver documentação do endpoint
  4. Alterado
    Compatível com versões anterioresPOST /v2/generate · /v2/extend · /v2/upload-cover/generatechirp-v3-5 … chirp-v5-5

    Identificadores legados chirp-v3-5 a chirp-v5-5 são atendidos pela família chirp-v6

    Solicitações que ainda enviam um identificador de modelo descontinuado continuam funcionando e mantêm o preço histórico.

    O que mudou

    • chirp-v5 e chirp-v5-5 (12 créditos) são atendidos por chirp-v6.
    • chirp-v3-5, chirp-v4-0, chirp-v4-5, chirp-v4-5-plus e chirp-v4-5-all são atendidos por chirp-v6-mini.
    • Cada identificador legado continua cobrado pelo preço histórico (5, 8, 10 ou 12 créditos).
    • model_name nos resultados de status, feed e callback agora sempre informa o modelo público que produziu o áudio, por exemplo chirp-v6-mini.
    • Quando o campo model é omitido, a solicitação é cobrada no nível básico de 5 créditos e atendida por chirp-v6-mini.

    Impacto na integração

    Nenhuma alteração é necessária. Atualize o campo model para chirp-v6 ou chirp-v6-mini quando for conveniente.

    Ver documentação do endpoint
  5. Adicionado
    Compatível com versões anterioresPOST /v2/generate · /v2/upload-cover/generatechirp-v6 · chirp-v6-mini · chirp-v6-wild

    Modelos chirp-v6, chirp-v6-mini e chirp-v6-wild

    A linha atual de modelos passa a ser a família chirp-v6, disponível em generate, upload-cover e extend.

    O que mudou

    • chirp-v6 é o modelo principal, chirp-v6-mini é o nível rápido e econômico, chirp-v6-wild é a variante mais experimental.
    • chirp-v6 e chirp-v6-wild custam 12 créditos por solicitação, chirp-v6-mini custa 10.
    • Os limites de texto são iguais para todos os modelos: prompt personalizado 5000, prompt de inspiração 3000, style 1000, title 80 (100 no upload-cover). Entradas longas são truncadas, não rejeitadas.
    • Extensões de uma faixa chirp-v6 usam o mesmo modelo; o campo duration é encaminhado em solicitações generate no Custom Mode.

    Impacto na integração

    Esta atualização é retrocompatível. Migre novas integrações para chirp-v6-mini ou chirp-v6.

    Ver documentação do endpoint
  6. Adicionado
    Compatível com versões anterioresPOST /v2/generate · /v2/upload-cover/generatechirp-v6 family

    Image to Music com image_urls

    POST /v2/generate e POST /v2/upload-cover/generate agora aceitam imagens de referência que moldam o clima da faixa gerada.

    O que mudou

    • Envie image_urls como um array com até 5 URLs de imagem acessíveis publicamente.
    • JPEG, JPG, PNG e WEBP são suportados, até 10MB por imagem.
    • As imagens valem apenas no modo Inspiração (generate) e no modo não personalizado (upload-cover); no Custom Mode são ignoradas silenciosamente.
    • A entrada de imagens adiciona 1 crédito por solicitação ao preço do modelo.
    • O prompt de texto é opcional quando há imagens; combine ambos para direcionar o resultado.

    Impacto na integração

    Esta atualização é retrocompatível. Adicione image_urls apenas quando quiser que as imagens influenciem o resultado.

    Ver documentação do endpoint
  7. Adicionado
    Compatível com versões anterioresPOST /v2/generatechirp-v5-5

    Duração personalizada para chirp-v5-5

    Solicitações no modo personalizado com chirp-v5-5 agora podem definir a duração desejada da faixa.

    O que mudou

    • O campo duration está disponível apenas para chirp-v5-5 no modo personalizado.
    • Envie um número de 10 a 360 segundos.
    • Valores ausentes ou inválidos usam 20 segundos.
    • Outros modelos e o modo Inspiração ignoram este campo.

    Impacto na integração

    Esta atualização é compatível com versões anteriores. As solicitações existentes continuam funcionando sem alterações.

    Ver documentação do endpoint