Suno Sounds

curl --request POST \
  --url https://api.snapgen.org/v1/music/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "version": "<string>",
  "type": "<string>",
  "bpm": 123,
  "key": "<string>",
  "audio_format": "<string>",
  "webhook": "<string>",
  "webhook_secret": "<string>"
}
'

import requests

url = "https://api.snapgen.org/v1/music/generations"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "version": "<string>",
    "type": "<string>",
    "bpm": 123,
    "key": "<string>",
    "audio_format": "<string>",
    "webhook": "<string>",
    "webhook_secret": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    version: '<string>',
    type: '<string>',
    bpm: 123,
    key: '<string>',
    audio_format: '<string>',
    webhook: '<string>',
    webhook_secret: '<string>'
  })
};

fetch('https://api.snapgen.org/v1/music/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.snapgen.org/v1/music/generations",
  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([
    'model' => '<string>',
    'prompt' => '<string>',
    'version' => '<string>',
    'type' => '<string>',
    'bpm' => 123,
    'key' => '<string>',
    'audio_format' => '<string>',
    'webhook' => '<string>',
    'webhook_secret' => '<string>'
  ]),
  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.snapgen.org/v1/music/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"version\": \"<string>\",\n  \"type\": \"<string>\",\n  \"bpm\": 123,\n  \"key\": \"<string>\",\n  \"audio_format\": \"<string>\",\n  \"webhook\": \"<string>\",\n  \"webhook_secret\": \"<string>\"\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.snapgen.org/v1/music/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"version\": \"<string>\",\n  \"type\": \"<string>\",\n  \"bpm\": 123,\n  \"key\": \"<string>\",\n  \"audio_format\": \"<string>\",\n  \"webhook\": \"<string>\",\n  \"webhook_secret\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.snapgen.org/v1/music/generations")

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  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"version\": \"<string>\",\n  \"type\": \"<string>\",\n  \"bpm\": 123,\n  \"key\": \"<string>\",\n  \"audio_format\": \"<string>\",\n  \"webhook\": \"<string>\",\n  \"webhook_secret\": \"<string>\"\n}"

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

POST

music

generations

Suno Sounds

curl --request POST \
  --url https://api.snapgen.org/v1/music/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "version": "<string>",
  "type": "<string>",
  "bpm": 123,
  "key": "<string>",
  "audio_format": "<string>",
  "webhook": "<string>",
  "webhook_secret": "<string>"
}
'

import requests

url = "https://api.snapgen.org/v1/music/generations"

payload = {
    "model": "<string>",
    "prompt": "<string>",
    "version": "<string>",
    "type": "<string>",
    "bpm": 123,
    "key": "<string>",
    "audio_format": "<string>",
    "webhook": "<string>",
    "webhook_secret": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: '<string>',
    prompt: '<string>',
    version: '<string>',
    type: '<string>',
    bpm: 123,
    key: '<string>',
    audio_format: '<string>',
    webhook: '<string>',
    webhook_secret: '<string>'
  })
};

fetch('https://api.snapgen.org/v1/music/generations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.snapgen.org/v1/music/generations",
  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([
    'model' => '<string>',
    'prompt' => '<string>',
    'version' => '<string>',
    'type' => '<string>',
    'bpm' => 123,
    'key' => '<string>',
    'audio_format' => '<string>',
    'webhook' => '<string>',
    'webhook_secret' => '<string>'
  ]),
  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.snapgen.org/v1/music/generations"

	payload := strings.NewReader("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"version\": \"<string>\",\n  \"type\": \"<string>\",\n  \"bpm\": 123,\n  \"key\": \"<string>\",\n  \"audio_format\": \"<string>\",\n  \"webhook\": \"<string>\",\n  \"webhook_secret\": \"<string>\"\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.snapgen.org/v1/music/generations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"version\": \"<string>\",\n  \"type\": \"<string>\",\n  \"bpm\": 123,\n  \"key\": \"<string>\",\n  \"audio_format\": \"<string>\",\n  \"webhook\": \"<string>\",\n  \"webhook_secret\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.snapgen.org/v1/music/generations")

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  \"model\": \"<string>\",\n  \"prompt\": \"<string>\",\n  \"version\": \"<string>\",\n  \"type\": \"<string>\",\n  \"bpm\": 123,\n  \"key\": \"<string>\",\n  \"audio_format\": \"<string>\",\n  \"webhook\": \"<string>\",\n  \"webhook_secret\": \"<string>\"\n}"

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

suno-sounds generates a sound effect from a description, as a single hit or a loop.

Property	Value
Model ID	`suno-sounds`
Endpoint	`POST /v1/music/generations` (asynchronous task)
Group	Suno > Create
Input	Text: a description of the sound
Result	Tracks in `result.tracks` with `audio_url`
Price	$0.0144 per request (1.44 credits)

Confirm live rates on the SnapGen models page. Failed tasks are not charged.

string

required

Set to suno-sounds.

string

required

What the sound should be, up to 3,000 characters. English prompts work best.

string

default:"v6"

Suno model version: v6, v6-wild, or v6-mini.

string

default:"one-shot"

one-shot for a single hit, or loop for a sound that loops.

integer

Tempo in beats per minute, from 1 to 300.

string

Musical key from C to B, with sharps such as C#; add m for a minor key, such as F#m. Flats such as Db aren’t accepted.

string

Output format: mp3, m4a, or wav. The provider picks one if you omit it.

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

curl https://api.snapgen.org/v1/music/generations \
  -H "Authorization: Bearer $SNAPGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-sounds",
    "prompt": "Thunderstorm with distant church bells",
    "type": "one-shot"
  }'

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.tracks[] lists every track in its original order, each with its index and audio_url, plus title, image_url, duration_seconds, lyrics, and tags when the provider returns them. result.urls lists the audio URLs.

{
  "urls": [
    "https://cdn.example.com/music/night-drive.mp3"
  ],
  "tracks": [
    {
      "index": 1,
      "id": "clip_8f3a2c",
      "title": "Night Drive",
      "audio_url": "https://cdn.example.com/music/night-drive.mp3",
      "image_url": "https://cdn.example.com/music/night-drive.jpg",
      "duration_seconds": 184.6,
      "tags": "lo-fi, soft piano, rain"
    }
  ]
}

Result URLs are kept for about 72 hours. Download the files you want to keep. See Music generation tasks for the task lifecycle, result fields, webhooks, and errors.

Overview

Text Series

Image Series

Video Series

Audio Series

Endpoint Reference

Task Management

Suno Sounds

Request

Result

​Request

​Result

Request

Result