Extend Music

Extend existing music tracks by adding new content to the end. Choose between inheriting original parameters or using custom settings.

Endpoint Overview

POST/api/v1/audio/music/extend

Two Extension Modes:

Inherit Mode (custom_mode: false): Automatically inherits ALL parameters from the original task (prompt, style, title, model, etc.) - no additional parameters needed for seamless continuation.
Custom Mode (custom_mode: true): Override original parameters with new prompt, style, title, and starting time for creative transformation.

Credits: 5–12 credits per generation (depending on model tier).

Parameters

Required Parameters

Parametre	Tür	Gerekli	Açıklama
`origin_task_id`	string	Gerekli	The task_id from your original music generation request.
`extend_audio_index`	number	Gerekli	Which audio to extend: 0 for the first audio variation, 1 for the second audio.

Optional Parameters

Parametre	Tür	Gerekli	Açıklama
`custom_mode`	boolean	İsteğe Bağlı	Extension mode. Set to false to inherit parameters, true to use custom parameters. (Varsayılan: false)
`callback_url`	string	İsteğe Bağlı	Optional webhook URL to receive real-time results via POST.

Custom Mode Parameters

Use these when custom_mode is set to true.

Parametre	Tür	Gerekli	Açıklama
`prompt`	string	Gerekli	New lyrics or description for the extension. Required if custom_mode is true.
`style`	string	İsteğe Bağlı	Musical style/genre for the extension.
`title`	string	İsteğe Bağlı	Title for the extended track.
`extensionStartTime`	number	İsteğe Bağlı	Start time in seconds for the extension. Must be > 0 and < original audio duration.
`tags`	string	İsteğe Bağlı	Additional tags for the extension.

Example Request

cURL (Inherit Mode)

bash

curl -X POST "https://apiin.one/api/v1/audio/music/extend" \
  -H "Authorization: Bearer aio_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "origin_task_id": "gen20e094aeaadfe494ea33a5c80ee596083bksv",
    "extend_audio_index": 0,
    "custom_mode": false
  }'

cURL (Custom Mode)

bash

curl -X POST "https://apiin.one/api/v1/audio/music/extend" \
  -H "Authorization: Bearer aio_your_api_key_here" \
  -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",
    "title": "lyrical song",
    "extensionStartTime": 150
  }'

Example Response

Returns an extension task ID. Poll the Feed endpoint to get the final audio URLs.

json

{
  "task_id": "ext2e31202d4f629447fa75f603ae2470565bksv",
  "status": "pending",
  "model": "suno-v4-5",
  "created_at": "2026-02-24T12:00:00Z"
}

Error Handling

Status Code	Tür	Gerekli	Açıklama
`400`	invalid_request	İsteğe Bağlı	Missing extend_audio_index, origin_task_id is invalid, or original audio is not completed yet.
`401`	authentication_error	İsteğe Bağlı	Invalid or missing API key.
`402`	insufficient_credits	İsteğe Bağlı	Insufficient balance.