Submit Music Generation Task

Authorizations

Authorization

string

header

required

Authenticate using Bearer token. Get your API Key from the WeryAI Console.

Example: Authorization: Bearer sk-xxxxxxxxxxxxxxxx

Body

application/json

At least one of description or styles must be provided.

type

string

required

Music type. Supported values: VOCAL_SONG, ONLY_MUSIC.

Example:

"VOCAL_SONG"

description

string

Describe the song style, mood, instruments, etc. Used as the generation prompt. Required if styles is not provided.

Example:

"A cheerful pop song about summer vacation"

lyrics

string

Lyrics content. If not provided, AI will auto-generate lyrics. Not applicable for ONLY_MUSIC type.

Example:

"Sunshine on my face, wind in my hair\nSummer days without a care"

reference_audio

string<uri>

Reference audio file URL for style guidance

Example:

"https://example.com/reference.mp3"

audio_name

string

Name of the reference audio file

Example:

"reference_track"

gender

string

Singer gender, recommended for VOCAL_SONG type. Supported values: m, f.

Example:

"f"

styles

object

Music style tags as key-value pairs. Keys must be valid style enum names (uppercase), values are the style descriptions used in generation.

Required if description is not provided.

Available style keys by category:

Category	Available Keys
Genre	`POP`, `ROCK`, `RAP`, `ELECTRONIC`, `RNB`, `JAZZ`, `FOLK`, `CLASSIC`, `WORLD`
Emotion	`HAPPY`, `RELAXED`, `WARM`, `ROMANTIC`, `TOUCHING`, `SAD`, `LONELY`, `DEPRESSED`, `TENSE`, `EXCITED`, `EPIC`, `MYSTERIOUS`
Instrument	`PIANO`, `GUITAR`, `BASS`, `DRUMS`, `STRINGS`, `WIND`, `SYNTHESIZER`, `ELECTRONIC_SOUND`, `FOLK_INSTRUMENT`, `MIXED_ORCHESTRATION`

You can combine multiple styles across categories.

Show child attributes

Example:

{
  "POP": "pop",
  "HAPPY": "happy",
  "PIANO": "piano"
}

webhook_url

string<uri>

Callback URL where results will be sent when task completes

Example:

"https://your-server.com/webhook"

caller_id

integer<int64>

Caller ID (for business association)

Response

Task submitted successfully

status

integer

Business status code (0 indicates success)

Example:

0

desc

string

Status description

Example:

"success"

message

string

Multi-language message

Example:

"success"

data

object

Show child attributes

Getting started

API Reference

Submit Music Generation Task

Authorizations

Body

Response