Suno (Kie.ai) icon

Suno (Kie.ai)

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

Actions16

Create Music Video

AI-generated

Summary

Create a music video based on a previously generated music task by providing its Task ID. Optionally, specify a webhook URL and reference to receive asynchronous notifications, and choose whether to wait synchronously for the task to complete.

Inputs

  • Task ID (required) — The identifier of the source music task to create a music video for.
  • Reply URL — An optional webhook URL to be called when the music video creation task completes.
  • Reply Ref — An optional custom reference string passed back in the webhook callback.
  • Wait for Completion — Whether to synchronously wait for the music video creation task to finish (polls every 3 seconds, with a 5-minute timeout). Defaults to true.

Output shape

a single JSON object or array of JSON objects containing the task creation response or the completed task details if waiting for completion is enabled.

If 'Wait for Completion' is true, the operation polls the task status until completion or timeout and returns detailed task results; otherwise, it returns the immediate task creation response including the task ID. Webhook parameters, if provided, are included in the request to receive asynchronous callbacks.

Examples

Example 1: Create a music video for a given music generation task and wait for the result synchronously.

Specify the source music Task ID, ensure 'Wait for Completion' is enabled, and optionally set a 'Reply URL' for webhook notifications.

Links

Discussion