Imagem para Vídeo

O endpoint Imagem para Vídeo dá vida a imagens estáticas, gerando uma animação de vídeo de alta qualidade com base em um prompt de texto.

Nome do Modelo: image-to-video

Ciclo de Vida: experimental

Tempo de Processamento: ~60s–180s

Formato de Saída: MP4

Métodos de Entrega: URL (via consulta de status)

Créditos: 6 a 12 por vídeo (depende da duração)

Requisição

Gere um vídeo enviando sua imagem e prompt para o endpoint universal /v1/run:

POSThttps://fititon.app/api/v1/run

Exemplos de Requisição

curl -X POST https://fititon.app/api/v1/run \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{
           "model_name": "image-to-video",
           "inputs": {
             "imageUrl": "https://example.com/product.jpg",
             "prompt": "Camera pans slowly around the model as she walks forward",
             "duration": 6,
             "aspectRatio": "9:16"
           }
         }'

Resposta

Como a geração de vídeo leva vários minutos, o endpoint /v1/run retorna um status 200 OK imediatamente com um id de job assíncrono. Você deve consultar a API de Status usando GET /v1/status/{id} para recuperar o URL MP4 final. Alternativamente, você pode configurar webhooks para receber notificações automaticamente. Observe que nosso despachante de webhook impõe um tempo limite estrito de 15 segundos. Seu servidor deve reconhecer o webhook com um código de status 2xx dentro de 15 segundos, ou o consideraremos falho e o tentaremos novamente mais tarde.

{
  "id": "123a87r9-4129-4bb3-be18-9c9fb5bd7fc1",
  "status": "starting",
  "created_at": "2026-07-18T17:30:00.000Z",
  "error": null,
  "output": null
}

Parâmetros de Requisição

Parâmetros Obrigatórios

imageUrlRequiredstring

A imagem de entrada para animar. Pode ser um URL publicamente acessível ou uma string de imagem codificada em Base64.

Dica Profissional: Imagens com cabelo, tecido ou folhagem visíveis produzem o movimento mais natural. Fotos estáticas de flat-lay ou apenas de produtos não animam bem — use imagens com uma pessoa ou cena. Evite imagens muito cortadas para dar espaço à IA para movimento.

Requisito de Formatação Ao enviar uma string Base64, ela deve incluir o prefixo URI de dados padrão (por exemplo, data:image/jpeg;base64,...).

Parâmetros Opcionais

promptstring

Uma descrição textual que guia a animação. Se omitido, a IA inferirá o movimento natural a partir do contexto da imagem.

durationinteger

A duração do vídeo gerado em segundos. Valores suportados: 4, 6, 8. Padrão: 6

aspectRatio'16:9' | '9:16'

A proporção do vídeo de saída. Padrão: 9:16

generateAudioboolean

Se deve gerar áudio de IA contextual para acompanhar o vídeo. Padrão: true

Erros de Tempo de Execução

Os erros de tempo de execução para este recurso usam o conjunto compartilhado documentado em Tratamento de Erros. Se ocorrer um erro durante o processamento, o status será atualizado para "error" e o campo error conterá o motivo específico da falha.

Custo de Crédito

Para requisições da API de Desenvolvedor, o custo depende inteiramente da duration do vídeo solicitada.

Fórmula: Custo = CréditosDuração

Duração	Créditos por Vídeo
4s	6
6s (Padrão)	9
8s	12