auto stud
APIAPI de Geração de Vídeo com IA

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.generate

Três chamadas, do início ao fim

Escolha o motor uma vez e depois gere as vezes que quiser.

  1. 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. 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. 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_id

O agente de vídeo a executar. O motor e as predefinições decidem o aspeto do clipe.

prompt

O que deve acontecer no plano. O motor lê isto como um realizador.

image_url

Opcional. Uma imagem fixa para animar em vez de gerar só a partir do texto.

duration

Segundos 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.

VeoKlingSoraSeedanceRunway

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.failed

O 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.

Pagamentos seguros
Acesso instantâneo
Cancele quando quiser