Geração de vídeo

POST /v1/videos: texto para vídeo, imagem para vídeo e o modo primeiro/último quadro — com o modo assíncrono para renderizações longas.

Atualizado em 01 de set. de 2026

Gera vídeo a partir de texto, de uma imagem, ou interpolando entre um primeiro e um último quadro — o modo que transforma duas imagens numa cena com narrativa. São 24 modelos no catálogo (GET /v1/models, endpoint: "/v1/videos"), cobrados por segundo de vídeo ou por execução.

Renderizar leva de 1 a 4 minutos. Para não segurar a conexão, use o modo assíncrono: "async": true responde na hora com um job_id.

POSThttps://api.hinow.ai/v1/videosBearer

Renderiza um vídeo e devolve a URL pública do mp4.

Parâmetros

modelstring· bodyobrigatório
Id namespaced do modelo (ex.: `bytedance/seedance-2.0-mini`, `google/veo-31`).
promptstring· bodyobrigatório
A cena e o movimento, em texto. Com quadros, descreva o MOVIMENTO entre eles.
imagesstring[]· body
URLs públicas. Uma imagem = animar a partir dela; **duas = primeiro e último quadro** (nesta ordem), nos modelos `image_to_video`.
image_modestring· body
`frames` (padrão até 2 imagens) ou `reference` (3+ imagens viram referência de estilo/sujeito, nos modelos que suportam).
durationnumber· body
Segundos de vídeo, dentro do limite do modelo.
asyncboolean· body
`true` devolve `202` com `job_id` na hora — recomendado sempre. Ver [Jobs de mídia](/pt/models/quick-reference/media-jobs).

Respostas

200Vídeo renderizado (modo síncrono)

{
  "success": true,
  "data": {
    "urls": ["https://s3.us1-stlouis.hinow.ai/hi-storage/image_to_video/.../clip.mp4"],
    "model": "bytedance/seedance-2.0-mini",
    "category": "image_to_video",
    "cost": { "amount": 0.575, "currency": "USD", "value_type": "per_second" }
  }
}

202Modo assíncrono: `data.job_id` e `data.poll_url` — a renderização continua no servidor

400Modelo incompatível com o endpoint (`INVALID_MODEL_CATEGORY`) ou corpo inválido

502/504Provedor falhou ou estourou o tempo no modo síncrono — use `async: true`

Primeiro e último quadro

O modo que rende as melhores cenas curtas: gere (ou envie) a imagem de como a cena começa e a de como termina, e o modelo cria o movimento entre elas.

cena com narrativa (medido: ~1m45s, US$ 0,575 por 5s no seedance-2.0-mini)bash

curl -X POST https://api.hinow.ai/v1/videos \
  -H "Authorization: Bearer hi_SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0-mini",
    "prompt": "the puppy slowly wakes up and looks at the camera, gentle motion, static camera",
    "images": ["https://.../quadro-inicial.jpg", "https://.../quadro-final.jpg"],
    "duration": 5,
    "async": true
  }'

Os dois quadros devem parecer o mesmo lugar

Gere os dois com o mesmo cenário, luz e enquadramento — só o que a narrativa muda deve mudar. O fluxo pronto Diretor de cena faz exatamente isso a partir de um pedido em linguagem natural.

Preço por segundo varia por modelo

Modelos per_second não expõem o valor unitário no catálogo — o custo real vem no campo cost da resposta (medido: 5s no seedance-2.0-mini = US$ 0,575). Os modelos lightricks/ltx-23-* têm preço fixo por execução (US$ 0,19–0,25).

Esta página foi útil?