Ai Song Generator

---

TL;DR

• Input: Lyrics text (required) + optional title, tags, language, duration
• Output: Song URL + thumbnail + metadata
• Use it for: Content, jingles, demos, automation, prototyping
• Result time: Usually under 2 minutes

---

Table of contents

• Try it now
• Overview
• Usage examples
• Features
• Configuration
• Usage
• Output
• For bloggers & tutorial writers
• Integration
• Technical details
• FAQ
• Resources

---

Try it now

Action	Link
Run in Apify Console	Open Actor → Start
API (sync)	POST https://api.apify.com/v2/acts/YOUR_USERNAME~ai-song-generator/run-sync

Replace YOUR_USERNAME with your Apify username.

---

Overview

The AI Song Generator creates songs from lyrics using the MultipleWords lyrics-to-melody API. You provide lyrics (verses, choruses, mood), and the Actor returns a generated song URL, thumbnail, and structured metadata.

This Actor is useful when you need songs on demand, at scale, or as part of an automated workflow.

Common use cases

Category	Examples
Content	YouTube, podcasts, social media, background music
Marketing	Jingles, product launches, branded audio
Automation	Scheduled songs, bots, workflows
Development	Prototypes, demos, A/B testing, pipelines

Note: Usage rights depend on the upstream API and your Apify plan. Review terms before commercial use.

---

Usage examples

Paste lyrics into the Lyrics field or API input.

Scenario	Lyrics (excerpt)
Folk / reflective	Thought I found my footing, now I'm slipping again…
Hope / dreams	Create a beautiful melody for these lyrics about hope and dreams
Custom title + tags	Lyrics + title: "Slipping Away", tags: "folk"

Example input

{
  "lyrics": "Thought I found my footing, now I'm slipping again\nFelt the ground beneath me, then it crumbled within\nTried to hold on to a feeling, but it just won't stay\nEvery step I take seems to lead me astray",
  "title": "Slipping Away",
  "tags": "folk",
  "language": "English",
  "audioDuration": 60
}

---

Features

• Lyrics-to-song generation from a single lyrics input
• Clean JSON output for easy integration
• Works in bulk via API
• Input validation and retries with exponential backoff
• Runs fully on Apify (Console, API, automation tools)
• Optional audio settings (duration, reference audio, style)

---

Configuration

All settings are provided via the Actor input.

Input parameters

Parameter	Type	Required	Default	Description
lyrics	string	Yes	—	Lyrics text to convert to melody
title	string	No	A gentle breeze,	Title of the song
tags	string	No	folk	Tags/style (e.g. folk, pop)
language	string	No	English	Language of the lyrics
country	string	No	India	Country/locale
audioDuration	number	No	41	Target audio duration (seconds)
audio2audioEnable	boolean	No	true	Enable audio-to-audio processing
refAudioStrength	number	No	0.2	Reference audio strength (0–1)
refFileUrl	string	No	—	Optional reference audio URL
publicStatus	boolean	No	true	Whether the song is public

Lyrics tips

• Write complete verses and choruses for better results
• Use line breaks to help melody structure
• Mention mood or genre in lyrics or tags
• Specify language and country for localized output

---

Usage

Apify Console

1. Open the Actor in Apify Console.
2. Enter lyrics in the Lyrics field (or use the default).
3. Optionally set Title, Tags, Language, Audio duration.
4. Click Start and check the Output tab for the song URL and metadata.

API (run-sync)

Replace YOUR_USERNAME with your Apify username and YOUR_API_TOKEN with your Apify API token.

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~ai-song-generator/run-sync?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"lyrics": "Thought I found my footing, now I am slipping again.", "title": "Slipping Away"}'

Response includes runId, status, and dataset items with shortUrl, shortId, and details.

---

Output

Each run writes one or more items to the default dataset. The Output tab shows organized tables (via the output schema). Each item looks like:

Field	Description
status	API status (1 = success)
shortId	Unique identifier for the generated song
shortUrl	Direct URL to access the generated song
details	Full metadata (title, thumbnail, output URLs, job status, etc.)
timestamp	When the result was saved

Key fields in details

Field	Description
shortTitle	Title of the generated song
shortThumbnail	URL of the song thumbnail image
shortUrlOutput1–shortUrlOutput4	Output URLs for different versions
shortsGenerateJobStatus	Status of the generation job
timestamp	When the song was created
isPublic	Whether the song is publicly accessible

Example output (dataset item)

{
  "status": 1,
  "shortId": 123456,
  "shortUrl": "https://example.com/song/123456",
  "details": {
    "shortTitle": "Slipping Away",
    "shortThumbnail": "https://example.com/thumbnail.jpg",
    "shortUrlOutput1": "https://example.com/output1.mp3",
    "shortsGenerateJobStatus": 1,
    "timestamp": "2026-01-27T12:00:00.000Z",
    "isPublic": true
  },
  "timestamp": "2026-01-27T12:00:00.000Z"
}

In the Apify Console Output tab you can open Song URL as a link or copy it for use in players, downloads, or automation.

---

For bloggers & tutorial writers

You can use this Actor in tutorials, blog posts, or videos without running it first:

• Input: Use the Example input or Usage examples table.
• Output: Use the Example output above to show what users get.
• API: Use the API (run-sync) curl example; remind readers to replace YOUR_USERNAME and YOUR_API_TOKEN.

For promotion ideas, copy-paste posts, and where to share, see PROMOTION.md in this repo.

---

Integration

• Make (Integromat) — Use the Apify module and select this Actor; map your lyrics to the Lyrics input.
• Zapier — Use the Apify Zapier app and choose "Run Actor"; select this Actor and pass the lyrics.
• Custom apps — Call the Apify API (/run or /run-sync) with the same input JSON.

---

Technical details

• Runtime: Node.js (see Dockerfile).
• Input: Validated against the input schema; invalid input returns a clear error.
• External API: Uses MultipleWords lyrics-to-melody API; failures are retried with exponential backoff.
• Output schema: Results are displayed in organized tables in the Apify Console Output tab (see Output schema).

---

FAQ

How long does a run take?
Usually under 2 minutes for a single lyrics input.

Can I run multiple lyrics in one go?
Each run processes one input. For bulk, use the API or automation tools (e.g. Make/Zapier) to run the Actor multiple times.

Where is the audio stored?
The audio is hosted by the upstream API. The Actor returns the URL; you can stream or download it.

Do I need an API key for the song API?
The Actor uses its own integration; you only need your Apify account and (for API calls) your Apify API token.

What audio formats are supported?
Output URLs typically point to standard audio formats (e.g. MP3). Check the API response for exact formats.

---

Resources

• Apify Console — Run the Actor and view datasets
• Apify API — Run actors programmatically
• Output schema (Apify docs) — How output is displayed
• PROMOTION.md — How to promote this Actor and grow your user base
• .actor/CHANGELOG.md — Version history