Suno Exclusive Music Model Access Guide

The exclusive music model can learn consistent musical features from 6 to 24 authorized audio tracks and be used for subsequent song creation. Creation is an asynchronous operation; it is recommended to use 24 stylistically consistent and high-quality audio tracks for more stable results.

Only submit audio that you have legal rights to use or have obtained authorization for model creation and subsequent generation. Please do not upload unauthorized music or sound materials.

¶ Create Model

Call POST /suno/custom-models and set action=create. It is recommended to also send a unique Idempotency-Key request header; reuse the same key during network retries to avoid duplicate creation:

{
  "action": "create",
  "name": "My Indie Model",
  "audio_urls": [
    "https://cdn.example.com/song-01.mp3",
    "https://cdn.example.com/song-02.mp3",
    "https://cdn.example.com/song-03.mp3",
    "https://cdn.example.com/song-04.mp3",
    "https://cdn.example.com/song-05.mp3",
    "https://cdn.example.com/song-06.mp3"
  ],
  "callback_url": "https://example.com/webhooks/suno"
}

The interface will immediately return the platform model ID and task ID. After creation is complete, the status in the callback or query result will change to ready. Only successful model creation will incur charges; failed creation will not be charged.

¶ Query Model

Query a single model:

{
  "action": "retrieve",
  "id": "fa518f27-3fac-45cc-9b95-ae7ae0865b5e"
}

Paginated query of the current application's models:

{
  "action": "retrieve_batch",
  "limit": 20,
  "offset": 0,
  "status": "ready"
}

All models belong to the Suno application that created them. API credential rotation will not change model ownership, and other applications cannot query or use the model.

¶ Use Model to Generate Songs

After the model status is ready, continue to call POST /suno/custom-models and set action=generate:

{
  "action": "generate",
  "id": "fa518f27-3fac-45cc-9b95-ae7ae0865b5e",
  "title": "Neon Rain",
  "lyric": "[Verse]\nCity lights are falling through the rain",
  "style": "indie rock, warm analog synth"
}

The id must be the exclusive music model under the current application with a status of ready. The request will fail if the model is unavailable and will not automatically switch to another model.

¶ Archive Model

{
  "action": "delete",
  "id": "fa518f27-3fac-45cc-9b95-ae7ae0865b5e"
}

The current Beta version will archive the model and prohibit further use, with capacity_released=false in the response indicating that archiving does not guarantee the release of model capacity. The archiving operation can be called repeatedly without incurring additional charges.