---
canonical_url: "https://docs.composio.dev/toolkits/words_into_music"
markdown_url: "https://docs.composio.dev/toolkits/words_into_music.md"
product: "platform"
version: null
last_updated: null
---

# Words into Music (Savuko)

Words into Music turns ideas or lyrics into generated songs and provides account, generation-job, billing-checkout, and private song-library APIs.

- **Category:** ai content generation
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `WORDS_INTO_MUSIC`
- **Version:** 00000000_00

## Tools

### Create Checkout Link

**Slug:** `WORDS_INTO_MUSIC_CREATE_CHECKOUT_LINK`

Create an unpaid, account-bound Stripe checkout URL for a current offer that the user explicitly approved. This action only creates a URL: it does not purchase anything, charge the user, activate a subscription, or add song credits. Payment can occur only later on Stripe.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `kind` | string ("subscription" | "pack") | Yes | Type of current offer that the user explicitly approved. |
| `offer` | string ("starter" | "creator" | "studio" | "small" | "medium" | "large") | Yes | Current offer ID from GET_ACCOUNT_USAGE that the user explicitly approved. Subscriptions use starter, creator, or studio; packs use small, medium, or large. |
| `locale` | string ("en" | "es" | "de" | "fr" | "pt-BR" | "it" | "nl" | "pl" | "sv" | "ja" | "ko") | No | Locale for the unpaid hosted checkout page. |
| `interval` | string ("month" | "year") | No | Billing interval required for a subscription; omit for a pack. |
| `confirmed` | boolean | Yes | Must be exactly true, and only after the user explicitly approves the current offer returned by GET_ACCOUNT_USAGE. |
| `request_key` | string | Yes | Stable 16-80 character idempotency key for this checkout-link intent; reuse it when retrying the same request. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Usage

**Slug:** `WORDS_INTO_MUSIC_GET_ACCOUNT_USAGE`

Return available and reserved song credits, the per-song credit cost, supported languages, and current checkout offers for the connected account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Song

**Slug:** `WORDS_INTO_MUSIC_GET_SONG`

Return one song owned by the connected account, optionally including its lyrics. The returned URL is a private owner-only library page requiring the owner's sign-in, not a public stream or audio download URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `song_id` | string | Yes | ID of a song in the connected account's private library. |
| `include_lyrics` | boolean | No | Set true to include lyrics; lyrics are omitted by default. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Song Job

**Slug:** `WORDS_INTO_MUSIC_GET_SONG_JOB`

Return the current status of one song-generation job and its completed private song record when ready. Poll no more often than once every 15 seconds, and honor a longer next_check_after_seconds delay when returned.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | Generation job ID returned by START_SONG_WITH_ONE_CREDIT. Wait at least 15 seconds between checks and, when returned, wait at least next_check_after_seconds before checking again. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Songs

**Slug:** `WORDS_INTO_MUSIC_LIST_SONGS`

Return one newest-first page from the connected account's private song library and a cursor for the next page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum songs to return in this page, from 1 through 20. |
| `cursor` | string | No | Opaque cursor returned as next_cursor by the previous call; omit or pass null for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Prepare Song

**Slug:** `WORDS_INTO_MUSIC_PREPARE_SONG`

Validate and prepare a song brief for one hour without starting generation or spending a song credit. Preparation spends zero credits and returns a prepared request ID for the separate start action.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `idea` | string | No | Song concept or story for idea mode. |
| `mode` | string ("idea" | "lyrics") | No | Whether to generate from an idea or from supplied lyrics. |
| `title` | string | No | Optional song title. |
| `lyrics` | string | No | Complete supplied lyrics for lyrics mode. |
| `language` | string ("en" | "es" | "de" | "fr" | "pt-BR" | "it" | "nl" | "pl" | "sv" | "ja" | "ko") | No | Language for generated or supplied lyrics. |
| `direction` | string | Yes | Musical direction covering style, instruments, mood, tempo, and vocal delivery. |
| `ui_locale` | string ("en" | "es" | "de" | "fr" | "pt-BR" | "it" | "nl" | "pl" | "sv" | "ja" | "ko") | No | Locale for provider messages and account-facing UI links. |
| `request_id` | string | Yes | Unique stable ID for this exact song brief. Reuse it for retries and use a new ID only when the brief changes. |
| `instrumental` | boolean | No | Set true to request music without vocals. |
| `duration_seconds` | integer | No | Requested song duration in seconds, from 60 through 180. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Song Using One Existing Credit (No Credit Purchase)

**Slug:** `WORDS_INTO_MUSIC_START_SONG_WITH_ONE_CREDIT`

Start generation from a prepared request. Success reserves and spends exactly one existing song credit; this action never purchases credits or opens checkout. If no credit is available, it returns an actionable PAYMENT_REQUIRED error with the preserved prepared request ID, current offers, and checkout routing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `prepared_request_id` | string | Yes | Prepared request ID from PREPARE_SONG. A successful call reserves exactly one existing song credit and never purchases credits. Reuse this same ID after a timeout or after adding credits so a duplicate song is not prepared. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
