Suno logoSunoAudio

Suno API

Suno music creation for songs and instrumentals, with service-specific API access.

Playground

Audio Generator

Model

Suno API
Settings

No audio generated yet

Enter text and click Generate to create audio.

About this model

Capabilities & specifications

Input
Text
Output
Audio

Suno is a music-creation platform for developing songs, vocals and instrumental ideas. The screenshot's Suno API label does not identify a specific underlying model revision or prove a first-party public generation API; this entry therefore publishes music documentation and sourced media without an execution binding.

  • Music creation
Audio

Examples

Suno official music preview excerpt

Model output documented by the source.

suno.com

Build with Suno API

Manage API keys
  • Bash
  • cURL >= 8.4
  • jq >= 1.6
  • uuidgen
bash
set -euo pipefail
: "${ONEASTER_API_KEY:?Set ONEASTER_API_KEY}"
base=$(printf '%s' 'aHR0cHM6Ly9hcGkub25lYXN0ZXIuYWkvdjE=' | jq -Rr '@base64d')
intent="${ONEASTER_INTENT_ID:-$(uuidgen)}"
printf 'Keep this intent and input: %s\n' "$intent" >&2
body=$(printf '%s' 'eyJraW5kIjoibXVzaWMiLCJtb2RlbCI6InN1bm8tbXVzaWMiLCJpbnB1dCI6eyJwcm9tcHQiOiJBIHF1aWV0IGNpbmVtYXRpYyBtZWxvZHkiLCJpc19pbnN0cnVtZW50YWwiOnRydWV9fQ==' | jq -Rr '@base64d')
work=$(mktemp -d)
trap 'rm -rf "$work"' EXIT
request() {
  curl --fail-with-body --silent --show-error --max-time 60 --max-filesize 8388608 \
    --header "Authorization: Bearer $ONEASTER_API_KEY" "$@"
}
if [ 'task' = 'sse' ]; then
  printf '%s' "$body" | request --no-buffer --request POST "$base/chat/completions" --header 'Content-Type: application/json' --header "Idempotency-Key: $intent" --data-binary @- |
  while IFS= read -r line; do
    case "$line" in
      'data: '*)
        data="${line#data: }"
        if [ "$data" = '[DONE]' ]; then touch "$work/done"; break; fi
        printf '%s\n' "$data" | jq -e 'if .error then error("Stream failed; inspect original intent") else . end' | jq -jr '.choices[]?.delta.content // empty'
        ;;
    esac
  done
  test -f "$work/done" || { printf 'Incomplete stream; keep intent %s\n' "$intent" >&2; exit 1; }
else
  if [ 'task' = 'transcription' ]; then
    [ -n "${ONEASTER_AUDIO_FILE:-}" ] || { printf 'Set ONEASTER_AUDIO_FILE to a PCM WAV file\n' >&2; exit 1; }
    size=$(wc -c < "$ONEASTER_AUDIO_FILE")
    [ "$size" -ge 44 ] && [ "$size" -le 8388608 ] || { printf 'PCM WAV must be 44 bytes to 8 MiB\n' >&2; exit 1; }
    request --request POST "$base/audio/transcriptions" --header "Idempotency-Key: $intent" \
      --form-string "model=$(printf '%s' "$body" | jq -er '.model')" \
      --form-string "language=$(printf '%s' "$body" | jq -r '.language // empty')" \
      --form 'file=@-;type=audio/wav;filename=input.wav' < "$ONEASTER_AUDIO_FILE" > "$work/accepted"
  else
    printf '%s' "$body" | request --request POST "$base/tasks" --header 'Content-Type: application/json' --header "Idempotency-Key: $intent" --data-binary @- > "$work/accepted"
  fi
  task=$(jq -er 'select(.success == true) | .data.id | select(test("^[0-9a-fA-F-]{36}$"))' "$work/accepted")
  deadline=$(( $(date +%s) + 600 ))
  complete=false
  while [ "$(date +%s)" -lt "$deadline" ]; do
    request "$base/tasks/$task" > "$work/task"
    state=$(jq -er 'select(.success == true) | .data.state' "$work/task")
    if [ "$state" = 'success' ]; then
      jq -e '.data.billing_state == "settled" and .data.artifact_available == true' "$work/task" > /dev/null
      case "$(jq -r '.data.kind' "$work/task")" in
        image) request "$base/tasks/$task/content" --output result.png;;
        music) request "$base/tasks/$task/content" --output result.mp3;;
        asr) jq -er '.data.artifact.text' "$work/task";;
        video) jq -er '.data.artifact.url' "$work/task";;
        *) printf 'Unsupported task kind\n' >&2; exit 1;;
      esac
      complete=true; break
    fi
    case "$state" in failed|rejected|unknown) printf 'Task %s ended: %s\n' "$task" "$state" >&2; exit 1;; esac
    sleep 2
  done
  [ "$complete" = true ] || { printf 'Polling deadline; retain task %s\n' "$task" >&2; exit 1; }
fi

Questions and answers

Where do Suno API specifications come from?

The references below identify the sources for this model’s capabilities. Confirm current access, request limits and pricing with your service provider before integration.

Where do Suno API specifications come from?

Things to consider

Review generated results before use. Available modes and request limits depend on the service you choose; check the linked documentation before integration.

Model information sources

  • Suno API reference