Skip to main content
POST
/
suno
/
submit
/
music
cURL
curl https://api.deerapi.com/suno/submit/music \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -d '{
    "task": "gen_stem",
    "task_id": "7e0000d1-511e-482e-9b13-f6f8dbb02a05",
    "generation_type": "TEXT",
    "title": "Strings of Safety",
    "mv": "chirp-auk",
    "make_instrumental": true,
    "continue_clip_id": "31f022a4-b95c-4988-9608-281172753cf4",
    "continued_aligned_prompt": null,
    "continue_at": null,
    "stem_type_id": 91,
    "stem_type_group_name": "Twelve",
    "stem_task": "twelve"
  }'
import os
import requests

url = "https://api.deerapi.com/suno/submit/music"
headers = {
    "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
    "Content-Type": "application/json",
}
payload = {
  "task": "gen_stem",
  "task_id": "7e0000d1-511e-482e-9b13-f6f8dbb02a05",
  "generation_type": "TEXT",
  "title": "Strings of Safety",
  "mv": "chirp-auk",
  "make_instrumental": true,
  "continue_clip_id": "31f022a4-b95c-4988-9608-281172753cf4",
  "continued_aligned_prompt": null,
  "continue_at": null,
  "stem_type_id": 91,
  "stem_type_group_name": "Twelve",
  "stem_task": "twelve"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
const response = await fetch("https://api.deerapi.com/suno/submit/music", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "task": "gen_stem",
    "task_id": "7e0000d1-511e-482e-9b13-f6f8dbb02a05",
    "generation_type": "TEXT",
    "title": "Strings of Safety",
    "mv": "chirp-auk",
    "make_instrumental": true,
    "continue_clip_id": "31f022a4-b95c-4988-9608-281172753cf4",
    "continued_aligned_prompt": null,
    "continue_at": null,
    "stem_type_id": 91,
    "stem_type_group_name": "Twelve",
    "stem_task": "twelve"
  }),
});

console.log(await response.json());
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.deerapi.com/suno/submit/music",
  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([
    'task' => 'gen_stem',
    'task_id' => '7e0000d1-511e-482e-9b13-f6f8dbb02a05',
    'generation_type' => 'TEXT',
    'title' => 'Strings of Safety',
    'mv' => 'chirp-auk',
    'make_instrumental' => true,
    'continue_clip_id' => '31f022a4-b95c-4988-9608-281172753cf4',
    'continued_aligned_prompt' => null,
    'continue_at' => null,
    'stem_type_id' => 91,
    'stem_type_group_name' => 'Twelve',
    'stem_task' => 'twelve'
  ]),
  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/submit/music"

	payload := strings.NewReader("{\n  \"task\": \"gen_stem\",\n  \"task_id\": \"7e0000d1-511e-482e-9b13-f6f8dbb02a05\",\n  \"generation_type\": \"TEXT\",\n  \"title\": \"Strings of Safety\",\n  \"mv\": \"chirp-auk\",\n  \"make_instrumental\": true,\n  \"continue_clip_id\": \"31f022a4-b95c-4988-9608-281172753cf4\",\n  \"continued_aligned_prompt\": null,\n  \"continue_at\": null,\n  \"stem_type_id\": 91,\n  \"stem_type_group_name\": \"Twelve\",\n  \"stem_task\": \"twelve\"\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/submit/music")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"task\": \"gen_stem\",\n  \"task_id\": \"7e0000d1-511e-482e-9b13-f6f8dbb02a05\",\n  \"generation_type\": \"TEXT\",\n  \"title\": \"Strings of Safety\",\n  \"mv\": \"chirp-auk\",\n  \"make_instrumental\": true,\n  \"continue_clip_id\": \"31f022a4-b95c-4988-9608-281172753cf4\",\n  \"continued_aligned_prompt\": null,\n  \"continue_at\": null,\n  \"stem_type_id\": 91,\n  \"stem_type_group_name\": \"Twelve\",\n  \"stem_task\": \"twelve\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.deerapi.com/suno/submit/music")

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  \"task\": \"gen_stem\",\n  \"task_id\": \"7e0000d1-511e-482e-9b13-f6f8dbb02a05\",\n  \"generation_type\": \"TEXT\",\n  \"title\": \"Strings of Safety\",\n  \"mv\": \"chirp-auk\",\n  \"make_instrumental\": true,\n  \"continue_clip_id\": \"31f022a4-b95c-4988-9608-281172753cf4\",\n  \"continued_aligned_prompt\": null,\n  \"continue_at\": null,\n  \"stem_type_id\": 91,\n  \"stem_type_group_name\": \"Twelve\",\n  \"stem_task\": \"twelve\"\n}"

response = http.request(request)
puts response.read_body
{
  "id": "<string>",
  "clips": [
    {
      "id": "<string>",
      "entity_type": "<string>",
      "video_url": "<string>",
      "audio_url": "<string>",
      "major_model_version": "<string>",
      "model_name": "<string>",
      "metadata": {
        "prompt": "<string>",
        "history": [
          {
            "id": "<string>",
            "type": "<string>",
            "source": "<string>",
            "infill": true,
            "stem_type_id": 123,
            "stem_type_group_name": "<string>",
            "stem_task": "<string>",
            "stem_from_id": "<string>"
          }
        ],
        "stem_from_id": "<string>",
        "stem_task": "<string>",
        "stem_type_id": 123,
        "stem_type_group_name": "<string>",
        "edited_clip_id": "<string>",
        "type": "<string>",
        "stream": true,
        "infill": true,
        "task": "<string>",
        "can_remix": true,
        "is_remix": true,
        "priority": 123
      },
      "is_liked": true,
      "user_id": "<string>",
      "display_name": "<string>",
      "handle": "<string>",
      "is_handle_updated": true,
      "avatar_image_url": "<string>",
      "is_trashed": true,
      "flag_count": 123,
      "created_at": "<string>",
      "status": "<string>",
      "title": "<string>",
      "play_count": 123,
      "upvote_count": 123,
      "is_public": true,
      "allow_comments": true,
      "more": "<string>"
    }
  ],
  "metadata": {
    "prompt": "<string>",
    "history": [
      {
        "id": "<string>",
        "type": "<string>",
        "source": "<string>",
        "infill": true,
        "stem_type_id": 123,
        "stem_type_group_name": "<string>",
        "stem_task": "<string>",
        "stem_from_id": "<string>"
      }
    ],
    "stem_from_id": "<string>",
    "stem_task": "<string>",
    "stem_type_id": 123,
    "stem_type_group_name": "<string>",
    "edited_clip_id": "<string>",
    "type": "<string>",
    "stream": true,
    "infill": true,
    "task": "<string>",
    "can_remix": true,
    "is_remix": true,
    "priority": 123
  },
  "major_model_version": "<string>",
  "status": "<string>",
  "created_at": "<string>",
  "batch_size": 123
}

​
Overview

Use this endpoint to call the Suno Full Track Separate 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
​
task
string
default:example
required
​
task_id
string
default:example
required
​
generation_type
string
default:example
required
​
title
string
default:example
required
​
mv
string
default:example
required
​
make_instrumental
boolean
default:true
required
​
continue_clip_id
string
default:example
required
​
continued_aligned_prompt
null
required
​
continue_at
null
required
​
stem_type_id
integer
default:1
required
​
stem_type_group_name
string
default:example
required
​
stem_task
string
default:example
required

Response

200 - application/json

Successful Response

​
id
string
required
​
clips
object[]
required
​
metadata
object
required
​
major_model_version
string
required
​
status
string
required
​
created_at
string
required
​
batch_size
integer
required