> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rawchunks.space/llms.txt
> Use this file to discover all available pages before exploring further.

# Prepare a song from a vibe

> Prepare Studio fields, tagged lyrics and artwork from text, an image or a recording.

Prepare Studio fields, tagged lyrics and artwork from text, an image or a recording.

Paid requests accept [USDC session or Credits headers](https://docs.rawchunks.space/dev/guides/payments.md). Use the selected account consistently in headers and creator fields.

**Authorization** `string`

For USDC: `Bearer` followed by the complete issued session token.

For Credits, send `x-wallet-auth-token` and `x-credit-source` (`card` or `promo`). A stable `x-idempotency-key` of at most 80 characters identifies a paid service operation.

## JSON body

**prompt** `string`

At least two characters unless an image or audio is supplied.

**image** `string`

Image URL or image data URL.

**audio** `string`

Audio data URL or base64 recording.

**modelVariant** `string`

Accepted `turbo` or `sft`; audio mode is chosen on the generation request.

## NDJSON response

| Field | Type | Use |
| - | - | - |
| `status` | event | `step` describes preparation. |
| `field` | event | `field` and `value` update a Studio control. |
| `lyrics_start` | event | Clear the previous lyric buffer. |
| `lyrics_delta` | event | Append `delta` to the lyrics. |
| `cover_start` | event | Artwork preparation started. |
| `songwriter_ready` | event | Musical fields and lyrics are ready; artwork may still be running. |
| `cover` | event | `imageUrl` supplies completed artwork. |
| `done` | event | The full run finished. |
| `error` | event | `message` describes a failed run. |

## Draft fields

`field` events can set `title`, `prompt`, `instrumental`, `vocalLanguage`, `tags`, `bpm`, `keyScale` and `audioDuration`. Instrumental drafts skip vocal lyrics. [Integrate Songwriter](https://docs.rawchunks.space/dev/guides/generate/vibe.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.