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 Wild 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-wild/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-wild/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 Wild
¿Cuánto cuesta la API de Suno v6 Wild?
Suno v6 Wild 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 Wild en la API?
Pon suno/v6-wild/text-to-audio para Música en el campo model de POST /jobs/createTask.
¿Es Wild mejor que v6?
En ninguna medida que podamos afirmar. Tiene otro carácter, así que pruebe ambos con el mismo brief y compare las dos versiones que devuelve cada uno.
¿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 de tono elevado. 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.
¿Qué límites tiene la API de Suno v6 Wild?
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 Wild sin escribir código?
Sí. El Playground ejecuta Suno v6 Wild 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
