Audio

Suno V5

La API de Suno genera música con calidad de estudio a partir de prompts, estilos y letras, devolviendo dos pistas por ejecución con entrega asíncrona optimizada para producción.

$0.12 / use

2 pistas por ejecuciónFlujo de trabajo asíncronoControl de prompt y letrasMP3 + portada

Parámetros

Model Version*

Custom Mode*

Activado

Title*

Style of Music*

Lyrics (optional but recommended)

Instrumental Only*

Desactivado

Vocal Gender Preference

Salida

El contenido generado aparecerá aquí

Puntos de acceso

POSThttps://api.apixo.ai/api/v1/generateTask/sunoCrear tarea

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}Estado de la consulta

Autenticación

Comprobando acceso a la API...

Inicie sesión para reclamar créditos gratuitos, probar el Playground y continuar con la integración de la API.

Cuerpo de la solicitud

request_type

async

Use callback con callback_url para webhooks.

provider

official

Coincide con el manual de Seedance 2.0.

input

objeto

Modo, prompt, referencias, tamaño, duración y ajustes de audio.

Parámetros

request_typeobligatorio

Tiposelect

Use async to poll or callback to receive a webhook when ready.async · callback

callback_urlcondicional

Tipotext

Publicly accessible URL for callback mode.Solo en request_type=callback

modeobligatorio

Tiposelect

Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS

customModeobligatorio

Tipoboolean

Enable to control title/style/lyrics. When off, prompt-only mode is used.

titleobligatorio

Tipotext

Appears in metadata and can steer theme. Required when Custom Mode is on.Solo en customMode=

styleobligatorio

Tipostring

Describe genre/mood/instrumentation. Required in Custom Mode.Solo en customMode=

promptcondicional

Tipostring

Provide full lyrics for sung output. Required when Instrumental is off.Solo en customMode=

songDescriptionobligatorio

Tipostring

Simple mode: one field to steer both style and topic when Custom Mode is off.Solo en customMode=

instrumentalobligatorio

Tipoboolean

Turn on to generate backing track without vocals.

negativeTagscondicional

Tipostring

Negative TagsSolo en customMode=

styleWeightcondicional

Tiposlider

How strongly to follow the Style description.Solo en customMode=

weirdnessConstraintcondicional

Tiposlider

Push creativity/experimentation. Higher = wilder.Solo en customMode=

audioWeightcondicional

Tiposlider

Balance audio vs lyrical fidelity. Higher favors audio fidelity.Solo en customMode=

vocalGendercondicional

Tiposelect

Best-effort vocal timbre preference (custom mode only).f · mSolo en customMode=

Parámetro	Tipo	Obligatorio	Descripción
`request_type`	select	obligatorio	Use async to poll or callback to receive a webhook when ready.async · callback
`callback_url`	text	condicional	Publicly accessible URL for callback mode.Solo en request_type=callback
`mode`	select	obligatorio	Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS
`customMode`	boolean	obligatorio	Enable to control title/style/lyrics. When off, prompt-only mode is used.
`title`	text	obligatorio	Appears in metadata and can steer theme. Required when Custom Mode is on.Solo en customMode=
`style`	string	obligatorio	Describe genre/mood/instrumentation. Required in Custom Mode.Solo en customMode=
`prompt`	string	condicional	Provide full lyrics for sung output. Required when Instrumental is off.Solo en customMode=
`songDescription`	string	obligatorio	Simple mode: one field to steer both style and topic when Custom Mode is off.Solo en customMode=
`instrumental`	boolean	obligatorio	Turn on to generate backing track without vocals.
`negativeTags`	string	condicional	Negative TagsSolo en customMode=
`styleWeight`	slider	condicional	How strongly to follow the Style description.Solo en customMode=
`weirdnessConstraint`	slider	condicional	Push creativity/experimentation. Higher = wilder.Solo en customMode=
`audioWeight`	slider	condicional	Balance audio vs lyrical fidelity. Higher favors audio fidelity.Solo en customMode=
`vocalGender`	select	condicional	Best-effort vocal timbre preference (custom mode only).f · mSolo en customMode=

Ejemplo (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "mode": "V5",
    "title": "Neon Freeway Nights",
    "style": "Synthwave, dreamy pop",
    "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful.",
    "songDescription": "A dreamy synthwave song about neon city nights and freedom.",
    "customMode": true,
    "instrumental": false,
    "negativeTags": "off-key vocals, muddy mix",
    "styleWeight": 0.7,
    "weirdnessConstraint": 0.25,
    "audioWeight": 0.6,
    "vocalGender": "f"
  }'

Documentación completa de la API

Ejemplos de salida

Generado con la API de Suno V5 en APIXO

2 Pistas

Neon Freeway Nights

Ver

Guía completa

¿Qué es la API de Suno?

La API de Suno es una interfaz de generación de texto a música diseñada para flujos de trabajo de producción rápida. Puede convertir prompts, etiquetas de estilo y letras personalizadas en dos canciones completas con sus respectivas imágenes de portada.

Esto lo hace adecuado para herramientas de creadores, generación de contenido de marca y casos de uso de producción musical automatizada donde la iteración rápida es más importante que la composición manual.

Cómo funciona el flujo de trabajo de generación

Envíe una solicitud de generación con parámetros de solo prompt o modo de letra personalizada.
Reciba el estado de la tarea de forma asíncrona mediante sondeo o un punto de acceso de callback.
En caso de éxito, consume dos pistas generadas más los metadatos de la portada correspondiente.

Especificaciones técnicas de la API de Suno

Características operativas relevantes para la integración del producto y el backend.

Resultados

2 pistas por generación

Superficie de control

Estilo, rareza, peso del audio

Modos de generación

Modo de solo prompt y letras personalizadas

Entrega

Sondeo asíncrono o callback

Capacidades clave

Salida de pista dual

Cada generación devuelve dos variantes de canción, acelerando la selección A/B y la iteración creativa para los equipos de producción.

Deslizadores de control creativo

Ajuste el peso del estilo, la rareza y el peso del audio para pasar de pistas comerciales seguras a texturas experimentales.

Flujos de trabajo de letras y voces

Admite generación solo mediante prompt y modo de letra personalizada con preferencias opcionales de instrumental y género vocal.

Listo para integración asíncrona

Funciona con estrategias de sondeo o callback, facilitando la integración en flujos de trabajo de backend basados en colas.

¿Qué puede construir?

Generación de música en la aplicación

Genere fragmentos de música de marca y pistas aptas para creadores para UGC, vídeos cortos y herramientas de creación social.

Branding para Podcast y Vídeo

Produzca pistas de introducción y cierre, bumpers y motivos temáticos recurrentes con ambiente y ritmo controlables.

Bandas sonoras para contenido de formato corto

Cree música de fondo personalizada para TikTok, Shorts y Reels con una iteración rápida en torno al estilo y ganchos líricos.

Audio interactivo y para juegos

Prototipo de bucles ambientales, temas de menú e ideas de partituras ligeras para juegos y experiencias interactivas.

Notas y limitaciones

Cada generación devuelve exactamente dos pistas; el recuento de salida no se puede personalizar.
El flujo de trabajo de Playground es async-first; la orquestación de callbacks está disponible a nivel de API.
La longitud del prompt/letra en el modo personalizado está limitada a 5.000 caracteres en las versiones compatibles.
El género vocal y las características vocales son controles de mejor esfuerzo, no garantías estrictas.

Preguntas frecuentes

Comenzar a construir

Pruebe el playground arriba y luego pase a la documentación de la API cuando esté listo para integrar.

Probar playground Ver documentación de la API

Suno V5

Ejemplos de salida

¿Qué es la API de Suno?

Cómo funciona el flujo de trabajo de generación

Especificaciones técnicas de la API de Suno

Resultados

Superficie de control

Modos de generación

Entrega

Capacidades clave

Salida de pista dual

Deslizadores de control creativo

Flujos de trabajo de letras y voces

Listo para integración asíncrona

¿Qué puede construir?

Generación de música en la aplicación

Branding para Podcast y Vídeo

Bandas sonoras para contenido de formato corto

Audio interactivo y para juegos

Notas y limitaciones

Preguntas frecuentes

¿Puedo generar solo una pista en lugar de dos?

¿Puedo forzar la salida exacta de la letra?

¿Es esta API síncrona?

¿Qué tipo de archivo se devuelve?

Comenzar a construir