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.

Seedance 2.5 model_slug=seedance_2_5

4-30 second generation in 480p/720p with text, first-frame, first+last-frame, or multimodal mode. Supports up to 30 image, 10 video, and 10 audio references plus MP4/MOV output.

Motor: Seedance 2.5

Proporções: 1:1, 4:3, 3:4, 16:9, 9:16, 21:9, adaptive

Durações: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 segundos

Modos de qualidade: 480p, 720p, 1080p

Entradas: texto , imagem , vídeo

Créditos: 480p 4 no video input: 112, 480p 5 no video input: 140, 480p 6 no video input: 168, 480p 7 no video input: 196, +77 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