---
title: "POST /suno/v1/sounds"
method: POST
path: "/suno/v1/sounds"
---

# POST /suno/v1/sounds

`POST /suno/v1/sounds`

## Request body

- object
  - `sound` string, required — Describe the sound you want.
  - `mv` 'chirp-v5-5' | 'chirp-v5', required — Model to use.
  - `type` 'one-shot' | 'loop', required — Sound effect type: `one-shot` for a single-hit effect, `loop` for a looping effect.
  - `bpm` integer — Tempo in beats per minute. Valid range: 1 to 300 bpm.
  - `key` 'C' | 'C#' | 'Cm' | 'C#m' | 'D' | 'D#' | 'Dm' | 'D#m' | 'F' | 'F#' | 'Fm' | 'F#m' | 'G' | 'G#' | 'Gm' | 'G#m' | 'A' | 'A#' | 'Am' | 'A#m' | 'B' | 'B#' | 'Bm' | 'B#m' — Key
  - `isStorage` boolean — Whether to store the generated audio. - **true**: The audio will be stored and a TTAPI CDN URL will be returned - **false**: The original source URL will be returned
  - `hookUrl` string — Callback notification URL

## Response `200`

Request successful

- object
  - `status` string, required
  - `message` string, required
  - `data` object, required

## Other responses

- `400` — Parameter error
- `401` — Authorization failed

---

[API](https://skmtc.net/ttapi/apis/flowmusic-api-docs.md) · [All operations](https://skmtc.net/ttapi/apis/flowmusic-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ttapi/flowmusic-api-docs/versions/f27f8a59dbd0/schema)