Skip to main content
POST /api/extend_audio
Creates a new audio clip that continues from an existing clip. You can continue from the end of the clip or from a specific timestamp. The new clip inherits the style of the original unless you supply new tags.
The server reads your Suno session from the SUNO_COOKIE environment variable. Pass a Cookie header containing a valid __client value to use a different Suno account on a per-request basis.
audio_id is required. The server returns 400 Bad Request if it is missing.

​
Request body

​
audio_id
string
required
The ID of the existing audio clip to extend. This must be a clip that already exists in your Suno account.
​
prompt
string
Additional lyrics or a continuation of the existing lyrics. Supports Suno section markers such as [Verse], [Chorus], [Outro].
​
continue_at
number
The timestamp in seconds from which to branch the extension. For example, 30 continues from the 30-second mark. If omitted, the extension begins from the end of the clip.
​
tags
string
Comma-separated music style tags for the extended clip. If omitted, Suno infers the style from the original clip.
​
negative_tags
string
Comma-separated style tags to avoid in the extended output.
​
title
string
Title for the new extended clip.
​
model
string
default:"chirp-v3-5"
The Suno model version to use for generation.
​
wait_audio
boolean
default:"false"
When true, blocks until the clip reaches streaming or complete status (up to 100 seconds). When false, the clip is returned immediately in submitted / queued state.

​
Response

An array of AudioInfo objects representing the newly generated extension clip(s). See Generate for the full field reference.
​
[].id
string
Unique identifier for the new extended clip. Use this ID with /api/concat to stitch extensions together.
​
[].title
string
Title of the extended clip.
​
[].image_url
string
URL of the cover art image.
​
[].lyric
string
Lyrics used in the extended clip.
​
[].audio_url
string
URL of the generated audio. May be empty until status reaches streaming or complete.
​
[].video_url
string
URL of the generated video.
​
[].created_at
string
ISO 8601 timestamp of clip creation.
​
[].model_name
string
The model used to generate this clip.
​
[].status
string
Generation status: submitted, queued, streaming, complete, or error.
​
[].tags
string
Style tags applied to the extended clip.
​
[].negative_tags
string
Negative style tags applied to the extended clip.
​
[].duration
string
Duration of the extended clip in seconds.
​
[].error_message
string
Error description when status is error.

​
Error responses

StatusMeaning
400audio_id is missing
402Out of Suno credits — payment required
500Internal server error
503Network error connecting to Suno

​
Examples

​
Extend from the 30-second mark

curl -X POST http://localhost:3000/api/extend_audio \
  -H "Content-Type: application/json" \
  -d '{
    "audio_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "prompt": "[Bridge]\nStars above guide me through the night\nEvery storm leads to clearer light\n[Outro]\nOcean wanderer finding her way home",
    "continue_at": 30,
    "tags": "folk, acoustic guitar, female vocalist",
    "negative_tags": "heavy metal, electronic",
    "title": "Ocean Wanderer (Extended)",
    "model": "chirp-v3-5",
    "wait_audio": true
  }'

​
Response

[
  {
    "id": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "title": "Ocean Wanderer (Extended)",
    "image_url": "https://cdn1.suno.ai/image_e5f6a7b8-c9d0-1234-efab-345678901234.jpeg",
    "lyric": "[Bridge]\nStars above guide me through the night\nEvery storm leads to clearer light\n[Outro]\nOcean wanderer finding her way home",
    "audio_url": "https://cdn1.suno.ai/e5f6a7b8-c9d0-1234-efab-345678901234.mp3",
    "video_url": "https://cdn1.suno.ai/e5f6a7b8-c9d0-1234-efab-345678901234.mp4",
    "created_at": "2024-01-15T11:30:00.000Z",
    "model_name": "chirp-v3-5",
    "gpt_description_prompt": "",
    "prompt": "[Bridge]\nStars above guide me through the night\nEvery storm leads to clearer light\n[Outro]\nOcean wanderer finding her way home",
    "status": "complete",
    "type": "gen",
    "tags": "folk, acoustic guitar, female vocalist",
    "negative_tags": "heavy metal, electronic",
    "duration": "95.3",
    "error_message": null
  }
]

Build docs developers (and LLMs) love

Get started for freeTalk to us