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 / generation

2 pistas por ejecuciónV4 / V4.5 / V5Modo de letra personalizadaMP3 + portada

Cargando espacio de trabajo...

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 el modo asíncrono para consultar el estado de la tarea (poll statusTask), o el modo de callback para recibir un webhook cuando el resultado esté listo.async · callback

callback_urlcondicional

Tipotext

URL HTTPS pública para la entrega de callbacks.Solo en request_type=callback

modeobligatorio

Tiposelect

Elija la versión del backend de generación.V5 · V4_5 · V4_5ALL · V4_5PLUS · V4

customModeobligatorio

Tipoboolean

Activar modo de letras personalizadas. Cuando está desactivado, se utiliza el modo de descripción de canción solo con prompt.

titleobligatorio

Tipotext

Requerido cuando el Modo Personalizado está activado.Solo en customMode=

styleobligatorio

Tipostring

Describa el género, el ambiente, la instrumentación y el estilo vocal. Requerido en Modo Personalizado.Solo en customMode=

promptopcional

Tipostring

Descripción de la canción o letra. El modo personalizado admite letras más largas en las versiones más recientes de Suno.

songDescriptionobligatorio

Tipostring

Campo de modo solo-prompt usado cuando el Modo Personalizado está desactivado.Solo en customMode=

instrumentalobligatorio

Tipoboolean

Actívelo para generar una pista instrumental sin voz.

negativeTagscondicional

Tipostring

Describa los artefactos o estilos a evitar.Solo en customMode=

styleWeightcondicional

Tiposlider

Nivel de adherencia a la descripción de estilo.Solo en customMode=

weirdnessConstraintcondicional

Tiposlider

Valores más altos producen resultados más experimentales.Solo en customMode=

audioWeightcondicional

Tiposlider

Equilibra la fidelidad del audio y el control de la letra.Solo en customMode=

vocalGendercondicional

Tiposelect

Preferencia de timbre vocal (mejor esfuerzo).f · mSolo en customMode=

Parámetro	Tipo	Obligatorio	Descripción
`request_type`	select	obligatorio	Use el modo asíncrono para consultar el estado de la tarea (poll statusTask), o el modo de callback para recibir un webhook cuando el resultado esté listo.async · callback
`callback_url`	text	condicional	URL HTTPS pública para la entrega de callbacks.Solo en request_type=callback
`mode`	select	obligatorio	Elija la versión del backend de generación.V5 · V4_5 · V4_5ALL · V4_5PLUS · V4
`customMode`	boolean	obligatorio	Activar modo de letras personalizadas. Cuando está desactivado, se utiliza el modo de descripción de canción solo con prompt.
`title`	text	obligatorio	Requerido cuando el Modo Personalizado está activado.Solo en customMode=
`style`	string	obligatorio	Describa el género, el ambiente, la instrumentación y el estilo vocal. Requerido en Modo Personalizado.Solo en customMode=
`prompt`	string	opcional	Descripción de la canción o letra. El modo personalizado admite letras más largas en las versiones más recientes de Suno.
`songDescription`	string	obligatorio	Campo de modo solo-prompt usado cuando el Modo Personalizado está desactivado.Solo en customMode=
`instrumental`	boolean	obligatorio	Actívelo para generar una pista instrumental sin voz.
`negativeTags`	string	condicional	Describa los artefactos o estilos a evitar.Solo en customMode=
`styleWeight`	slider	condicional	Nivel de adherencia a la descripción de estilo.Solo en customMode=
`weirdnessConstraint`	slider	condicional	Valores más altos producen resultados más experimentales.Solo en customMode=
`audioWeight`	slider	condicional	Equilibra la fidelidad del audio y el control de la letra.Solo en customMode=
`vocalGender`	select	condicional	Preferencia de timbre vocal (mejor esfuerzo).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",
    "input": {
      "mode": "V5",
      "customMode": true,
      "instrumental": false,
      "title": "Neon Freeway Nights",
      "style": "Synthwave, dreamy pop",
      "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful."
    }
  }'

Documentación completa de la API

Guía de la API de Suno V5

API de Suno para flujos de trabajo de Generación de audio

Use Suno a través de APIXO para probar prompts en el Playground, inspeccionar demos, comparar precios y trasladar la misma configuración a las llamadas de API en producción.

Flujo de trabajo de Suno V5

Crea y despliega flujos de trabajo de la API de Suno V5 desde una sola página.

Esta página de destino de Suno V5 está diseñada para equipos que desean evaluar la calidad de los resultados, comparar precios, crear claves API y transferir configuraciones probadas al código de producción desde el mismo flujo de trabajo.

Pruebas de prompts con Suno V5

Use el Playground de Suno V5 para probar prompts, opciones de modo y ajustes de salida antes de pasar una solicitud a producción.

Revisión de la demo de Suno V5

Inspeccione primero el Salidas de audio real o de marcador de posición, luego cargue los mismos parámetros de demostración en el Playground para una iteración más rápida.

Integración de la API de Suno V5

Pase de las pruebas visuales a las claves API, ejemplos de cURL, JSON de solicitud y documentación sin salir de esta página del modelo.

Claridad de precios de Suno V5

Compare los niveles de precios disponibles en la misma página antes de elegir un perfil de costos para trabajos de producción.

Control de entrada de Suno V5

Ajuste letra, estilo y controles vocales directamente en el Playground para que el formulario probado coincida con la superficie de la API documentada.

Preparación para producción con Suno V5

Use APIXO cuando el sondeo asíncrono (polling), la entrega por callback, el historial de generación y la facturación predecible sean importantes para los flujos de trabajo del equipo.

Descripción general del modelo

¿Qué es la API de Suno?

Suno está disponible a través de APIXO como una API de producción para Generación de audio. La página del modelo combina pruebas en el Playground, parámetros de solicitud reales, precios y documentación para la integración en un único flujo de trabajo.

Utilice esta página para validar primero los prompts y las selecciones de modo, luego mantenga la misma configuración para las claves API, los ejemplos de cURL, la integración de backend y los trabajos de generación repetibles.

Flujo de trabajo de la API de Suno para equipos de producción

Empiece en el Playground y elija el modo que coincida con sus recursos de entrada.
Revise los resultados de ejemplo y cargue los parámetros de la demo cuando necesite una base de referencia rápida.
Consulte los precios antes de enviar lotes grandes o trabajos de mayor resolución.
Use el sondeo asíncrono (polling) para una UX interactiva o el modo de callback para colas de backend.

Especificaciones técnicas de la API de Suno

Capacidades actuales de la API de Suno y restricciones relevantes para la integración.

Modos de Suno

Solo-prompt, letras personalizadas y música instrumental

Resultados de Suno

2 pistas por ejecución

Controles de Suno

V4 / V4.5 / V5 / Modo de letra personalizada

Latencia de Suno

Típicamente 60-90 segundos

Capacidades clave de Suno V5

Generación de música con Suno

Genere salidas de audio a partir de prompts estructurados, manteniendo los ajustes de generación visibles para la transferencia a la API.

Control creativo de Suno

Ajuste la letra, el estilo o la configuración del modo directamente en el Playground antes de pasar a las llamadas de producción.

Flujo de trabajo de la API de Suno

Use la creación de tareas asíncronas, el sondeo (polling), la entrega por callback y los ejemplos de solicitud desde la misma página del modelo.

¿Qué puede construir con Suno V5?

Herramientas para creadores de Suno

Añada la generación de música a los flujos de trabajo de los creadores donde los usuarios necesitan una iteración rápida de prompt a audio.

Audio de marca de Suno

Genere pistas para campañas, música de fondo de formato corto, intros, outros o conceptos de sonido a través de trabajos de API.

Automatización de producción con Suno

Ejecute trabajos de audio asíncronos y repetibles desde colas de backend mientras realiza el seguimiento de las entradas, los ID de tarea y las URL de resultado.

Notas y limitaciones de Suno V5

La generación con Suno utiliza entrega de tareas asíncrona; los sistemas de producción deben admitir polling o manejo de callbacks.
La calidad del resultado depende de la claridad del prompt, la calidad del activo de entrada y el comportamiento del modelo del lado del proveedor.
Todas las solicitudes deben pasar los controles de seguridad, moderación y acceso a la cuenta del proveedor.
Las salidas de audio pueden variar en letra, estilo vocal, sincronización y mezcla, incluso cuando se utiliza la misma estructura de prompt.

Preguntas frecuentes sobre Suno V5

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

API de Suno para flujos de trabajo de Generación de audio

Crea y despliega flujos de trabajo de la API de Suno V5 desde una sola página.

¿Qué es la API de Suno?

Flujo de trabajo de la API de Suno para equipos de producción

Especificaciones técnicas de la API de Suno

Modos de Suno

Resultados de Suno

Controles de Suno

Latencia de Suno

Capacidades clave de Suno V5

Generación de música con Suno

Control creativo de Suno

Flujo de trabajo de la API de Suno

¿Qué puede construir con Suno V5?

Herramientas para creadores de Suno

Audio de marca de Suno

Automatización de producción con Suno

Notas y limitaciones de Suno V5

Preguntas frecuentes sobre Suno V5

¿Puedo probar Suno antes de escribir código para la API?

¿Suno admite la generación asíncrona?

¿De dónde provienen los parámetros de Suno?

¿Puedo reemplazar los recursos de demostración más tarde?

Comenzar a construir