Saltar al contenido
UlazAI

Documentos para desarrolladores UlazAI

Generación de audio API

Precios Panel estudio de imagen

API del Estudio de música

Suno API

Crea canciones y sigue trabajando en ellas con la misma API que usa el Estudio de música.

Abrir el Estudio de música

Consulta el catálogo de operaciones para ver los modelos actuales, los campos obligatorios y los precios en créditos. Envía un ID de solicitud único para que reintentar una petición no cobre dos veces.

GET  /api/v1/music/studio/catalog/
POST /api/v1/music/studio/jobs/
GET  /api/v1/music/studio/jobs/
GET  /api/v1/music/studio/jobs/<id>/
POST /api/v1/music/studio/upload/

Tu biblioteca incluye todas las tomas devueltas. Editar crea un resultado nuevo y conserva el original.

Generación de audio API

Genere música, voces en off y efectos de sonido utilizando créditos UlazAI. Los resultados se entregan de forma asincrónica: envíe un trabajo y luego sondee el punto final de estado hasta que se complete.

Autenticación: uso Authorization: Bearer <ulazai_api_key> o Authorization: Token <token>.

🎵 Música

PUBLICAR /api/v1/music/generate/ Se requiere autenticación

Genere una pista de música desde un prompt.

Cuerpo de solicitud

{
  "prompt": "Upbeat synthwave track with neon retro vibes",
  "model": "V5",               // Options: "V5", "V4_5PLUS" (default: V4_5PLUS)
  "duration": 30,              // Optional (seconds)
  "instrumental": true,        // Optional (default: true)
  "title": "Neon Nights",      // Optional
  "style": "synthwave, 120bpm" // Optional
}

Respuesta (201 creada)

{
  "success": true,
  "data": {
    "music_id": "uuid-here",
    "status": "processing",
    "status_url": "/api/v1/music/status/uuid-here/",
    "credits_used": 12,
    "credits_remaining": 88
  }
}

Costo del crédito: 12 créditos por solicitud.

OBTENER /api/v1/music/status/<music_id>/ Se requiere autenticación

Encuesta para completar el trabajo.

Respuesta (200 OK, completada)

{
  "success": true,
  "data": {
    "music_id": "uuid-here",
    "status": "completed",
    "audio_url": "https://media.ulazai.com/...",
    "credits_used": 12
  }
}

🎙️ Voz en off

PUBLICAR /api/v1/voiceover/generate/ Se requiere autenticación

Convierte texto en voz en off.

Cuerpo de solicitud (TTS)

{
  "model": "tts_turbo_25",     // Options: "tts_turbo_25", "tts_v3"
  "text": "Welcome to UlazAI Studio. Let's create something amazing.",
  "voice": "Rachel",          // Optional
  "speed": 1.0                // Optional (0.7 - 1.2)
}

Cuerpo de solicitud (diálogo)

{
  "model": "dialogue_v3",
  "dialogue": [
    {"voice": "Rachel", "text": "We need a new hook for this ad."},
    {"voice": "Roger",  "text": "Let's make it shorter and punchier."}
  ]
}

Costo del crédito: basado en el número de personajes. Turbo 2.5: 12 créditos por cada 1.000 caracteres. V3/Diálogo: 14 créditos por cada 1.000 caracteres.

OBTENER /api/v1/voiceover/status/<voiceover_id>/ Se requiere autenticación

Encuesta para completar y recuperar la URL del audio.

🔊 Efectos de sonido

PUBLICAR /api/v1/sound-effects/generate/ Se requiere autenticación

Genera un efecto de sonido desde un prompt.

Cuerpo de solicitud

{
  "text": "A futuristic UI beep with a short tail",
  "loop": false,
  "duration_seconds": 2.5
}

Costo del crédito: 0,24 créditos/seg (redondeado hacia arriba), mínimo 1 crédito.

OBTENER /api/v1/sound-effects/status/<sfx_id>/ Se requiere autenticación

Encuesta para completar y recuperar la URL del audio.