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
})
});