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 Mini 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-mini/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-mini/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 Mini
¿Cuánto cuesta la API de Suno v6 Mini?
Suno v6 Mini 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 Mini en la API?
Pon suno/v6-mini/text-to-audio para Música en el campo model de POST /jobs/createTask.
¿Qué es v6 Mini?
Suno describe v6 Mini como una versión más rápida y eficiente de v6 que facilita convertir una idea en canción, y dice que es la versión disponible para todos. Se lanzó el 9 de septiembre de 2026 con v6 y v6 Wild.
¿El manejo de la letra es el mismo que en v6?
En nuestras pruebas, sí: los tres cantaron la misma letra limpia de 11 líneas palabra por palabra y en orden, con las etiquetas de sección en silencio. No clasificamos su sonido.
¿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 masculina cálida. 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 sola frase salió como solista en nuestra prueba.
¿Qué límites tiene la API de Suno v6 Mini?
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 Mini sin escribir código?
Sí. El Playground ejecuta Suno v6 Mini 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
- 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
