> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goenhance.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno Extend

> Continue a song from a chosen point. Each request returns **2 versions**.

Pick exactly one source:

- `task_id` + `audio_id`: one of your earlier Suno songs
- `audio_url`: your own audio file (up to 8 minutes)

**Pricing** (per request):

| Option | Tokens | USD |
|---|---|---|
| Per request (2 versions) | 3.9 | $0.078 |

Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use `custom_callback_url`) for the result. On success, `json` holds **one item per song** (normally 2):

```json
{
  "type": "audio",
  "value": "https://cdn4.goenhance.ai/source2/.../output.mp3",
  "audio_id": "e231a3f0-...",
  "title": "Rainy Night",
  "audio_duration": 187.4,
  "style": "lofi hip hop, mellow piano",
  "lyrics": "[Verse] ..."
}
```

Keep the task's `img_uuid` and each song's `audio_id`: that pair is how you extend the song, export WAV, make a music video, split stems or get timestamped lyrics later. Result links expire (see `link_expired_at`), so download the files you want to keep.



## OpenAPI

````yaml api-reference/audio-generations/openapi-suno-extend.json POST /api/v1/audio/generations
openapi: 3.1.0
info:
  title: GoEnhance API - Suno Extend
  description: Continue a Suno song you generated, or your own audio, from any point.
  version: 1.0.0
servers:
  - url: https://api.goenhance.ai
security: []
paths:
  /api/v1/audio/generations:
    post:
      tags:
        - AudioGenerations
      summary: Suno Extend
      description: >-
        Continue a song from a chosen point. Each request returns **2
        versions**.


        Pick exactly one source:


        - `task_id` + `audio_id`: one of your earlier Suno songs

        - `audio_url`: your own audio file (up to 8 minutes)


        **Pricing** (per request):


        | Option | Tokens | USD |

        |---|---|---|

        | Per request (2 versions) | 3.9 | $0.078 |


        Returns an `img_uuid`; poll GET /api/v1/jobs/detail (or use
        `custom_callback_url`) for the result. On success, `json` holds **one
        item per song** (normally 2):


        ```json

        {
          "type": "audio",
          "value": "https://cdn4.goenhance.ai/source2/.../output.mp3",
          "audio_id": "e231a3f0-...",
          "title": "Rainy Night",
          "audio_duration": 187.4,
          "style": "lofi hip hop, mellow piano",
          "lyrics": "[Verse] ..."
        }

        ```


        Keep the task's `img_uuid` and each song's `audio_id`: that pair is how
        you extend the song, export WAV, make a music video, split stems or get
        timestamped lyrics later. Result links expire (see `link_expired_at`),
        so download the files you want to keep.
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: false
          example: '{{Authorization}}'
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  enum:
                    - suno-extend
                  description: Model name. Must be `suno-extend`.
                task_id:
                  type: string
                  description: >-
                    The `img_uuid` of one of your earlier successful Suno tasks
                    that produced songs (`suno-v6`, `suno-extend`, `suno-cover`,
                    `suno-add-vocals`, `suno-add-instrumental`,
                    `suno-replace-section` or `suno-mashup`). Must be sent
                    together with `audio_id`.
                audio_id:
                  type: string
                  description: >-
                    The `audio_id` of the song to use, taken from that task's
                    result (`json[].audio_id`). Must be sent together with
                    `task_id`.
                audio_url:
                  type: string
                  format: uri
                  description: >-
                    Alternative to `task_id` + `audio_id`: a public URL of your
                    own audio to extend (up to 8 minutes).
                continue_at:
                  type: number
                  exclusiveMinimum: 0
                  description: >-
                    Optional. Second in the source where the continuation
                    starts. Must be greater than 0 and less than the source
                    length.
                variant:
                  type: string
                  enum:
                    - standard
                    - mini
                    - wild
                  default: standard
                  description: >-
                    Optional. When extending one of your Suno songs, the
                    source's variant is used automatically and a different value
                    is rejected (Suno requires the same version). When extending
                    an uploaded file, defaults to `standard`.
                instrumental:
                  type: boolean
                  default: false
                  description: >-
                    `true` = no vocals. When `true`, `lyrics`, `vocal_gender`
                    and `audio_weight` must not be sent.
                title:
                  type: string
                  maxLength: 100
                  description: Optional. Song title. Max 100 characters.
                style:
                  type: string
                  maxLength: 1000
                  description: >-
                    Optional. Music style, e.g. `lofi hip hop, mellow piano,
                    rainy night`. Max 1000 characters.
                lyrics:
                  type: string
                  maxLength: 5000
                  description: >-
                    Optional. Lyrics for the new part. Use section markers such
                    as `[Verse]` and `[Chorus]`. Max 5000 characters.
                negative_tags:
                  type: string
                  maxLength: 200
                  description: >-
                    Optional. Styles or traits to avoid, e.g. `heavy metal,
                    screaming`. Max 200 characters.
                vocal_gender:
                  type: string
                  enum:
                    - male
                    - female
                  description: >-
                    Optional. Preferred singer gender (`m` / `f` also accepted).
                    This raises the probability; it is not guaranteed.
                style_weight:
                  type: number
                  minimum: 0
                  maximum: 1
                  description: >-
                    Optional. How strictly to follow `style`, from 0 to 1
                    (rounded to 2 decimals).
                weirdness_constraint:
                  type: number
                  minimum: 0
                  maximum: 1
                  description: >-
                    Optional. How experimental the result may be, from 0 to 1
                    (rounded to 2 decimals).
                audio_weight:
                  type: number
                  minimum: 0
                  maximum: 1
                  description: >-
                    Optional. How much the result follows the audio features of
                    the source, from 0 to 1 (rounded to 2 decimals). Not
                    available when `instrumental` is `true`.
                variety:
                  type: integer
                  minimum: 0
                  maximum: 4
                  default: 1
                  description: >-
                    Optional. How different the versions are from each other: 0
                    off, 1 normal (default), 2 high, 3 extra, 4 max.
                custom_callback_url:
                  type: string
                  format: uri
                  description: >-
                    Optional. A publicly accessible HTTPS URL. When the task
                    status changes (processing / success / failed), GoEnhance
                    sends a POST request to this URL. The request body is
                    identical to the response of GET /api/v1/jobs/detail. If
                    your server does not respond with HTTP 200, the notification
                    is retried up to 3 times, with a 3-second timeout per
                    attempt.
                  example: https://your-server.com/goenhance/callback
              required:
                - model
            example:
              model: suno-extend
              task_id: c12b656c-747a-44fd-9c80-add79b0c52d5
              audio_id: e231a3f0-6c1d-4a8b-9f10-2b8cadc7dc11
              continue_at: 60
              lyrics: |-
                [Bridge]
                The road keeps rolling on
                [Chorus]
                We'll sing until the dawn
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
                  data:
                    type: object
                    properties:
                      img_uuid:
                        type: string
                      cost:
                        type: number
                        description: >-
                          Tokens deducted for this request. This is the amount
                          actually charged, so it already reflects any discount
                          active on your account and can be lower than the
                          listed price. Tokens are deducted when the task is
                          accepted, and refunded automatically if the generation
                          ends in failure.
                        example: 3.9
                    required:
                      - img_uuid
                      - cost
                required:
                  - code
                  - msg
                  - data
              examples:
                '1':
                  summary: Success
                  value:
                    code: 0
                    msg: Success
                    data:
                      img_uuid: c12b656c-747a-44fd-9c80-add79b0c52d5
                      cost: 3.9
                '2':
                  summary: Insufficient tokens
                  value:
                    code: 100
                    msg: tokens is not enough
                quota:
                  summary: API key quota exceeded
                  value:
                    code: 101
                    msg: 'API key quota exceeded: 4990 of 5000 tokens used (monthly)'
                bad:
                  summary: Invalid parameters
                  value:
                    code: -1
                    msg: >-
                      lyrics is required when custom_mode is true and
                      instrumental is false
          headers: {}
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  msg:
                    type: string
          headers: {}
      deprecated: false

````