Suno V6 General Agreements and Task Inquiry

Authentication

Visit the API Key management page to obtain an API Key.

V6 version and model selection

Public models support the following versions:

• v6
• v6-wild
• v6-mini

The main generation endpoint requires either version or the custom_model_id returned by a model-creation task. Editing operations that support versions default to v6 when version is omitted. A public version and custom_model_id cannot be sent together.

General V6 Generation Options

List the following fields only when specific endpoints are provided:

Omit fields that an operation does not support; do not send max_mode: false to every operation. variety and Max mode are independent, so choosing variety: "max" does not enable Max billing.

text and weight limits

The new request for the operation interface uses weirdness; weirdness_constraint is a compatibility alias. The main generation still uses weirdness_constraint. Text length is calculated in Unicode characters.

Reference source track

Based on existing works:

• task_id:API Mart task ID for the output audio track.
• audio_index: The original position in the source task query response of data.result.music[], starting from 1 by default, and can be 1.

Return however many are specified in the array without fixing the result count to 2. Even if the display order changes on the page, subsequent operations must use the index of tracks in the original results.

Submit response

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01M24YMN4EV04M84R5QYM77R1E"
    }
  ]
}

Read the task ID from data[0].task_id. submitted simply indicates that the task has been accepted, not that there is already final audio or other products.

Query task

GET /v1/music/tasks/{task_id}

You can append ?language=zh to get applicable failure message translations. This parameter does not change the language of the song or lyrics.

It is recommended to wait approximately 3 seconds initially, then query every 5-10 seconds until data.status becomes completed or failed. You can continue using the same task ID after page refresh; do not automatically resend paid POST requests due to network timeout.

query response

Response example

{
  "code": 200,
  "data": {
    "id": "task_01M24YMN4EV04M84R5QYM77R1E",
    "status": "completed",
    "progress": 100,
    "created": 1789041600,
    "cost": 0.12,
    "credits_cost": 1.2,
    "result": {
      "music": [
        {
          "audio_id": "example-track-id",
          "status": "complete",
          "title": "follow the lights",
          "lyrics": "[Verse]\nthe late wind blows over familiar streets",
          "tags": "pop, acoustic",
          "display_tags": "Pop, Acoustic",
          "negative_tags": "harsh vocals",
          "style_weight": 0.7,
          "weirdness_constraint": 0,
          "audio_weight": 0.4,
          "duration": 119.8,
          "audio_url": "https://example.com/result.mp3",
          "image_url": "https://example.com/cover.jpg",
          "image_large_url": "https://example.com/cover-large.jpg"
        }
      ]
    }
  }
}

{
  "code": 200,
  "data": {
    "id": "task_01M24YMN4EV04M84R5QYM77R1E",
    "status": "failed",
    "progress": 0,
    "cost": 0,
    "credits_cost": 0,
    "error": {
      "message": "task failure reason",
      "type": "task_failed",
      "code": "task_failed",
      "param": ""
    }
  }
}

result processing

• Music-related results are typically found at data.result.music[], but different operations such as downloads, lyrics, MIDI, Persona, and custom models have their own result structures.
• duration is the actual duration and may contain decimals; input target duration does not guarantee exact match with final product.
• The weight return value 0 is a valid value and cannot be hidden due to JavaScript's falsy judgment.
• audio_url does not guarantee the use of .mp3 suffix, please play or download using the actual URL returned by the interface.
• status="unknown" Keep the task ID and allow manual refreshing while not automatically creating new tasks.

AbortController can stop browser requests and polling, but it does not cancel the server-side task. There is currently no endpoint for canceling a submitted Suno task.

This documentation is built and hosted on Mintlify, a developer documentation platform.