Por ahora esta guía solo está en inglés. →
Parámetros de la petición
| Parámetro | Obligatorio | Descripción |
|---|---|---|
audio_weight | No | How strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only. ≥ 0 · ≤ 1 |
generate_lyrics | No | Let the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off. Por defecto: true |
image_urls | No | Imágenes que marcan el ambiente; la música toma su sensación de ellas. |
instrumental | No | Solo música, sin voces. Por defecto: false |
lyrics | No | Escribe tu propia letra o deja que la escriba el modelo. |
negative_prompt | No | Estilos o sonidos que no quieres en la pista. |
persona_id | No | ID of an existing Suno persona to reuse its style or voice. |
persona_model | No | Whether persona_id is a style persona or a voice persona. style_persona · voice_persona |
prompt | Sí | Describe the song: genre, mood, tempo, instruments and voice. With lyrics or an instrumental this is the style (up to 1,000 characters); with no lyrics the model writes the words from it. |
reference_audio_urls | No | Audio que imitar: una voz, una música o un ritmo. |
reference_video_urls | No | Un vídeo al que la música debe ajustarse. |
style_weight | No | How closely to follow the style in the prompt, from 0 to 1. ≥ 0 · ≤ 1 |
title | No | Song title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song. |
variety | No | How different the two versions are from each other: 0 off, 1 normal (the model default), 2 high, 3 extra, 4 max. ≥ 0 · ≤ 4 |
vocal_gender | No | Make a female or male lead vocal more likely. Applies with lyrics. female · male |
weirdness | No | How experimental the song may get, from 0 (conventional) to 1 (unusual). ≥ 0 · ≤ 1 |
Precios
Los precios están en créditos, los mismos que usas en la web (1 crédito = 0,01 $). El importe se retiene cuando se acepta la tarea y se liquida al coste real cuando termina; las tareas fallidas se reembolsan.
| Opción | Créditos por generación | ≈ USD |
|---|---|---|
| Estándar | 10,8 | 0,11 US$ |
Cada tarea se redondea al alza a créditos enteros, así que una ejecución en el nivel más bajo cuesta 11 créditos por generación (0,11 US$).
Para saber la cifra exacta antes de ejecutar, envía el mismo cuerpo a POST /jobs/quote.
Inicio rápido de la API
Llama a la API de Suno v6 en tres pasos
- Crea una clave de API. Inicia sesión en PopNow y crea una clave en la consola de la API. Las claves empiezan por sk-popnow- y usan los mismos créditos que el sitio web.
- Envía la solicitud. Haz POST /jobs/createTask con model suno/v6/text-to-audio y un objeto input según la tabla de parámetros. La respuesta devuelve un ID de tarea al instante.
- Obtén el resultado. Consulta GET /jobs/recordInfo con el ID de tarea, o pasa una callBackUrl y te enviamos el resultado ahí. Descarga los enlaces de salida cuando la tarea termine bien.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Sustituye el prompt y los enlaces por los tuyos. La pestaña API tiene la referencia de la respuesta, el sondeo y el callback.
Preguntas sobre la API de Suno v6
¿Cuánto cuesta la API de Suno v6?
Suno v6 cuesta 11 créditos (0,11 US$) por generación. Los créditos son los mismos que en la web (1 crédito = 0,01 $), las cuentas nuevas reciben 30 créditos gratis y las tareas fallidas se reembolsan.
¿Cuál es el nombre de modelo de Suno v6 en la API?
Pon suno/v6/text-to-audio para Música en el campo model de POST /jobs/createTask.
¿Qué dice Suno sobre v6?
Según Suno, v6 es confiable, preciso y entrega de forma constante música pulida en todos los géneros y estilos. Se lanzó el 9 de septiembre de 2026 junto con v6 Wild y v6 Mini.
¿Cantará mi letra exactamente?
En nuestras pruebas con la configuración por defecto, sí. Una letra de 11 líneas se cantó palabra por palabra en el orden escrito; las etiquetas de sección como [Chorus] no se cantaron y el coro no se repitió por su cuenta.
¿Se me cobra si una solicitud es rechazada o falla?
No. El monto retenido para la solicitud se libera por completo.
¿Puedo elegir quién canta?
En parte. Describa la voz en el brief de estilo, por ejemplo una voz femenina segura. Con letra propia o con instrumental activado también puede fijar vocal_gender en female o male; es una preferencia, no una garantía, y no hemos medido con qué frecuencia se cumple. Un dúo pedido en una idea de una sola frase salió como solista en nuestra prueba, así que nombre una sola voz si le importa.
¿Qué límites tiene la API de Suno v6?
Imágenes de referencia: 5; Audio de referencia: 1; Vídeos de referencia: 1; Longitud del prompt (caracteres): 3,000. Las peticiones fuera de estos límites se rechazan antes de cobrar nada.
¿Puedo probar Suno v6 sin escribir código?
Sí. El Playground ejecuta Suno v6 con tus créditos de PopNow, no necesita clave API y te muestra el código de cada generación.
Todos los modelos de Suno
Suno v6 es el fiable para canciones que ya tienes en la cabeza. v6 Wild toma giros más sorprendentes y con más textura, y v6 Mini es el cuaderno de bocetos rápido, todos al mismo precio por ejecución.
- API de Suno v6Canciones completas con voz a partir de tu letra o una breve ideaDesde 11 créditos por generación
- API de Suno v6 MiniDos canciones rápidas con voz a partir de una fraseDesde 11 créditos por generación
- API de Suno v6 WildCanciones experimentales y con textura, con vozDesde 11 créditos por generación
