LogoAI Music API
Entrar

Endpoint do modelo · POST /v2/extend

Extend Song API

Continue uma geração concluída além do seu final original. Herde as configurações da faixa de origem ou direcione a continuação com seu próprio prompt, estilo e título — tudo por um único endpoint REST assíncrono.

Cobrado pelo preço do modelo da faixa original

Estenda uma música sem refazê-la

A Extend Song API dá continuidade a uma faixa que você já gerou. Aponte para a geração concluída com origin_task_id, escolha qual dos dois áudios retornados continuar com extend_audio_index, e a plataforma compõe um novo trecho que retoma de onde a fonte termina.

Dois modos cobrem os fluxos comuns. O modo herdado (custom_mode: false) reutiliza os parâmetros originais — o jeito mais rápido de alongar uma tomada que você já gostou. O modo personalizado (custom_mode: true) aceita novo prompt, estilo, título e extensionStartTime para redirecionar o arranjo — por exemplo, transformar um refrão energético em um outro tranquilo.

Quickstart: estenda e consulte

Faça POST em /v2/extend com a tarefa de origem, depois consulte /v2/feed?workId=... ou defina callback_url para um webhook.

curl
curl -X POST "https://udioapi.pro/api/v2/extend" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "origin_task_id": "gen20e094aeaadfe494ea33a5c80ee596083bksv",
    "extend_audio_index": 0,
    "custom_mode": true,
    "prompt": "Change the music style to be calm and lyrical.",
    "style": "lyrical"
  }'

curl -X GET "https://udioapi.pro/api/v2/feed?workId=YOUR_WORK_ID"

O extensionStartTime é opcional; valores são limitados ao intervalo de 1 … (duração da fonte − 1) segundos, usando por padrão o fim da faixa original.

Parâmetros da requisição de extensão

Extensões são cobradas pelo preço do modelo da faixa original. Faixas criadas com chirp-v5 ou chirp-v5-5 são estendidas com chirp-v6; faixas de modelos antigos são estendidas com chirp-v6-mini.

ParâmetroTipoObrigatórioObservações
origin_task_idstringobrigatóriotask_id da sua requisição de geração original
extend_audio_indexnumberobrigatórioQual áudio retornado estender: 0 ou 1
custom_modebooleanopcionalfalse herda os parâmetros da fonte (padrão); true ativa campos personalizados
promptstringmodo personalizadoNova letra ou descrição, ≤ 5000 caracteres — valores maiores são truncados
stylestringopcionalEstilo da continuação, ≤ 1000 caracteres — truncado
titlestringopcionalTítulo da faixa estendida, ≤ 80 caracteres — truncado
extensionStartTimenumberopcionalPonto inicial em segundos; limitado a 1 … (duração da fonte − 1)
callback_urlstringopcionalWebhook HTTPS público para o resultado final

Uma extensão rejeitada ou com falha é reembolsada automaticamente — respostas 422 explicam o parâmetro a corrigir, e falhas após aceitação aparecem como FAILED no feed com créditos devolvidos.

O que você pode criar

Extensões combinam com o restante da API de áudio.

Arranjos mais longos

Encadeie extensões para construir intros, versos e outros além da duração original.

Ler a documentação

Redirecione o final

O modo personalizado permite que um novo prompt e estilo orientem para onde a continuação vai.

Ler a documentação

Gere a fonte primeiro

Use /v2/generate para criar a faixa que você quer estender — a família chirp-v6 funciona nos dois endpoints.

Ler a documentação

Cover do seu próprio áudio

Prefere começar de um upload? O endpoint upload-cover cuida desse fluxo.

Ler a documentação

Letras com marcação de tempo

Obtenha os tempos de cada linha da letra no resultado estendido.

Ler a documentação

Callbacks e polling

Receba a conclusão via polling em /v2/feed ou webhook com callback_url.

Ler a documentação

Como funciona

De uma geração concluída a uma faixa mais longa em quatro passos.

  1. 1

    Gere uma faixa de origem

    Crie uma música com /v2/generate e aguarde o SUCCESS. Guarde o task_id e escolha um índice de áudio.

  2. 2

    Envie a extensão

    Faça POST em /v2/extend com origin_task_id, extend_audio_index e campos personalizados opcionais.

  3. 3

    Consulte ou receba um callback

    Chame GET /v2/feed?workId=... a cada 5–10 segundos, ou defina callback_url para um webhook.

  4. 4

    Baixe o áudio

    Com status SUCCESS, o feed contém as URLs do áudio estendido — salve-as no seu próprio armazenamento.

Pague o preço do modelo original

Extensões são cobradas por requisição pelo preço do modelo da faixa original — cerca de $0.12 para uma faixa atendida por chirp-v6 e $0.10 para chirp-v6-mini, com 1 USD = 100 créditos.

Extensões rejeitadas (422) ou com falha são reembolsadas automaticamente. Créditos pré-pagos nunca expiram.

Limites e observações

  • Você precisa de uma tarefa de origem concluída e deve escolher extend_audio_index 0 ou 1 — a maioria das gerações retorna dois áudios.
  • Extensões herdam o preço do modelo de origem; faixas chirp-v5/chirp-v5-5 são estendidas pelo chirp-v6, faixas antigas pelo chirp-v6-mini.
  • Valores longos demais de prompt, style e title são truncados, não rejeitados.
  • O extensionStartTime é ajustado ao intervalo válido em vez de falhar a requisição.
  • As URLs de áudio são temporárias — baixe os resultados para o seu próprio armazenamento.

udioapi.pro é um serviço independente de terceiros. Não é afiliado, endossado nem operado pela Suno, Udio ou MiniMax.

Perguntas frequentes sobre a Extend Song API

Respostas sobre modos, cobrança e o fluxo assíncrono.

O que a Extend Song API faz?

Ela continua uma geração concluída além do seu final. O modo herdado reutiliza os parâmetros da fonte; o modo personalizado aceita novo prompt, estilo, título e extensionStartTime.

Como uma extensão é cobrada?

Pelo preço do modelo da faixa original, por requisição. Estender uma faixa atendida por chirp-v6 custa os mesmos 12 créditos; chirp-v6-mini custa 10. Extensões rejeitadas ou com falha são reembolsadas automaticamente.

Qual áudio devo estender?

Defina extend_audio_index como 0 para o primeiro áudio retornado ou 1 para o segundo — a maioria das gerações produz duas variações.

Modo herdado ou personalizado?

O modo herdado (custom_mode: false) continua com os parâmetros originais. O modo personalizado (custom_mode: true) permite que novo prompt, estilo e título orientem a continuação.

E se meu extensionStartTime estiver fora do intervalo?

O valor é ajustado ao intervalo de 1 … (duração da fonte − 1) segundos em vez de falhar; um valor ausente ou inválido estende a partir do fim da faixa original.

Extensões com falha custam créditos?

Não. Requisições rejeitadas na validação retornam 422, e tarefas que falham após aceitação aparecem como FAILED no feed — os créditos são reembolsados nos dois casos.

Continue explorando