Generate AI sound effects — loops or one-shot samples
Endpoint
POST /api/v1/music/soundfx
Asynchronous. Returns a task_id. Poll Get Task for results.Generate custom sound effects described in plain text. Suitable for game audio, UI sounds, ambient effects, and music production samples. Supports Chinese and English descriptions.
Request body
Field
Type
Required
Description
sound_desc
string
Yes
Text description of the sound. Supports Chinese and English (e.g. "heavy rain on a tin roof" or "雨打在屋顶上的声音").
sound_type
string
No
"loop" for a looping sample or "one-shot" for a single-play sound. Default: "one-shot".
sound_bpm
integer
No
Beats per minute (for looping effects).
sound_key
string
No
Musical key (e.g. "C", "Am").
mv
string
No
Model version override.
callback_url
string
No
Webhook URL for completion notification. See Webhooks.