Generate API With Callback

Music Generation API

Overview

if you want to use callback, you need to provide a callback url, and use /api/generate to generate music.

API Endpoint

URL: POST https://udioapi.pro/api/generate
Content-Type: application/json

Authentication

Authentication is required for all API requests. Include your API key in the request headers:

Code Examples

curl
nodejs
python

Parameters:

ParameterTypeRequiredDescription
titlestringNoThe title of the music to be generated
promptstringYesThe text prompt describing the music you want to generate
gpt_description_promptstringNoAdditional prompt for GPT to help generate better music description
custom_modebooleanNoWhether to use custom mode
make_instrumentalbooleanNoWhether to generate instrumental music without vocals
modelstringNoThe model to use for generation. Available options: "chirp-v3.5", "chirp-v3.0". Default: "chirp-v3.5"
callback_urlstringNoURL to receive generation results. If provided, results will be sent to this URL. If not provided, please use generate api
clusterstringNoSpecify the cluster to use. Default: "default"

  • title: Music title
  • prompt: generate music prompt, If the content is too long, the generation will fail with "Topic too long."
  • gpt_description_prompt: Can input music style, If the content is too long, the generation will fail with "Topic too long."
  • custom_mode: This parameter exists only in the suno-v3 model.
  • make_instrumental: false,
  • model: Options include chirp-v3.0, chirp-v3.5
  • callback_url : Optional field, but it is recommended to use your own address due to potential delays with our forwarding

Custom Mode: If you want to use customMode, make sure the following parameters exist.

customModeinstrumentalRequired Parameters
truefalsestyle, prompt, title
truetruestyle, title
falsetrueprompt
falsefalseprompt

Submit Generation Task Response


Cookies

We use cookies to enhance your browsing experience and analyze site traffic.Your privacy is important to us: we do not sell or share your personal data, and your information is securely stored. By continuing to use our site, you agree to our use of cookies.
Learn more about how we handle your data in our .