LogoAI Music API
Iniciar sesión

Endpoint del modelo · POST /v2/extend

Extend Song API

Continúa una generación completada más allá de su final original. Hereda los ajustes de la pista de origen o dirige la continuación con tu propio prompt, estilo y título — todo por un único endpoint REST asíncrono.

Facturado al precio del modelo de la pista original

Extiende una canción sin rehacerla

La Extend Song API continúa una pista que ya generaste. Apúntala a la generación terminada con origin_task_id, elige cuál de los dos audios devueltos continuar con extend_audio_index, y la plataforma compone un nuevo segmento que retoma donde la fuente termina.

Dos modos cubren los flujos habituales. El modo heredado (custom_mode: false) reutiliza los parámetros originales — la forma más rápida de alargar una toma que ya te gusta. El modo personalizado (custom_mode: true) acepta nuevo prompt, estilo, título y extensionStartTime para redirigir el arreglo — por ejemplo, convertir un estribillo enérgico en un outro tranquilo.

Quickstart: extiende y consulta

Haz POST a /v2/extend con la tarea de origen, luego consulta /v2/feed?workId=... o define callback_url para un 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"

extensionStartTime es opcional; los valores se ajustan al rango de 1 … (duración de la fuente − 1) segundos, usando por defecto el final de la pista original.

Parámetros de la solicitud de extensión

Las extensiones se facturan al precio del modelo de la pista original. Las pistas creadas con chirp-v5 o chirp-v5-5 se extienden con chirp-v6; las de modelos antiguos con chirp-v6-mini.

ParámetroTipoObligatorioNotas
origin_task_idstringobligatoriotask_id de tu solicitud de generación original
extend_audio_indexnumberobligatorioQué audio devuelto extender: 0 o 1
custom_modebooleanopcionalfalse hereda los parámetros de la fuente (por defecto); true activa campos personalizados
promptstringmodo personalizadoNueva letra o descripción, ≤ 5000 caracteres — se trunca
stylestringopcionalEstilo de la continuación, ≤ 1000 caracteres — truncado
titlestringopcionalTítulo de la pista extendida, ≤ 80 caracteres — truncado
extensionStartTimenumberopcionalPunto inicial en segundos; ajustado a 1 … (duración de la fuente − 1)
callback_urlstringopcionalWebhook HTTPS público para el resultado final

Una extensión rechazada o fallida se reembolsa automáticamente — las respuestas 422 explican el parámetro a corregir, y los fallos tras la aceptación aparecen como FAILED en el feed con créditos devueltos.

Qué puedes construir

Las extensiones se combinan con el resto de la API de audio.

Arreglos más largos

Encadena extensiones para construir intros, versos y outros más allá de la duración original.

Leer la documentación

Redirige el final

El modo personalizado permite que un nuevo prompt y estilo orienten hacia dónde va la continuación.

Leer la documentación

Genera la fuente primero

Usa /v2/generate para crear la pista que quieres extender — la familia chirp-v6 funciona en ambos endpoints.

Leer la documentación

Cover de tu propio audio

¿Prefieres partir de una subida? El endpoint upload-cover gestiona ese flujo.

Leer la documentación

Letras con marcas de tiempo

Obtén los tiempos de cada línea de la letra en el resultado extendido.

Leer la documentación

Callbacks y polling

Recoge la finalización vía polling en /v2/feed o un webhook con callback_url.

Leer la documentación

Cómo funciona

De una generación completada a una pista más larga en cuatro pasos.

  1. 1

    Genera una pista de origen

    Crea una canción con /v2/generate y espera el SUCCESS. Guarda el task_id y elige un índice de audio.

  2. 2

    Envía la extensión

    Haz POST a /v2/extend con origin_task_id, extend_audio_index y campos personalizados opcionales.

  3. 3

    Consulta o recibe un callback

    Llama a GET /v2/feed?workId=... cada 5–10 segundos, o define callback_url para un webhook.

  4. 4

    Descarga el audio

    Con estado SUCCESS, el feed contiene las URL del audio extendido — guárdalas en tu propio almacenamiento.

Paga el precio del modelo original

Las extensiones se facturan por solicitud al precio del modelo de la pista original — unos $0.12 para una pista servida por chirp-v6 y $0.10 para chirp-v6-mini, con 1 USD = 100 créditos.

Las extensiones rechazadas (422) o fallidas se reembolsan automáticamente. Los créditos prepagados nunca caducan.

Límites y notas

  • Necesitas una tarea de origen completada y debes elegir extend_audio_index 0 o 1 — la mayoría de las generaciones devuelven dos audios.
  • Las extensiones heredan el precio del modelo de origen; las pistas chirp-v5/chirp-v5-5 se extienden con chirp-v6, las antiguas con chirp-v6-mini.
  • Los valores demasiado largos de prompt, style y title se truncan, no se rechazan.
  • extensionStartTime se ajusta al rango válido en lugar de fallar la solicitud.
  • Las URL de audio son temporales: descarga los resultados a tu propio almacenamiento.

udioapi.pro es un servicio independiente de terceros. No está afiliado, respaldado ni operado por Suno, Udio o MiniMax.

Preguntas frecuentes sobre Extend Song API

Respuestas sobre modos, facturación y el flujo asíncrono.

¿Qué hace la Extend Song API?

Continúa una generación completada más allá de su final. El modo heredado reutiliza los parámetros de la fuente; el modo personalizado acepta nuevo prompt, estilo, título y extensionStartTime.

¿Cómo se factura una extensión?

Al precio del modelo de la pista original, por solicitud. Extender una pista servida por chirp-v6 cuesta los mismos 12 créditos; chirp-v6-mini cuesta 10. Las extensiones rechazadas o fallidas se reembolsan automáticamente.

¿Qué audio debo extender?

Define extend_audio_index en 0 para el primer audio devuelto o 1 para el segundo — la mayoría de las generaciones producen dos variaciones.

¿Modo heredado o personalizado?

El modo heredado (custom_mode: false) continúa con los parámetros originales. El modo personalizado (custom_mode: true) permite que nuevo prompt, estilo y título orienten la continuación.

¿Y si mi extensionStartTime está fuera de rango?

El valor se ajusta al rango de 1 … (duración de la fuente − 1) segundos en lugar de fallar; un valor ausente o inválido extiende desde el final de la pista original.

¿Las extensiones fallidas cuestan créditos?

No. Las solicitudes rechazadas en validación devuelven 422, y las tareas que fallan tras la aceptación aparecen como FAILED en el feed — los créditos se reembolsan en ambos casos.

Sigue explorando