Saltar para o conteúdo
UlazAI

Documentos do desenvolvedor UlazAI

Geração de Áudio API

Preços Painel Estúdio de imagem

API do Estúdio de música

Suno API

Crie músicas e continue a trabalhá-las através da mesma API usada pelo Estúdio de música.

Abrir o Estúdio de música

Consulte o catálogo de operações para ver os modelos atuais, os campos obrigatórios e os preços em créditos. Envie um ID de pedido único para que repetir um pedido não seja cobrado duas vezes.

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/

A sua biblioteca inclui todas as tomas devolvidas. Editar cria um novo resultado e mantém o original.

Geração de Áudio API

Gere músicas, dublagens e efeitos sonoros usando créditos UlazAI. Os resultados são entregues de forma assíncrona: envie um trabalho e, em seguida, pesquise o endpoint de status até que ele seja concluído.

Autenticação: uso Authorization: Bearer <ulazai_api_key> ou Authorization: Token <token>.

🎵 Música

POSTAR /api/v1/music/generate/ Autenticação necessária

Gere uma faixa de música a partir de um prompt.

Corpo da Solicitação

{
  "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
}

Resposta (criada em 201)

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

Custo de crédito: 12 créditos por solicitação.

OBTER /api/v1/music/status/<music_id>/ Autenticação necessária

Enquete para conclusão do trabalho.

Resposta (200 OK, concluída)

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

🎙️ Locução

POSTAR /api/v1/voiceover/generate/ Autenticação necessária

Converta texto em narração.

Corpo da solicitação (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)
}

Corpo da solicitação (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."}
  ]
}

Custo de crédito: baseado na contagem de caracteres. Turbo 2.5: 12 créditos por 1.000 caracteres. V3/Diálogo: 14 créditos por 1.000 caracteres.

OBTER /api/v1/voiceover/status/<voiceover_id>/ Autenticação necessária

Pesquise para conclusão e recupere o URL do áudio.

🔊 Efeitos sonoros

POSTAR /api/v1/sound-effects/generate/ Autenticação necessária

Gere um efeito sonoro a partir de um prompt.

Corpo da Solicitação

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

Custo de crédito: 0,24 créditos/s (arredondado), mínimo 1 crédito.

OBTER /api/v1/sound-effects/status/<sfx_id>/ Autenticação necessária

Pesquise para conclusão e recupere o URL do áudio.