Wiro - Video Background Music Generator icon

Wiro - Video Background Music Generator

Adds AI-generated background music to videos

Overview

This node, "Wiro - Video Background Music Generator," adds AI-generated background music to a video file. Users provide a video URL or upload a video, and the node generates background music tailored either automatically or guided by a user prompt describing style, genre, or mood. It is useful for content creators, video editors, and marketers who want to enhance videos with custom background music without manually composing or sourcing tracks.

Practical examples:

  • Automatically generate ambient music for a travel vlog video.
  • Create upbeat background music for a promotional product video by specifying a "happy" or "energetic" mood.
  • Add cinematic orchestral music to a short film clip by entering a relevant style prompt.

Properties

Name Meaning
Enter Your Video URL Upload a video file or paste a URL to which the background music will be applied.
Prompt Optional text guiding the music generation style, genre, or mood. Leave blank for auto mode.
Tokens Number of tokens controlling the length of the generated music (affects generation detail).
Scale Classifier-free guidance scale influencing creativity vs. adherence to prompt (numeric).
Background Music Volume Volume level for the generated background music, from 0.0 (mute) to 1.0 (full volume).

Output

The node outputs a JSON object with the following structure:

{
  "taskid": "string",      // The unique identifier of the music generation task
  "url": "string",         // URL to the generated video with background music (empty if failed)
  "status": "string"       // Status of the task: "completed" or "failed"
}
  • taskid helps track the generation process.
  • url provides access to the final video with the added background music once completed.
  • status indicates whether the music generation succeeded or failed.

No binary data output is produced directly by this node.

Dependencies

  • Requires an API key credential for the Wiro AI service.
  • Makes HTTP POST requests to the Wiro API endpoint for video background music generation.
  • Uses a polling mechanism to wait until the asynchronous music generation task completes.
  • Requires network access to https://api.wiro.ai.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Providing an invalid or inaccessible video URL may result in task failure.
    • Network connectivity problems can interrupt communication with the Wiro API.
    • Incorrect parameter values (e.g., non-numeric tokens or scale) might cause unexpected errors.

  • Error messages:

    • If the API response lacks a valid task ID or socket token, the node throws an error indicating an invalid response from the Wiro API.
    • Task status codes -1, -2, -3, or -4 indicate failure states; users should verify input parameters and API usage limits.

  • Resolution tips:

    • Ensure the API key and secret are correctly configured.
    • Verify the video URL is publicly accessible or properly uploaded.
    • Use valid numeric strings for tokens and scale properties.
    • Check network connectivity and retry if transient errors occur.

Links and References

Discussion