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

# Suggest music settings

> Create a caption, lyrics and suggested music settings.

This returns suggestions, not an audio sample. Optional suggested fields may be absent. Translate `caption`, `key_scale`, and `duration` to `prompt`, `keyScale`, and `audioDuration` when you submit generation.

## JSON body

<ParamField body="query" type="string">
  Defaults to electronic.
</ParamField>

<ParamField body="instrumental" type="boolean" default={false} />

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

## Response (200)

Success.

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

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

<ResponseField name="bpm" type="number" />

<ResponseField name="key_scale" type="string" />

<ResponseField name="duration" type="number" />

## 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/sample" \
    -H "Content-Type: application/json" \
    --data "$(jq -nc '{
    "query": "slow electronic ballad",
    "instrumental": false,
    "vocalLanguage": "en"
  }')"
  ```
</RequestExample>


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