Geração de Vídeo Sora
Gere vídeos de IA através da API OpenAI Sora da AceDataCloud.
Configuração: Consulte autenticação para configurar o token.
Início Rápido
curl -X POST https://api.acedata.cloud/sora/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "um golden retriever correndo em uma praia ao pôr do sol", "model": "sora-2", "callback_url": "https://api.acedata.cloud/health"}'
Assíncrono: Consulte polling de tarefas assíncronas. Faça polling via
POST /sora/taskscom{"id": "..."}.
Modelos
| Modelo | Duração | Qualidade | Melhor Para |
|---|---|---|---|
sora-2 | 10–15s | Padrão | A maioria das tarefas (padrão) |
sora-2-pro | 10–25s | Superior | Qualidade premium, vídeos mais longos |
Fluxos de Trabalho
1. Texto-para-Vídeo
POST /sora/videos
{
"prompt": "uma movimentada rua de Tóquio à noite com letreiros de neon refletindo em poças de chuva",
"model": "sora-2",
"size": "small",
"duration": 10,
"orientation": "landscape"
}
2. Imagem-para-Vídeo
Use imagens de referência para guiar a geração.
POST /sora/videos
{
"prompt": "a cena gradualmente ganha vida com movimento suave",
"image_urls": ["https://example.com/scene.jpg"],
"model": "sora-2",
"orientation": "landscape"
}
3. Vídeo Orientado por Personagem
Extraia um personagem de um vídeo existente e use-o em uma nova cena.
POST /sora/videos
{
"prompt": "o personagem caminha por uma cidade futurista",
"character_url": "https://example.com/source-video.mp4",
"character_start": 2.0,
"character_end": 5.0,
"model": "sora-2-pro"
}
Parâmetros
| Parâmetro | Valores | Descrição |
|---|---|---|
model | "sora-2", "sora-2-pro" | Modelo a ser usado (obrigatório) |
size | "small", "large" | Resolução do vídeo |
duration | 10, 15, 25 | Duração em segundos (25 apenas com sora-2-pro) |
orientation | "landscape" (16:9), "portrait" (9:16), "square" (1:1) | Orientação do vídeo |
version | "1.0" | Versão da API — a versão 1.0 permite duração de até 25s, orientação, referências de personagem e entradas de imagem |
Armadilhas
- Duração de 25 segundos está disponível apenas com o modelo
sora-2-pro size: "large"produz maior resolução, mas custa mais e leva mais tempo- Geração orientada por personagem requer os timestamps
character_startecharacter_end(em segundos) do vídeo de origem orientationdefine a proporção de aspecto — use"portrait"para conteúdo voltado para dispositivos móveis- Estados de tarefa usam
"succeeded"(não "completed") — verifique este valor ao fazer polling
MCP:
pip install mcp-sora| Hospedado:https://sora.mcp.acedata.cloud/mcp| Consulte todos os servidores MCP