Saltar para o conteúdo

Documentos do desenvolvedor UlazAI

Vídeo legado APIs

Endpoints de vídeo legados e especializados

Os endpoints existentes permanecem disponíveis para compatibilidade. Cobertura do novo modelo e o desenvolvimento ativo de recursos estão centrados nos Video Studio APIs.

Padrão recomendado para novas compilações: /api/v1/video-studio/generate/

Lista de endpoints legados

Método Caminho Objetivo
POSTAR /api/v1/generate/video/ Legacy API-key endpoint (supports veo3_fast, veo3, kling_3_0, kling_3_0_motion_control).
OBTER /api/v1/generate/{generation_id}/ Legacy generation status endpoint for video and image jobs.
OBTER /api/v1/generate/history/ Legacy generation history endpoint.
POSTAR /api/v1/sora/generate/text-to-video/ Sora 2 text-to-video API.
POSTAR /api/v1/sora/generate/image-to-video/ Sora 2 image-to-video API.
POSTAR /api/v1/sora/generate/storyboard/ Sora storyboard API.
OBTER /api/v1/sora/status/{task_id}/ Sora task status API.

Orientação de migração

Família de rotas atual Escopo do modelo atual Substituição de estúdio de vídeo
/api/v1/generate/video/ veo3_fast, veo3, kling_3_0, kling_3_0_motion_control POST /api/v1/video-studio/generate/ com model_slug para todos os modelos de vídeo
/api/v1/sora/* Somente Sora POST /api/v1/video-studio/generate/ com model_slug=sora_2*
Documentos de destino específicos do modelo Detalhes do modelo único Use documentos matriciais + canônicos API para comportamento de contrato compartilhado

Terminais de ferramentas do Video Studio

Esses endpoints auxiliares criam prompts estruturados e despacham jobs por meio de o mesmo fluxo de geração canônica.

Método Caminho Objetivo
POSTAR /api/v1/video-studio/tools/street-interview/generate/ Structured prompt helper for interview-style clips (API key or token auth).
POSTAR /api/v1/video-studio/tools/ugc-ad-quick/generate/ Generate UGC ad videos from product and audience inputs (API key or token auth).
POSTAR /api/v1/video-studio/tools/video-remix/generate/ Remix source image or source video into a new style direction (API key or token auth).

Trechos de referência

Fluxo de chave API herdado

curl -X POST https://ulazai.com/api/v1/generate/video/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Luxury product teaser with moving camera",
    "video_model": "veo3_fast",
    "aspect_ratio": "16:9"
  }'

Fluxo de controle de movimento legado

curl -X POST https://ulazai.com/api/v1/generate/video/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "No distortion, the character'\''s movements are consistent with the video.",
    "video_model": "kling_3_0_motion_control",
    "source_image_urls": ["https://example.com/character.png"],
    "video_urls": ["https://example.com/motion.mp4"],
    "character_orientation": "video",
    "quality_mode": "720p",
    "duration_seconds": 15
  }'

Substituição do Canonical Video Studio (chave API)

fetch("https://ulazai.com/api/v1/video-studio/generate/", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    model_slug: "veo31_fast",
    prompt: "Luxury product teaser with moving camera",
    aspect_ratio: "16:9",
    duration_seconds: 8
  })
});