> ## 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.

# Format lyrics and description

> Format a music description and optional lyrics.

This returns text, not audio. [Prepare lyrics and settings](/dev/guides/generate/lyrics).

## JSON body

<ParamField body="prompt" type="string" required>
  Minimum length: `1`.
</ParamField>

<ParamField body="lyrics" type="string" />

## Response (200)

Success.

<ResponseField name="formatted_caption" type="string" required />

<ResponseField name="formatted_lyrics" type="string" required />

## Errors

Failed JSON responses contain an `error` string. Check the HTTP status before reading a successful result. See [job handling](/dev/guides/jobs) for interrupted or uncertain submissions.

| Status | Meaning |
| - | - |
| `400` | Invalid request. |
| `500` | Request failed. |

<RequestExample>
  ```bash cURL theme={null}
  curl --fail-with-body -X POST "$RAWCHUNKS_API/api/generation/format" \
    -H "Content-Type: application/json" \
    --data "$(jq -nc '{
    "prompt": "acid house with a dry kick",
    "lyrics": "[Verse]\nThe city hums below"
  }')"
  ```
</RequestExample>


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