Suno (Kie.ai) icon

Suno (Kie.ai)

Generate music, lyrics, and audio processing using Suno via Kie.ai API

Actions16

Generate Sound Effect

AI-generated

Summary

Generate a sound effect audio using a text prompt with optional musical parameters and receive immediate or webhook-notified results.

Inputs

  • Sound Prompt (required) — Text description of the sound effect to generate.
  • Loop — Whether to generate a loopable sound effect.
  • BPM — Beats per minute to apply (0 to auto-detect).
  • Key — Musical key for the sound effect, e.g. "C major" or "A minor".
  • Reply URL — Webhook URL to call when the generation task completes asynchronously.
  • Reply Ref — Custom reference string returned back in the webhook callback.
  • Wait for Completion — Whether to wait for the generation task to complete before returning (polls status every 3 seconds, with a 5-minute timeout).

Output shape

A single JSON object per input item containing the generation task details or the completed sound effect metadata.

If 'Wait for Completion' is true (default), the node polls the task status endpoint until the sound effect generation completes or times out and returns the final task data. Otherwise the node returns immediately with the task creation response. If a 'Reply URL' is provided, the external webhook will be called upon completion.

Examples

Example 1: Generate a short explosion sound effect with looping enabled and wait for the task to finish

Set 'Sound Prompt' to 'explosion with debris and echo', enable 'Loop', leave BPM and Key empty, and keep 'Wait for Completion' enabled.

Links

Discussion