Extend Music
Extend existing music tracks by adding new content to the end. Choose between inheriting original parameters or using custom settings.
Endpoint Overview
/api/v1/audio/music/extendTwo 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
The task_id from your original music generation request.
Which audio to extend: 0 for the first audio variation, 1 for the second audio.
Optional Parameters
Extension mode. Set to false to inherit parameters, true to use custom parameters. Defaults to false.
Optional webhook URL to receive real-time results via POST.
Custom Mode Parameters
Use these when custom_mode is set to true.
New lyrics or description for the extension. Required if custom_mode is true.
Musical style/genre for the extension.
Title for the extended track.
Start time in seconds for the extension. Must be > 0 and < original audio duration.
Additional tags for the extension.
Example Request
cURL (Inherit Mode)
| 1 | curl -X POST "https://apiin.one/api/v1/audio/music/extend" \ |
| 2 | -H "Authorization: Bearer aio_your_api_key_here" \ |
| 3 | -H "Content-Type: application/json" \ |
| 4 | -d '{ |
| 5 | "origin_task_id": "gen20e094aeaadfe494ea33a5c80ee596083bksv", |
| 6 | "extend_audio_index": 0, |
| 7 | "custom_mode": false |
| 8 | }' |
cURL (Custom Mode)
| 1 | curl -X POST "https://apiin.one/api/v1/audio/music/extend" \ |
| 2 | -H "Authorization: Bearer aio_your_api_key_here" \ |
| 3 | -H "Content-Type: application/json" \ |
| 4 | -d '{ |
| 5 | "origin_task_id": "gen20e094aeaadfe494ea33a5c80ee596083bksv", |
| 6 | "extend_audio_index": 0, |
| 7 | "custom_mode": true, |
| 8 | "prompt": "Change the music style to be calm and lyrical.", |
| 9 | "style": "lyrical", |
| 10 | "title": "lyrical song", |
| 11 | "extensionStartTime": 150 |
| 12 | }' |
Example Response
Returns an extension task ID. Poll the Feed endpoint to get the final audio URLs.
| 1 | { |
| 2 | "task_id": "ext2e31202d4f629447fa75f603ae2470565bksv", |
| 3 | "status": "pending", |
| 4 | "model": "suno-v4-5", |
| 5 | "created_at": "2026-02-24T12:00:00Z" |
| 6 | } |
Error Handling
Missing extend_audio_index, origin_task_id is invalid, or original audio is not completed yet.
Invalid or missing API key.
Insufficient balance.