Skip to main content
POST
Suno Custom Model
suno-custom-model trains a custom Suno model on 6 to 24 of your reference tracks. Later generations can use it through custom_model_task_id. Confirm live rates on the SnapGen models page. Failed tasks are not charged.
string
required
Set to suno-custom-model.
string
required
Name of the custom model, up to 100 characters.
string[]
required
6 to 24 public http or https audio URLs to learn from, without repeats. MP3, WAV, and M4A work best; one unreadable file can fail the whole task.
string
Optional public https URL that receives one signed event when the task finishes. See Task webhooks.
string
Required with webhook: 16 to 256 characters, used to sign the delivery.

Request

The response is HTTP 202 with a task object and a Location: /v1/tasks/{id} header. Poll GET /v1/tasks/{id} every 10 to 20 seconds until status is succeeded or failed.

Result

result.custom_model holds the model id and name. To generate with the model, pass this task’s id as custom_model_task_id; you never send the model id itself.

Use it in later requests

Pass this task’s id as custom_model_task_id to any of these models: suno-music, suno-inspo, suno-upload-cover, suno-upload-extend, suno-extend, suno-cover, suno-add-vocals, suno-add-instrumental, suno-add-stem, suno-replace-section, suno-mashup, suno-sample. Omit version when you send it.
See Music generation tasks for the task lifecycle, result fields, webhooks, and errors.