Guia do modelo

API do Vidu: modelos Vidu Q3 e Q4, preços e código

O Vidu divide seus modelos por entrada: o Q3 Turbo e o Q3 Pro trabalham a partir de um prompt ou de um quadro inicial, enquanto o Q3, o Q3 Mix e o Q4 são construídos em torno de imagens de referência. Veja o que cada um faz, quanto custa por segundo e como chamá-lo.

Os modelos Vidu na Revana

O Vidu é a família de vídeo da Shengshu. Seus modelos se dividem pelo que você envia: alguns trabalham a partir de um prompt ou de um quadro inicial, outros são construídos em torno de imagens de referência, em que você entrega ao modelo personagens, produtos ou lugares e ele os coloca em uma só cena. Todos aceitam a mesma requisição na Revana:

Modelos Vidu comparados
ModeloId do modeloFazResoluçãoDuraçãoSomPreço a partir de
Vidu Q3 Turbovidu-q3-turbotexto para vídeo, imagem para vídeo, primeiro e último quadros540p, 720p, 1080p1 a 16 syes$0.04 / s
Vidu Q3 Providu-q3-protexto para vídeo, imagem para vídeo, primeiro e último quadros540p, 720p, 1080p1 a 16 syes$0.07 / s
Vidu Q3vidu-q3imagens de referência (até 7)540p, 720p, 1080p3 a 16 sno$0.05 / s
Vidu Q3 Mixvidu-q3-miximagens de referência (até 7)720p, 1080p1 a 16 sno$0.13 / s
Vidu Q4vidu-q4imagem para vídeo, imagens de referência540p a 4Kdefinido pelo modelono$0.05 / s
Vidu Q4 Previewvidu-q4-previewimagem para vídeo, imagens de referência (até 15)540p a 4K3 a 16 syes$0.06 / s

Cada modelo Vidu tem uma rota na Revana hoje. Vale saber disso para uso em produção: se essa rota estiver ocupada, o job espera ou falha em vez de passar para outro provedor, e um job que falha não custa nada.

Qual Vidu usar

  • O Vidu Q3 Turbo para clipes baratos a partir de texto ou de um quadro inicial, com som: $0.07 por segundo em 1080p é um dos menores preços de 1080p do catálogo.
  • O Vidu Q3 Pro quando você quer o nível Q3 mais alto para os mesmos jobs.
  • O Vidu Q3 ou Q3 Mix para referência para vídeo: envie até sete imagens (um personagem, uma roupa, um produto, um lugar) e descreva a cena.
  • O Vidu Q4 Preview para até 15 referências, som e saída de até 4K.

Clipes a partir de 1 segundo tornam o Vidu útil para loops curtos, giros de produto e transições que outros modelos não alcançam.

Preços do Vidu (outubro de 2026)

Preço do Vidu por segundo e por clipe
ModeloResoluçãoPor segundoClipe de 5 sClipe de 10 s
Vidu Q3 Turbo540p$0.04$0.20$0.40
Vidu Q3 Turbo1080p$0.07$0.35$0.70
Vidu Q3 Pro720p$0.15$0.75$1.50
Vidu Q3 Pro1080p$0.16$0.80$1.60
Vidu Q3720p$0.10$0.50$1.00
Vidu Q31080p$0.13$0.65$1.30
Vidu Q3 Mix1080p$0.15$0.75$1.50
Vidu Q4 Preview1080p$0.13$0.65$1.30
Vidu Q4 Preview4K$0.42$2.10$4.20

O Vidu Q4 lista $0.12 por segundo em 1080p e $0.39 em 4K e não lista opções próprias de duração ou formato. O valor exato cobrado em qualquer job volta como cost_usd. Para os preços de outros modelos, veja o guia da API de vídeo mais barata.

Gere um clipe do Vidu Q3 Turbo

Envie POST /v1/generations e consulte a geração até ela ter succeeded ou failed. Este clipe de 8 segundos em 1080p com som custa $0.56.

cURL
export REVANA_API_KEY="sr_live_..."

# 1. Submit the job (returns 202 with the generation id)
curl https://api.revana.si/v1/generations \
  -H "Authorization: Bearer $REVANA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "vidu-q3-turbo",
    "input": {
      "prompt": "A paper boat drifts down a rain-filled gutter, passing fallen leaves, the camera following at water level. Rain patter and a distant tram bell.",
      "resolution": "1080p",
      "duration": 8,
      "aspect_ratio": "16:9",
      "audio": true
    },
    "max_cost_usd": 0.7
  }'

# 2. Poll with the id from step 1 until status is "succeeded" or "failed"
curl https://api.revana.si/v1/generations/gen_01JC2V8K5T \
  -H "Authorization: Bearer $REVANA_API_KEY"
Python
import os
import time

import requests

API = "https://api.revana.si/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['REVANA_API_KEY']}"}

resp = requests.post(f"{API}/generations", headers=HEADERS, json={
    "model": "vidu-q3-turbo",
    "input": {
        "prompt": "A paper boat drifts down a rain-filled gutter, passing fallen leaves, the camera following at water level. Rain patter and a distant tram bell.",
        "resolution": "1080p",
        "duration": 8,
        "aspect_ratio": "16:9",
        "audio": True,
    },
    "max_cost_usd": 0.7,
})
resp.raise_for_status()
job = resp.json()

while job["status"] in ("queued", "running"):
    time.sleep(5)
    job = requests.get(f"{API}/generations/{job['id']}", headers=HEADERS).json()

if job["status"] == "succeeded":
    print(job["output"]["urls"], job["cost_usd"])
else:
    print("Failed:", job["error"])
Node.js
// Node 18 or later. Save as generate.mjs and run: node generate.mjs
const API = "https://api.revana.si/v1";
const headers = {
  Authorization: `Bearer ${process.env.REVANA_API_KEY}`,
  "Content-Type": "application/json",
};

const res = await fetch(`${API}/generations`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    model: "vidu-q3-turbo",
    input: {
      prompt: "A paper boat drifts down a rain-filled gutter, passing fallen leaves, the camera following at water level. Rain patter and a distant tram bell.",
      resolution: "1080p",
      duration: 8,
      aspect_ratio: "16:9",
      audio: true,
    },
    max_cost_usd: 0.7,
  }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
let job = await res.json();

while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 5000));
  job = await (await fetch(`${API}/generations/${job.id}`, { headers })).json();
}

if (job.status === "succeeded") console.log(job.output.urls, job.cost_usd);
else console.error("Failed:", job.error);

Coloque várias referências em uma cena com o Vidu Q3

Para referência para vídeo, envie as imagens em image_urls (até sete no Q3) e diga no prompt como elas se juntam. Faça primeiro o upload dos arquivos locais com POST /v1/uploads. Este clipe de 6 segundos em 720p custa $0.60:

Corpo da requisição
{
  "model": "vidu-q3",
  "input": {
    "prompt": "The woman from the first image, wearing the jacket from the second image, walks into the cafe from the third image and waves at the camera.",
    "image_urls": [
      "https://example.com/woman.jpg",
      "https://example.com/jacket.png",
      "https://example.com/cafe.jpg"
    ],
    "resolution": "720p",
    "duration": 6,
    "aspect_ratio": "9:16"
  },
  "max_cost_usd": 0.8
}

O Vidu Q3 e o Q3 Mix só aceitam imagens de referência. Um único quadro inicial em image_url é recusado antes de qualquer cobrança; use o Q3 Turbo ou o Q3 Pro para isso.

Todos os modelos Vidu estão na página de modelos, os campos de entrada estão na documentação e os pacotes de créditos estão na página de preços. Obtenha uma chave de API para testá-los.

Perguntas frequentes

Quanto custa a API do Vidu?

Em outubro de 2026, o Vidu Q3 Turbo custa de $0.04 por segundo em 540p a $0.07 em 1080p. O Vidu Q3 Pro custa $0.16 em 1080p e o Vidu Q3 custa $0.13 em 1080p.

Qual é a diferença entre o Vidu Q3, o Q3 Turbo e o Q3 Pro?

O Q3 Turbo e o Q3 Pro trabalham a partir de um prompt, de um quadro inicial ou do primeiro e último quadro, com som. O Vidu Q3 e o Q3 Mix trabalham a partir de até sete imagens de referência.

Qual a duração máxima de um clipe do Vidu?

Até 16 segundos. O Q3 Turbo, o Q3 Pro e o Q3 Mix vão até 1 segundo no mínimo; o Vidu Q3 e o Q4 Preview começam em 3 segundos.

O Vidu suporta 4K?

O Vidu Q4 e o Vidu Q4 Preview chegam a 4K. Os modelos Q3 param em 1080p.

O Vidu gera som?

O Vidu Q3 Turbo, o Q3 Pro e o Q4 Preview geram. Defina audio como true.

Experimente o Vidu com uma só chave

Uma chave de API para todos os modelos Vidu e todos os outros modelos de vídeo e imagem. Crédito pré-pago a partir de $10, cobrado apenas pelos clipes entregues.