Gere vídeo com IA
a partir do seu backend
Um POST transforma um prompt, ou uma imagem fixa, num clipe gerado. Veo, Kling, Sora e Seedance atrás de um único endpoint, cobrados por geração e entregues por webhook.
POSThttps://autostud.ai/api/v1/actions/videos_ai.generateTrês chamadas, do início ao fim
Escolha o motor uma vez e depois gere as vezes que quiser.
- 1
Escolha um agente de vídeo
Um agente é uma configuração de modelo guardada: motor, resolução, formato e valores por omissão. Liste os do seu espaço e guarde o id.
export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" # A video agent is a saved model configuration, not a model name. curl "https://autostud.ai/api/v1/agents?agent_type=video&limit=10" \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" - 2
Envie o prompt
Apenas texto, ou uma imagem fixa para animar. A resposta traz um id de geração e os créditos gastos.
curl -X POST https://autostud.ai/api/v1/actions/videos_ai.generate \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: lighthouse-shot-01" \ -d '{ "agent_id": "b21f7d90-3c44-4e1a-9f77-0c2ad5e6b118", "prompt": "A lighthouse at dusk, slow push-in, waves breaking under it", "duration": 8 }' - 3
Recolha o clipe
Receba o webhook generation.completed, ou releia a geração se preferir sondar. O URL alojado está no registo.
# Register once. Every generation reports itself from then on. curl -X POST https://autostud.ai/api/v1/webhooks \ -H "Authorization: Bearer $AUTOSTUD_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://your-app.com/hooks/autostud", "events": ["generation.completed", "generation.failed"], "description": "AI video" }' # The signing secret comes back once, in this response. Store it.
O que pode enviar
Quatro campos. O resto vive no agente, por isso as chamadas ficam curtas.
agent_idO agente de vídeo a executar. O motor e as predefinições decidem o aspeto do clipe.
promptO que deve acontecer no plano. O motor lê isto como um realizador.
image_urlOpcional. Uma imagem fixa para animar em vez de gerar só a partir do texto.
durationSegundos de imagem a produzir, dentro do intervalo suportado pelo motor.
Motores por trás do endpoint
Cada motor é exposto como agente: mudar de modelo é um id diferente, não uma integração diferente. Motores novos chegam como agentes novos.
Deixe de sondar
Registe um webhook e cada geração anuncia-se sozinha. Os payloads são assinados, repetidos e indicam os créditos gastos mesmo quando a geração falha.
generation.completedgeneration.failedO que os programadores perguntam primeiro
Quanto tempo demora uma geração?
Depende do motor e da duração: segundos de vídeo custam minutos de computação. A chamada devolve logo um id, por isso nada na sua aplicação fica à espera.
Quanto custa?
As gerações são cobradas em créditos, com preço por motor. Cada resposta indica os créditos gastos e o histórico completo lê-se em /api/v1/generations.
Posso animar uma imagem que já tenho?
Sim. Envie image_url com qualquer imagem acessível publicamente e o motor anima-a em vez de partir só do prompt.
Posso alongar o clipe depois?
Chame videos_ai.extend com o id da geração e um prompt para o segmento seguinte. A extensão é uma geração própria, cobrada da mesma forma.
Pronto para criar?
Comece a gerar vídeos virais em minutos. Não é necessário cartão de crédito para o teste gratuito.