Geração de Vídeos Luma
Gere vídeos com IA através da API Luma Dream Machine da AceDataCloud.
Configuração: Consulte autenticação para configurar o token.
Início Rápido
curl -X POST https://api.acedata.cloud/luma/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "um drone sobrevoando um lago de montanha ao amanhecer", "action": "generate", "callback_url": "https://api.acedata.cloud/health"}'
Assíncrono: Consulte polling de tarefas assíncronas. Faça polling via
POST /luma/taskscom{"task_id": "..."}.
Fluxos de Trabalho
1. Texto-para-Vídeo
Gere vídeo puramente a partir de uma descrição textual.
POST /luma/videos
{
"prompt": "time-lapse de flores desabrochando em um jardim",
"action": "generate",
"aspect_ratio": "16:9",
"loop": false,
"enhancement": true
}
2. Imagem-para-Vídeo
Use imagens de referência de início e/ou fim para guiar a geração.
POST /luma/videos
{
"prompt": "a cena ganha vida com uma brisa suave",
"action": "generate",
"start_image_url": "https://exemplo.com/cena.jpg",
"end_image_url": "https://exemplo.com/cena-final.jpg",
"aspect_ratio": "16:9"
}
3. Estender um Vídeo
Continue um vídeo existente com um novo prompt.
POST /luma/videos
{
"action": "extend",
"video_id": "id-do-video-existente",
"prompt": "a câmera continua avançando pela floresta"
}
Proporções de Aspecto
| Proporção | Caso de Uso |
|---|---|
16:9 | Paisagem (padrão) — YouTube, TV |
9:16 | Retrato — TikTok, Instagram Stories |
1:1 | Quadrada — Redes sociais |
4:3 | Clássica — Apresentações |
21:9 | Ultra-wide — Cinematográfica |
Parâmetros
| Parâmetro | Tipo | Padrão | Descrição |
|---|---|---|---|
prompt | string | — | Descrição textual do vídeo (obrigatório) |
action | string | "generate" | "generate" ou "extend" |
aspect_ratio | string | "16:9" | Proporção de aspecto do vídeo |
loop | bool | false | Criar loop contínuo |
enhancement | bool | true | Melhorar o prompt para resultados superiores |
start_image_url | string | — | Imagem de referência para o primeiro quadro |
end_image_url | string | — | Imagem de referência para o último quadro |
video_id | string | — | ID do vídeo a ser estendido (alternativa a video_url) |
video_url | string | — | URL do vídeo a ser estendido (alternativa a video_id) |
timeout | number | — | Tempo limite em segundos para a API retornar dados |
callback_url | string | — | URL do webhook para notificações assíncronas |
Armadilhas
enhancement: true(padrão) melhora a qualidade do prompt, mas pode alterar sua intenção — defina comofalsepara prompts literais- URLs de imagem de início/fim devem ser publicamente acessíveis
loop: truecria vídeo em loop contínuo — bom para fundos e redes sociais- Estender requer
video_idouvideo_urlde uma geração anterior concluída - A geração de vídeo leva de 1 a 5 minutos, dependendo da complexidade
- Ambas as imagens de início e fim são opcionais — você pode usar apenas uma para orientação parcial
MCP:
pip install mcp-luma| Hospedado:https://luma.mcp.acedata.cloud/mcp| Consulte todos os servidores MCP