LogoAI Music API
Se connecter

Endpoint du modèle · POST /v2/extend

Extend Song API

Continuez une génération terminée au-delà de sa fin d'origine. Héritez les réglages de la piste source ou orientez la continuation avec votre propre prompt, style et titre — le tout via un seul endpoint REST asynchrone.

Facturé au prix du modèle de la piste originale

Prolonger une chanson sans la refaire

La Extend Song API poursuit une piste déjà générée. Pointez-la vers la génération terminée avec origin_task_id, choisissez lequel des deux audios retournés continuer avec extend_audio_index, et la plateforme compose un nouveau segment qui reprend là où la source s'arrête.

Deux modes couvrent les usages courants. Le mode hérité (custom_mode: false) réutilise les paramètres d'origine — le moyen le plus rapide d'allonger une prise qui vous plaît. Le mode personnalisé (custom_mode: true) accepte un nouveau prompt, style, titre et extensionStartTime pour réorienter l'arrangement — par exemple transformer un refrain énergique en un outro calme.

Quickstart : prolonger puis interroger

POST /v2/extend avec la tâche source, puis interrogez /v2/feed?workId=... ou définissez callback_url pour 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 est optionnel ; les valeurs sont bornées à 1 … (durée de la source − 1) secondes, par défaut la fin de la piste source.

Paramètres de la requête d'extension

Les extensions sont facturées au prix du modèle de la piste originale. Les pistes créées avec chirp-v5 ou chirp-v5-5 sont prolongées par chirp-v6 ; celles de modèles legacy par chirp-v6-mini.

ParamètreTypeRequisRemarques
origin_task_idstringrequistask_id de votre requête de génération d'origine
extend_audio_indexnumberrequisQuel audio retourné prolonger : 0 ou 1
custom_modebooleanoptionnelfalse hérite les paramètres source (défaut) ; true active les champs personnalisés
promptstringmode personnaliséNouvelles paroles ou description, ≤ 5000 caractères — tronqué
stylestringoptionnelStyle de la continuation, ≤ 1000 caractères — tronqué
titlestringoptionnelTitre de la piste prolongée, ≤ 80 caractères — tronqué
extensionStartTimenumberoptionnelPoint de départ en secondes ; borné à 1 … (durée source − 1)
callback_urlstringoptionnelWebhook HTTPS public pour le résultat final

Une extension rejetée ou échouée est remboursée automatiquement — les réponses 422 indiquent le paramètre à corriger, et les échecs après acceptation apparaissent en FAILED dans le feed avec crédits restitués.

Ce que vous pouvez construire

Les extensions se combinent au reste de l'API audio.

Arrangements plus longs

Enchaînez les extensions pour construire intros, couplets et outros au-delà de la durée d'origine.

Lire la doc

Réorienter la fin

Le mode personnalisé laisse un nouveau prompt et style guider la direction de la continuation.

Lire la doc

Générer la source d'abord

Utilisez /v2/generate pour créer la piste à prolonger — la famille chirp-v6 fonctionne sur les deux endpoints.

Lire la doc

Cover de votre propre audio

Vous préférez partir d'un téléversement ? L'endpoint upload-cover gère ce flux.

Lire la doc

Paroles horodatées

Récupérez les timings ligne par ligne du résultat prolongé.

Lire la doc

Callbacks et polling

Récupérez la fin via le polling /v2/feed ou un webhook callback_url.

Lire la doc

Comment ça marche

D'une génération terminée à une piste plus longue en quatre étapes.

  1. 1

    Générer la piste source

    Créez une chanson avec /v2/generate et attendez SUCCESS. Conservez le task_id et choisissez un index audio.

  2. 2

    Envoyer l'extension

    POST vers /v2/extend avec origin_task_id, extend_audio_index et les champs personnalisés optionnels.

  3. 3

    Poller ou recevoir un callback

    Appelez GET /v2/feed?workId=... toutes les 5–10 secondes, ou définissez callback_url pour un webhook.

  4. 4

    Télécharger l'audio

    Au statut SUCCESS, le feed contient les URL audio de l'extension — persistez-les sur votre stockage.

Payez le prix du modèle original

Les extensions sont facturées par requête au prix du modèle de la piste originale — environ $0.12 pour une piste servie par chirp-v6 et $0.10 pour chirp-v6-mini, à 1 USD = 100 crédits.

Les extensions rejetées (422) ou échouées sont remboursées automatiquement. Les crédits prépayés n'expirent jamais.

Limites et remarques

  • Il faut une tâche source terminée et choisir extend_audio_index 0 ou 1 — la plupart des générations renvoient deux audios.
  • Les extensions héritent le prix du modèle source ; les pistes chirp-v5/chirp-v5-5 sont prolongées par chirp-v6, les anciennes par chirp-v6-mini.
  • Les valeurs prompt, style et title trop longues sont tronquées, pas rejetées.
  • extensionStartTime est ramené dans la plage valide au lieu de faire échouer la requête.
  • Les URL audio sont temporaires — téléchargez les résultats sur votre propre stockage.

udioapi.pro est un service tiers indépendant. Il n'est ni affilié à Suno, Udio ou MiniMax, ni approuvé ou exploité par elles.

FAQ Extend Song API

Réponses sur les modes, la facturation et le flux asynchrone.

Que fait la Extend Song API ?

Elle poursuit une génération terminée au-delà de sa fin. Le mode hérité réutilise les paramètres source ; le mode personnalisé accepte un nouveau prompt, style, titre et extensionStartTime.

Comment une extension est-elle facturée ?

Au prix du modèle de la piste originale, par requête. Prolonger une piste servie par chirp-v6 coûte les mêmes 12 crédits ; chirp-v6-mini coûte 10. Les extensions rejetées ou échouées sont remboursées automatiquement.

Quel audio prolonger ?

Mettez extend_audio_index à 0 pour le premier audio retourné ou 1 pour le second — la plupart des générations produisent deux variantes.

Mode hérité ou personnalisé ?

Le mode hérité (custom_mode: false) continue avec les paramètres d'origine. Le mode personnalisé (custom_mode: true) laisse un nouveau prompt, style et titre guider la continuation.

Et si mon extensionStartTime est hors plage ?

La valeur est bornée à 1 … (durée source − 1) secondes au lieu d'échouer ; une valeur absente ou invalide prolonge depuis la fin de la piste source.

Les extensions échouées coûtent-elles des crédits ?

Non. Les requêtes rejetées en validation renvoient 422, et les tâches échouées après acceptation apparaissent en FAILED dans le feed — les crédits sont remboursés dans les deux cas.

Pour aller plus loin