Introducción
Suno v6 en SpicyAPI es una tarea de texto a música que devuelve dos versiones terminadas de una canción por solicitud, cada una un MP3 completo con voz y acompañamiento. Usted describe el estilo en prompt y, si la tiene, pone la letra que se canta en lyrics. Según Suno, v6 es su modelo confiable y preciso, y en nuestras pruebas cantó una letra palabra por palabra y en orden. Un precio fijo cubre toda la solicitud.
Funciones y aspectos destacados
Dos tomas cada vez
Cada solicitud devuelve dos versiones completas de la canción. No son fragmentos una de la otra: pueden diferir en arreglo y en duración, así que puede quedarse con la que le guste. El precio fijo cubre ambas.
Su letra, cantada tal como la escribió
Una letra de 11 líneas volvió cantada línea por línea en el orden en que la escribimos. Las etiquetas de sección como [Verse] y [Chorus] dieron forma a la estructura sin cantarse, y el coro no se repitió a menos que la letra lo repitiera.
Tres formas de manejar las palabras
Aporte su propia letra, deje que el modelo la escriba a partir de prompt (generate_lyrics está activado por defecto) o active instrumental para una pista sin voz. Los controles finos como title, vocal_gender, style_weight, weirdness, variety y las personas se aplican cuando aporta su propia letra o elige instrumental.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
prompt | Sí | El brief de estilo. Con letra propia o con instrumental activado, es solo el estilo: género, tempo, instrumentos, voz, ambiente, hasta 1000 caracteres. mínimo 1 caracteres · máximo 3000 caracteres |
lyrics | No | Las palabras que se cantan, hasta 5000 caracteres, un verso por línea. mínimo 1 caracteres · máximo 5000 caracteres |
generate_lyrics | No | Activado por defecto: cuando lyrics está vacío e instrumental está desactivado, el modelo escribe la letra a partir de prompt. La letra que usted aporta nunca se reescribe. Valor predeterminado: |
instrumental | No | Actívelo para una pista sin voz. prompt describe entonces el estilo (hasta 1000 caracteres) y lyrics no es necesario. Valor predeterminado: |
title | No | Nombre de la canción, hasta 80 caracteres. Se aplica con letra propia o con instrumental activado; con letra generada, el modelo elige el título. mínimo 1 caracteres · máximo 80 caracteres |
negative_prompt | No | Estilos, sonidos o ambientes que se deben dejar fuera de la canción, como una lista breve separada por comas, por ejemplo “harsh distortion, spoken word”. Opcional. mínimo 1 caracteres · máximo 500 caracteres |
vocal_gender | No | Inclina la voz principal hacia femenina o masculina. Es una preferencia, no una garantía, y no hemos probado con qué frecuencia se cumple. |
style_weight | No | Qué tan estrictamente sigue la canción su brief de estilo, de 0 a 1 en pasos de 0,01. |
weirdness | No | Cuánto puede alejarse la canción de lo esperado, de 0 (convencional) a 1 (arriesgado), en pasos de 0,01. Se aplica solo con letra propia o con instrumental activado. |
audio_weight | No | Cuánto influye el audio de entrada en el resultado, de 0 a 1 en pasos de 0,01. Suno no lo admite para canciones sin voz. |
variety | No | Cuánto varía el modelo su prompt de estilo, como un número entero de 0 (desactivado: sus etiquetas de estilo se usan exactamente como las escribió) a 4 (máximo). Por defecto 1. |
persona_id | No | El ID de una persona o voz de Suno guardada que cantará o interpretará la canción. Opcional. mínimo 1 caracteres · máximo 200 caracteres |
persona_model | No | Le indica al modelo qué es |
image_urls | No | Hasta 5 imágenes de ambiente (JPEG, PNG, WebP o BMP, de hasta 10 MB cada una) en las que el modelo se inspira para el carácter de la canción. máximo 5 elementos |
reference_video_urls | No | Un video de referencia (MP4, MOV o WebM, de hasta 100 MB y 241 segundos) en torno al cual se construye la canción, por ejemplo para ponerle música. máximo 1 elementos |
reference_audio_urls | No | Un archivo de audio de referencia (de 6 segundos a 30 minutos, de hasta 500 MB) que inspira la canción. máximo 1 elementos |
Precios
$0.072 / solicitud
Un precio fijo por solicitud, que cubre ambas versiones de la canción, sin importar su duración.
Casos de uso
Canciones que ya escribió
Poemas, brindis, jingles y canciones que cuentan una historia: conserve el texto, elija el género y la voz, y compare dos versiones. Las canciones duraron desde alrededor de un minuto y medio con una letra corta hasta más de dos minutos con una completa.
Música que sigue a una imagen o a un clip
Con letra generada puede enviar hasta 5 imágenes de ambiente, un video de referencia o un audio de referencia, y el modelo escribe una canción en torno a ellos. Para una base sin palabras, active instrumental.
Guía de prompts y consejos prácticos
Describa el sonido, no al artista
Escriba el género, el tempo en bpm, dos o tres instrumentos y el tipo de voz: “soft neo-soul ballad, 78 bpm, warm female lead vocal, Rhodes piano”. Los prompts que nombran a artistas reales se rechazan, así que describa el sonido.
Etiquete las secciones
Ponga [Intro], [Verse], [Chorus], [Bridge] y [Outro] en líneas propias y repita el texto del coro donde quiera que vuelva. Más líneas dan una canción más larga; no hay un ajuste de duración.
Sepa qué frena el filtro
Suno rechaza en segundos las letras y descripciones más fuertes y no las cobra. Las letras más suaves y el lenguaje fuerte sí se cantan, así que mantén lo que escribes a ese lado de la línea.
Inicio rápido de la API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.
