Suno Custom Model - DeerAPI Documentation

POST

suno

custom-model

cURL

curl https://api.deerapi.com/suno/custom-model \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -d '{
    "clip_ids": [
      "7173c086-844d-4b9e-9cee-e771f7ded3eb",
      "c87451ec-8e09-4358-b93b-99a0f59374b3",
      "9c58ae41-4364-4995-827c-8033109abb5d",
      "92022750-af59-44e1-a559-74d6f2503f5e",
      "06215aa7-7725-4741-91d2-cc316e2454fe",
      "f7a1e392-e659-4376-8b24-f267ba4f6e30"
    ],
    "name": "your-model-name"
  }'

import os
import requests

url = "https://api.deerapi.com/suno/custom-model"
headers = {
    "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
    "Content-Type": "application/json",
}
payload = {
  "clip_ids": [
    "7173c086-844d-4b9e-9cee-e771f7ded3eb",
    "c87451ec-8e09-4358-b93b-99a0f59374b3",
    "9c58ae41-4364-4995-827c-8033109abb5d",
    "92022750-af59-44e1-a559-74d6f2503f5e",
    "06215aa7-7725-4741-91d2-cc316e2454fe",
    "f7a1e392-e659-4376-8b24-f267ba4f6e30"
  ],
  "name": "your-model-name"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.deerapi.com/suno/custom-model", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "clip_ids": [
      "7173c086-844d-4b9e-9cee-e771f7ded3eb",
      "c87451ec-8e09-4358-b93b-99a0f59374b3",
      "9c58ae41-4364-4995-827c-8033109abb5d",
      "92022750-af59-44e1-a559-74d6f2503f5e",
      "06215aa7-7725-4741-91d2-cc316e2454fe",
      "f7a1e392-e659-4376-8b24-f267ba4f6e30"
    ],
    "name": "your-model-name"
  }),
});

console.log(await response.json());

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.deerapi.com/suno/custom-model",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'clip_ids' => [
        '7173c086-844d-4b9e-9cee-e771f7ded3eb',
        'c87451ec-8e09-4358-b93b-99a0f59374b3',
        '9c58ae41-4364-4995-827c-8033109abb5d',
        '92022750-af59-44e1-a559-74d6f2503f5e',
        '06215aa7-7725-4741-91d2-cc316e2454fe',
        'f7a1e392-e659-4376-8b24-f267ba4f6e30'
    ],
    'name' => 'your-model-name'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.deerapi.com/suno/custom-model"

	payload := strings.NewReader("{\n  \"clip_ids\": [\n    \"7173c086-844d-4b9e-9cee-e771f7ded3eb\",\n    \"c87451ec-8e09-4358-b93b-99a0f59374b3\",\n    \"9c58ae41-4364-4995-827c-8033109abb5d\",\n    \"92022750-af59-44e1-a559-74d6f2503f5e\",\n    \"06215aa7-7725-4741-91d2-cc316e2454fe\",\n    \"f7a1e392-e659-4376-8b24-f267ba4f6e30\"\n  ],\n  \"name\": \"your-model-name\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.deerapi.com/suno/custom-model")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clip_ids\": [\n    \"7173c086-844d-4b9e-9cee-e771f7ded3eb\",\n    \"c87451ec-8e09-4358-b93b-99a0f59374b3\",\n    \"9c58ae41-4364-4995-827c-8033109abb5d\",\n    \"92022750-af59-44e1-a559-74d6f2503f5e\",\n    \"06215aa7-7725-4741-91d2-cc316e2454fe\",\n    \"f7a1e392-e659-4376-8b24-f267ba4f6e30\"\n  ],\n  \"name\": \"your-model-name\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.deerapi.com/suno/custom-model")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"clip_ids\": [\n    \"7173c086-844d-4b9e-9cee-e771f7ded3eb\",\n    \"c87451ec-8e09-4358-b93b-99a0f59374b3\",\n    \"9c58ae41-4364-4995-827c-8033109abb5d\",\n    \"92022750-af59-44e1-a559-74d6f2503f5e\",\n    \"06215aa7-7725-4741-91d2-cc316e2454fe\",\n    \"f7a1e392-e659-4376-8b24-f267ba4f6e30\"\n  ],\n  \"name\": \"your-model-name\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "status": "<string>"
}

Overview

Use this endpoint to call the Suno Custom Model workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

Before you start

Use the DeerAPI base URL and pass your API Key in the Authorization header:

https://api.deerapi.com

Authorization: Bearer $DEERAPI_KEY

Model selection

Choose a current model ID from the live pricing page. Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

Implementation notes

Use the OpenAPI playground for the exact request fields accepted by this endpoint.
Keep API Keys on the server side when you build production applications.
Log the request ID from failed calls so support can investigate the request.
Retry 429, 500, and 503 responses with exponential backoff.

Authorizations

Authorization

string

header

required

Use a DeerAPI API Key as a Bearer token.

Body

application/json

clip_ids

string[]

required

Array of song clip_ids. Minimum 6, recommended 24. All must belong to the same account.

Minimum array length: 6

name

string

required

Model name

Response

200 - application/json

Success

string

Model ID for subsequent queries and usage

status

string

Status. pending means training in progress.

Suno Voice Create

Suno Custom Model Feed

cURL

curl https://api.deerapi.com/suno/custom-model \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -d '{
    "clip_ids": [
      "7173c086-844d-4b9e-9cee-e771f7ded3eb",
      "c87451ec-8e09-4358-b93b-99a0f59374b3",
      "9c58ae41-4364-4995-827c-8033109abb5d",
      "92022750-af59-44e1-a559-74d6f2503f5e",
      "06215aa7-7725-4741-91d2-cc316e2454fe",
      "f7a1e392-e659-4376-8b24-f267ba4f6e30"
    ],
    "name": "your-model-name"
  }'

import os
import requests

url = "https://api.deerapi.com/suno/custom-model"
headers = {
    "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
    "Content-Type": "application/json",
}
payload = {
  "clip_ids": [
    "7173c086-844d-4b9e-9cee-e771f7ded3eb",
    "c87451ec-8e09-4358-b93b-99a0f59374b3",
    "9c58ae41-4364-4995-827c-8033109abb5d",
    "92022750-af59-44e1-a559-74d6f2503f5e",
    "06215aa7-7725-4741-91d2-cc316e2454fe",
    "f7a1e392-e659-4376-8b24-f267ba4f6e30"
  ],
  "name": "your-model-name"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.deerapi.com/suno/custom-model", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "clip_ids": [
      "7173c086-844d-4b9e-9cee-e771f7ded3eb",
      "c87451ec-8e09-4358-b93b-99a0f59374b3",
      "9c58ae41-4364-4995-827c-8033109abb5d",
      "92022750-af59-44e1-a559-74d6f2503f5e",
      "06215aa7-7725-4741-91d2-cc316e2454fe",
      "f7a1e392-e659-4376-8b24-f267ba4f6e30"
    ],
    "name": "your-model-name"
  }),
});

console.log(await response.json());

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.deerapi.com/suno/custom-model",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'clip_ids' => [
        '7173c086-844d-4b9e-9cee-e771f7ded3eb',
        'c87451ec-8e09-4358-b93b-99a0f59374b3',
        '9c58ae41-4364-4995-827c-8033109abb5d',
        '92022750-af59-44e1-a559-74d6f2503f5e',
        '06215aa7-7725-4741-91d2-cc316e2454fe',
        'f7a1e392-e659-4376-8b24-f267ba4f6e30'
    ],
    'name' => 'your-model-name'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.deerapi.com/suno/custom-model"

	payload := strings.NewReader("{\n  \"clip_ids\": [\n    \"7173c086-844d-4b9e-9cee-e771f7ded3eb\",\n    \"c87451ec-8e09-4358-b93b-99a0f59374b3\",\n    \"9c58ae41-4364-4995-827c-8033109abb5d\",\n    \"92022750-af59-44e1-a559-74d6f2503f5e\",\n    \"06215aa7-7725-4741-91d2-cc316e2454fe\",\n    \"f7a1e392-e659-4376-8b24-f267ba4f6e30\"\n  ],\n  \"name\": \"your-model-name\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.deerapi.com/suno/custom-model")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clip_ids\": [\n    \"7173c086-844d-4b9e-9cee-e771f7ded3eb\",\n    \"c87451ec-8e09-4358-b93b-99a0f59374b3\",\n    \"9c58ae41-4364-4995-827c-8033109abb5d\",\n    \"92022750-af59-44e1-a559-74d6f2503f5e\",\n    \"06215aa7-7725-4741-91d2-cc316e2454fe\",\n    \"f7a1e392-e659-4376-8b24-f267ba4f6e30\"\n  ],\n  \"name\": \"your-model-name\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.deerapi.com/suno/custom-model")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"clip_ids\": [\n    \"7173c086-844d-4b9e-9cee-e771f7ded3eb\",\n    \"c87451ec-8e09-4358-b93b-99a0f59374b3\",\n    \"9c58ae41-4364-4995-827c-8033109abb5d\",\n    \"92022750-af59-44e1-a559-74d6f2503f5e\",\n    \"06215aa7-7725-4741-91d2-cc316e2454fe\",\n    \"f7a1e392-e659-4376-8b24-f267ba4f6e30\"\n  ],\n  \"name\": \"your-model-name\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "status": "<string>"
}

​Overview

​Before you start

​Model selection

​Implementation notes

Authorizations

Body

Response

Overview

Before you start

Model selection

Implementation notes