---
title: "Convert Prompt to Lyrics"
method: GET
path: "/v1/prompt_to_lyrics"
---

# Convert Prompt to Lyrics

`GET /v1/prompt_to_lyrics`

## Request

- Base URL: `https://api.musicgpt.com/api/public`
- URL: `https://api.musicgpt.com/api/public/v1/prompt_to_lyrics`
- Auth: API key in header `Authorization`

This endpoint takes a natural language prompt (e.g., a theme, vibe, or idea) and generates original lyrics based on it. If the prompt has been used before, a variation may be returned. It also estimates the credit cost of generation.

## Query parameters

- `prompt` string, required

## Response `200`

Lyrics generated successfully

- object
  - `success` boolean
  - `task_id` string
  - `message` string
  - `lyrics` string
  - `credit_estimate` integer

## Other responses

- `400`: Invalid prompt input
- `500`: Internal server error during lyrics generation

---

[API](https://skmtc.dev/musicgpt/apis/musicgpt-api.md) - [All operations](https://skmtc.dev/musicgpt/apis/musicgpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/musicgpt/apis/musicgpt-api/revisions/6753dccf4c5d?raw)