# Geração de vídeo por IA

> Geração de vídeo por IA: Crie vídeos curtos a partir de texto ou de uma imagem. A geração é assíncrona.

URL: https://apicultura.app/ferramentas/video-ia/
Atualizado em 05/11/2026 (2026-11-05).

## O que é Geração de vídeo por IA na APIcultura

Acesse Geração de vídeo por IA pelo APIcultura com uma única chave de API e saldo pré-pago em R$. Crie vídeos curtos a partir de texto ou de uma imagem. A geração é assíncrona. Respostas em JSON, cobrança só por chamada concluída e estorno automático em falhas.

Categoria: [Geração de mídia](/catalogo/?cat=midia). Autenticação: chave da própria APIcultura (`apk_live_...`); nenhuma conta de terceiros precisa ser conectada.

## Endpoints e preço por chamada

| Endpoint (slug) | O que faz | Preço por chamada | Rota |
|---|---|---|---|
| `video-texto` | Vídeo a partir de texto | R$ 5,02 | `POST /v1/call/video-texto` |
| `video-imagem` | Vídeo a partir de imagem | R$ 5,02 | `POST /v1/call/video-imagem` |
| `video-wan-texto` | Vídeo (Wan 3.0) | R$ 53,76 | `POST /v1/call/video-wan-texto` |

### Vídeo a partir de texto (`video-texto`)

Gera um vídeo curto a partir de um texto. Preço: R$ 5,02 por chamada.

- `model` (string, obrigatório), ex.: `MiniMax-Hailuo-2.3`
- `prompt` (string, obrigatório), ex.: `A paper boat drifts across a quiet pond at sunrise.`
- `duration` (integer, opcional, padrão 6, mín. 6, máx. 10), ex.: `6`
- `resolution` (string, opcional, padrão "768P"), ex.: `768P`
- `prompt_optimizer` (boolean, opcional, padrão true)

### Schema de entrada de video-texto

```json
{
  "required": [
    "model",
    "prompt"
  ],
  "properties": {
    "model": {
      "type": "string",
      "maxLength": 2000
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000
    },
    "duration": {
      "type": "number"
    },
    "resolution": {
      "type": "string",
      "maxLength": 2000
    },
    "prompt_optimizer": {
      "type": "boolean"
    }
  }
}
```

### Vídeo a partir de imagem (`video-imagem`)

Anima uma imagem em um vídeo curto. Preço: R$ 5,02 por chamada.

- `model` (string, obrigatório), ex.: `MiniMax-Hailuo-02`
- `first_frame_image` (string, obrigatório), ex.: `https://example.com/first-frame.png`
- `prompt` (string, opcional), ex.: `The camera slowly pulls back.`
- `duration` (integer, opcional, padrão 6, mín. 6, máx. 10), ex.: `6`
- `resolution` (string, opcional, padrão "768P"), ex.: `512P`
- `prompt_optimizer` (boolean, opcional, padrão true)

### Schema de entrada de video-imagem

```json
{
  "required": [
    "model",
    "first_frame_image"
  ],
  "properties": {
    "model": {
      "type": "string",
      "maxLength": 2000
    },
    "first_frame_image": {
      "type": "string",
      "maxLength": 2000
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000
    },
    "duration": {
      "type": "number"
    },
    "resolution": {
      "type": "string",
      "maxLength": 2000
    },
    "prompt_optimizer": {
      "type": "boolean"
    }
  }
}
```

### Vídeo (Wan 3.0) (`video-wan-texto`)

Gera um vídeo a partir de um texto com o Wan 3.0. Preço: R$ 53,76 por chamada.

- `model` (string, obrigatório), ex.: `alibaba/wan-3.0`
- `prompt` (string, obrigatório), ex.: `A paper boat crosses a quiet pond at sunrise.`
- `duration` (integer, opcional, padrão 2, máx. 30)
- `resolution` (string, opcional, padrão "480p")
- `aspect_ratio` (string, opcional, padrão "16:9")
- `generate_audio` (boolean, opcional, padrão true)

### Schema de entrada de video-wan-texto

```json
{
  "required": [
    "model",
    "prompt"
  ],
  "properties": {
    "model": {
      "type": "string",
      "maxLength": 2000
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000
    },
    "duration": {
      "type": "number"
    },
    "resolution": {
      "type": "string",
      "maxLength": 2000
    },
    "aspect_ratio": {
      "type": "string",
      "maxLength": 2000
    },
    "generate_audio": {
      "type": "boolean"
    }
  }
}
```

## Exemplo de chamada MCP

Com o MCP da APIcultura conectado, o agente usa a ferramenta `call` com o slug do endpoint e a entrada:

```json
{ "name": "call", "arguments": { "slug": "video-texto", "input": {"model":"MiniMax-Hailuo-2.3","prompt":"A paper boat drifts across a quiet pond at sunrise.","duration":6,"resolution":"768P"}, "max_cost_brl": 0.1 } }
```

## Exemplo de chamada HTTP

```bash
curl -X POST https://api.apicultura.app/v1/call/video-texto \
  -H "Authorization: Bearer $APICULTURA_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"MiniMax-Hailuo-2.3","prompt":"A paper boat drifts across a quiet pond at sunrise.","duration":6,"resolution":"768P"}'
```

## Formato da resposta, preço e limites

A resposta é JSON com `data` (o resultado do endpoint) e `meta` (inclui `cost_brl`, o valor cobrado). Preço deste endpoint: R$ 5,02 por chamada. Falhas do serviço (502) e pedidos recusados (422) não são cobrados. Use `max_cost_brl` para limitar o gasto por chamada; o saldo pré-pago em R$ é o teto. Parâmetros de entrada: exemplo acima.

## Workflows que usam Geração de vídeo por IA

- [Vídeo curto estilo UGC a partir de um briefing](/workflows/video-ugc/)

## Experimente

Teste no playground interativo: [Geração de vídeo por IA no playground](/ferramentas/ferramenta.html?slug=video-ia). Veja também [todas as ferramentas](/ferramentas/), [como conectar seu agente](/como-conectar/) e o [FAQ](/faq/).

> **Nota.** Geração de vídeo por IA é marca de seus respectivos donos, citada apenas para identificar a integração.