API in One/Docs/Suno/Extend Music
Suno API Reference

Extend Music

Extend an existing Suno track by inheriting the original generation settings or applying custom lyrics, style, and start time.

Model page
Base URL
https://apiin.one/api/v1

Use the unified API in One gateway for all Suno routes.

Mode
Inherit or custom

Continue seamlessly or override creative direction.

Credits
5-12 credits

Cost depends on selected Suno model tier.

POST/api/v1/audio/music/extend

Create Extension Task

Extend a completed Suno music task.

Use inherit mode for seamless continuation, or enable custom mode to change lyrics, style, title, and extension start time.

  • custom_mode false inherits all original task settings.
  • custom_mode true lets you override prompt, style, title, and start time.
  • Poll the Feed API after receiving the extension task ID.

Required Parameters

Body ParametersJSON
origin_task_id:string

The task_id from your original music generation request.

extend_audio_index:number

Which audio to extend: 0 for the first audio variation, 1 for the second audio.

Optional Parameters

Body ParametersJSON
custom_mode:optional boolean

Extension mode. Set to false to inherit parameters, true to use custom parameters. Defaults to false.

callback_url:optional string

Optional webhook URL to receive real-time results via POST.

Custom Mode Parameters

Use these when custom_mode is true.

Body ParametersJSON
prompt:string

New lyrics or description for the extension. Required if custom_mode is true.

style:optional string

Musical style/genre for the extension.

title:optional string

Title for the extended track.

extensionStartTime:optional number

Start time in seconds for the extension. Must be > 0 and < original audio duration.

tags:optional string

Additional tags for the extension.

cURL Example - Inherit Mode

bash
1curl -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 Example - Custom Mode

bash
1curl -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 }'

Task Response

Returns an extension task ID for polling.

json
1{
2 "task_id": "ext2e31202d4f629447fa75f603ae2470565bksv",
3 "status": "pending",
4 "model": "chirp-v4-5",
5 "created_at": "2026-02-24T12:00:00Z"
6}

Error Handling

API in One uses consistent authentication, credit, and validation errors across Suno endpoints.

Body ParametersJSON
400:optional invalid_request

Missing extend_audio_index, origin_task_id is invalid, or original audio is not completed yet.

401:optional authentication_error

Invalid or missing API key.

402:optional insufficient_credits

Insufficient balance.