Saltar para o conteúdo
UlazAI

Documentos do desenvolvedor UlazAI

Estúdio de Vídeo API

Preços Painel Estúdio de imagem
POSTAR /api/v1/video-studio/generate/

Endpoint de geração de vídeo canônico

Use o Video Studio para todos os modelos de vídeo atuais. Este ponto de extremidade suporta fluxos de trabalho de texto para vídeo, imagem para vídeo e específicos de modelo, como remix de vídeo.

Para integrações dinâmicas, busque recursos de modelo em /api/v1/models/video/ antes de enviar cargas úteis de geração.

As rotas recentes do Video Studio incluem seedance_2_mini, kling_v3_turbo_t2v, kling_v3_turbo_i2v, video_lip_sync, omnihuman_1_5, happyhorse_t2v, happyhorse_i2v, happyhorse_r2ve happyhorse_videoedit.
Autenticação: enviar Authorization: Bearer YOUR_API_KEY em cada solicitação.

Enquete com /api/v1/video-studio/status/{job_id}/ e carregue recente empregos de /api/v1/video-studio/history/.

Solicitar contrato

Campo Tipo Obrigatório Notas
model_slug corda Sim Deve corresponder a um slug de modelo registrado do Video Studio
prompt corda Normalmente Necessário para a maioria dos modelos. O modo Storyboard pode começar apenas com imagens.
aspect_ratio corda Não Deve ser uma das proporções do modelo selecionado
duration_seconds inteiro Não Deve corresponder a uma duração permitida para o modelo. O Motion Control usa a duração do clipe de movimento para definir o preço.
quality_mode corda Não Obrigatório quando o modelo define modos de qualidade
input_image_urls matriz[string] Específico do modelo Usado para modelos de imagem para vídeo. Alguns modelos requerem pelo menos um URL.
input_video_urls matriz[string] Específico do modelo Usado por remix de vídeo e rotas de vídeo de origem, como wan_2_6_v2v, kling_3_0_motion_control, video_lip_synce happyhorse_videoedit.
seedance_mode corda Somente Seedance 2 Usar text_to_video, first_frame, first_last_frame, ou multimodal.
first_frame_url, last_frame_url corda Somente Seedance 2 Use para os modos Seedance 2 de primeiro quadro e primeiro + último quadro. URLs públicos e asset:// Identificações são aceitas.
reference_image_urls, reference_video_urls, reference_audio_urls matriz[string] Específico do modelo Seedance 2 usa matrizes de referência multimodais. Rotas orientadas por áudio, como video_lip_sync e omnihuman_1_5 usar reference_audio_urls para o discurso ou narração alvo. URLs públicos e asset:// IDs são aceitos onde o modelo selecionado os suporta.
character_orientation corda Específico do modelo Apenas controle de movimento. Usar video para seguir a orientação do clipe de movimento ou image para manter o enquadramento dos personagens carregados, com durações de 3 a 15 segundos.
sound booleano Não Usado apenas em modelos com suporte de áudio
return_last_frame, web_search booleano Somente Seedance 2 Sinalizadores Seedance 2 opcionais para retornar o último quadro e permitir a pesquisa na web do lado do modelo.
prompt_directory_optin booleano Não O desconto do diretório se aplica apenas a famílias de modelos selecionados
Para filmagens de pessoas reais no Seedance 2, use o Guia de ativos UlazAI Seedance 2 e passar o devolvido asset:// IDENTIFICAÇÃO. Arquivos brutos diretos podem falhar.

Seletor de modelo

Escolha um modelo para inspecionar recursos e gerar automaticamente snippets de solicitação.

Gemini Omni Flash 1.2 model_slug=gemini_omni_flash_1_2

Four modes, one per request: text or reference images (duration required, 3-15s, up to 6 images), first frame only (duration required, 3-15s), first and last frame (duration required, 3-10s), or video edit (one source video up to 15s via input_video_urls, no duration, optional reference images; billed on the measured source length). Aspect ratios 16:9, 9:16 or auto; 360p/720p/1080p/4K. Image quota: images plus 2 per video, max 7 total; each file max 20MB. Voice IDs and character IDs are not supported.

Motor: Gemini Omni

Proporções: 16:9, 9:16, auto

Durações: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 segundos

Modos de qualidade: 360p, 720p, 1080p, 4k

Entradas: imagem , vídeo

Créditos: 360p 3: 15, 360p 4: 20, 360p 5: 24, 360p 6: 29, +48 more

Snippets de solicitação em tempo real

Os trechos abaixo seguem a predefinição do modelo selecionado.

cURL (chave API)

JavaScript (buscar)

Python (solicitações)

Snippets de pesquisa de status

Status da enquete por job_id até completed ou failed.

curvatura

JavaScript (buscar)

Python (solicitações)

Exemplos de resposta

Sucesso

{
  "success": true,
  "job_ids": ["8990f846-f6f0-4ff1-a298-d0a72d49e7ad"],
  "credits_remaining_total": 438
}

Erro de validação

{
  "success": false,
  "error": "Invalid duration for this model"
}

Créditos insuficientes

{
  "success": false,
  "error": "Insufficient credits",
  "credits_required": 220,
  "credits_available": 94
}

Endpoint de vídeo com chave API (legado)

Se você precisar de chamadas de vídeo baseadas na tecla API, use /api/v1/generate/video/. Esse caminho suporta uma conjunto de modelos limitado e está documentado no mapeamento de vídeo legado.

Mapeamento de vídeo legado aberto Fluxos de trabalho de status abertos Matriz de modelo de vídeo aberto