API de generación de letras

Actualizado el 2026-09-18 · equipo de Suno-API

Descripción del endpoint

La generación de letras crea o reescribe letras a partir de un tema, el contexto de letras existentes y requisitos de estilo. Este endpoint ya está actualizado al contrato más reciente de generación de letras y puede usarse directamente para la generación en modo profesional.

Endpoint: POST /api/lyrics/generate

Facturación: Gratis dentro de la cuota (como máximo 10 llamadas por minuto y 300 al día por usuario); por encima de la cuota gratuita cuesta 0,1 CNY por llamada.

Detectar el exceso: cuando se supera la cuota gratuita la petición se ejecuta igualmente con normalidad y las cabeceras de respuesta incluyen X-Suno-Helper-Free: false y X-Suno-Helper-Over-Limit: minute (o day), de modo que el cliente puede avisar de que esa llamada se ha cobrado.

Modelo recomendado: suno-v6. Se pueden usar suno-v6, suno-v6-wild y suno-v6-mini.

Autenticación

Parámetro	Tipo	Obligatorio	Notas
Authorization	string	sí	`Bearer YOUR_API_KEY`
Content-Type	string	sí	`application/json`

Parámetros de la petición

Parámetro	Tipo	Obligatorio	Por defecto	Notas
model	string	sí	-	Nombre de modelo para el cliente: `suno-v6`, `suno-v6-wild` o `suno-v6-mini`
instruction	string	sí	-	Tema de la letra o requisito de generación
style	string	no	-	Requisito de estilo
title	string	no	-	Título de la canción o restricción de título
selected	string	no	`""`	El texto seleccionado que se va a reescribir
context_before	string	no	`""`	Contexto anterior
context_after	string	no	`""`	Contexto posterior
mode	string	no	`apply_user_request`	Modo de generación de letras
references	array	no	`[]`	Lista de material de referencia
num_variants	integer	no	`null`	Número deseado de variantes de letra
lyricist_id	string	no	`null`	ID de un letrista concreto (la lista de letristas está retirada; no se recomienda integrarla de nuevo)
metadata	object	no	-	Parámetros extendidos; admite `lyrics_model` y `enable_thinking`
lyrics_project_id	string	no	`null`	ID de un proyecto de letras existente (la serie de proyectos de letras está retirada; no se recomienda integrarla de nuevo)

instruction también acepta los campos antiguos theme y prompt. metadata.lyrics_model es default por defecto y metadata.enable_thinking es false por defecto.

Control del idioma

Este endpoint no tiene un campo de petición language independiente. El idioma de la letra lo decide el contenido de instruction; style solo puede desempeñar un papel auxiliar.

Para generar una letra en chino, indica el idioma objetivo de forma explícita en instruction, por ejemplo:

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

También puedes escribir "Write the lyrics in Chinese about ...". Para generar una letra en inglés, escribe "请用英文写歌词" o "Write the lyrics in English". Si solo envías un tema en inglés sin indicar el idioma objetivo, el resultado puede ser en inglés.

Ejemplo de petición

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "Una letra en español sobre la temporada de graduación y volver a empezar",
    "style": "pop rock, sincero, estribillo memorable",
    "title": "Volver a empezar",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Respuesta

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nEl viento cruza el patio\nNos despedimos de ayer",
    "edited_lyrics": "[Verse]\nEl viento cruza el patio\nNos despedimos de ayer",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics es la letra completa que debe escribirse en el cuadro de letras. lyrics_id y lyrics_request_id sirven para el seguimiento y pueden llegar vacíos según lo que devuelva el endpoint; no los trates como IDs de canción.

Notas de compatibilidad

Los campos antiguos theme y prompt siguen funcionando y se asignan a instruction.
La serie de endpoints de proyectos de letras / letristas está retirada: si necesitas conservar los resultados generados, guarda tú mismo el edited_lyrics que devuelve el endpoint.

SiguienteAPI de clonación de voz y generación con voz (no recomendado)

Obtener una clave de API

Crea una clave de API en la consola después de registrarte. Cada generación cuesta 0,6 ¥ y devuelve 2 pistas, las descargas son ilimitadas y no hace falta número de teléfono.

Obtener clave de API Volver al resumen