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

# Convert Prompt to Lyrics

`GET /v1/prompt_to_lyrics`

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.net/musicgpt/apis/musicgpt-api.md) · [All operations](https://skmtc.net/musicgpt/apis/musicgpt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/musicgpt/musicgpt-api/revisions/6753dccf4c5d/schema)