---
title: "Generate Sounds"
method: POST
path: "/api/v1/generate/sounds"
---

# Generate Sounds

`POST /api/v1/generate/sounds`

Used for creating a sound generation task (Sounds Task). It supports settings for looping, tempo (BPM), pitch (Key), as well as lyrics subtitle capture, etc.

## User Guide
- Generate corresponding audio content based on input `prompt`
- Supports loop playback for background music and ambient sound scenarios
- Supports BPM and Key controls for style shaping
- Optional lyrics subtitle capture after generation
- Supports async task completion notifications via callback URL

## Request body

- object
  - `prompt` string, required — Prompt text for sound generation. Maximum 500 characters.
  - `model` 'V5', required — Model name. Sounds tasks only support `V5`.
  - `soundLoop` boolean — Whether to enable loop playback for the generated sound.
  - `soundTempo` integer, nullable — BPM (beats per minute). If omitted, Auto is used.
  - `soundKey` 'Any' | 'Cm' | 'C#m' | 'Dm' | 'D#m' | 'Em' | 'Fm' | 'F#m' | 'Gm' | 'G#m' | 'Am' | 'A#m' | 'Bm' | 'C' | 'C#' | 'D' | 'D#' | 'E' | 'F' | 'F#' | 'G' | 'G#' | 'A' | 'A#' | 'B' — Pitch key of generated sound. Default is `Any`.
  - `grabLyrics` boolean — Whether to fetch lyric subtitle data after task completion.
  - `callBackUrl` string, uri — Callback URL for asynchronous task completion notifications.

## Response `200`

Request successful

- object
  - `code` 200 | 400 | 401 | 404 | 405 | 413 | 429 | 430 | 455 | 500 — # Status Codes - ✅ 200 - Request successful - ⚠️ 400 - Invalid parameters - ⚠️ 401 - Unauthorized access - ⚠️ 404 - Invalid request method or path - ⚠️ 405 - Rate limit exceeded - ⚠️ 413 - Theme or prompt too long - ⚠️ 429 - Insufficient credits - ⚠️ 430 - Your call frequency is too high. Please try again later. - ⚠️ 455 - System maintenance - ❌ 500 - Server error
  - `msg` string — Error message when code != 200
  - `data` object
    - `taskId` string — Task ID for tracking sound generation status

## Other responses

- `500` — Server error

---

[API](https://skmtc.net/sunoapi/apis/file-upload-api.md) · [All operations](https://skmtc.net/sunoapi/apis/file-upload-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sunoapi/file-upload-api/versions/22d45ee33a4a/schema)