Suno · API de medios

Suno v4.5 API

Suno v4.5 es la primera ruta musical disponible en OmniaKey: describe un estilo y deja que el modelo escriba la letra, o envía la tuya junto al estilo, y una canción terminada vuelve por la misma API de medios asíncrona que usan las imágenes y el vídeo.

Obtén tu clave API Leer la documentación

ID del modelo: suno-v4.5
Proveedor: Suno
Modalidad: AI Audio
Por llamada correcta: $0,30
Última verificación: 2026-09-15

Para qué sirve

Usa Suno v4.5 para demos, música de fondo, jingles y borradores de letras a $0.30 por generación. Cada generación devuelve una canción terminada y solo se factura una vez, envíes o no la letra.

Qué hace

Texto a música

suno-v4.5

Convierte una descripción de estilo y una letra opcional en una canción terminada.

Cómo llamarlo

Los modelos de medios funcionan de forma asíncrona: crea una tarea, consúltala hasta que termine y descarga la URL firmada del recurso.

Crear, consultar, descargar

# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: suno-v4.5-001" \
  -d '{
    "model": "suno-v4.5",
    "type": "audio",
    "operation": "generate",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"title": "Paper Boats"}
  }'

# 2. Description mode sends input.prompt alone and lets the model write
#    the words. Custom lyrics mode adds input.lyrics plus the style:
#    {"prompt": "indie folk", "lyrics": "[Verse] ..."} —
#    parameters.style (or .tags) overrides the style, and
#    parameters.instrumental: true drops the vocal entirely.

# 3. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 4. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.mp3 "$(jq -r '.assets[0].url' result.json)"

Precio

Los trabajos de música se facturan por generación correcta, no por token. Los trabajos fallidos o cancelados se reembolsan automáticamente.

Por llamada correcta

$0,30por llamada

Preguntas frecuentes

¿Cómo llamo a Suno v4.5 en OmniaKey?

Envía un POST a /v1/media/tasks con el id del modelo, type "audio" y operation "generate". El modo descripción solo envía input.prompt; para cantar tu propia letra, añade input.lyrics. Reutiliza la misma Idempotency-Key en los reintentos para que un timeout no inicie un segundo trabajo facturado.

¿Cuánto cuesta Suno v4.5?

Suno v4.5 factura $0,30 por llamada por generación correcta. La creación descuenta ese importe de tu saldo prepago y los trabajos fallidos o cancelados se reembolsan automáticamente.

¿Por qué la API devuelve un id de tarea en lugar de la canción?

La generación musical tarda entre treinta segundos y varios minutos, así que OmniaKey hace pasar todas las rutas de audio por el mismo ciclo asíncrono. Consulta GET /v1/media/tasks/{id} hasta que el estado sea succeeded y luego lee la URL firmada del recurso.