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:
| Modelo | Id do modelo | Faz | Resolução | Duração | Som | Preço a partir de |
|---|---|---|---|---|---|---|
| Vidu Q3 Turbo | vidu-q3-turbo | texto para vídeo, imagem para vídeo, primeiro e último quadros | 540p, 720p, 1080p | 1 a 16 s | yes | $0.04 / s |
| Vidu Q3 Pro | vidu-q3-pro | texto para vídeo, imagem para vídeo, primeiro e último quadros | 540p, 720p, 1080p | 1 a 16 s | yes | $0.07 / s |
| Vidu Q3 | vidu-q3 | imagens de referência (até 7) | 540p, 720p, 1080p | 3 a 16 s | no | $0.05 / s |
| Vidu Q3 Mix | vidu-q3-mix | imagens de referência (até 7) | 720p, 1080p | 1 a 16 s | no | $0.13 / s |
| Vidu Q4 | vidu-q4 | imagem para vídeo, imagens de referência | 540p a 4K | definido pelo modelo | no | $0.05 / s |
| Vidu Q4 Preview | vidu-q4-preview | imagem para vídeo, imagens de referência (até 15) | 540p a 4K | 3 a 16 s | yes | $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)
| Modelo | Resolução | Por segundo | Clipe de 5 s | Clipe de 10 s |
|---|---|---|---|---|
| Vidu Q3 Turbo | 540p | $0.04 | $0.20 | $0.40 |
| Vidu Q3 Turbo | 1080p | $0.07 | $0.35 | $0.70 |
| Vidu Q3 Pro | 720p | $0.15 | $0.75 | $1.50 |
| Vidu Q3 Pro | 1080p | $0.16 | $0.80 | $1.60 |
| Vidu Q3 | 720p | $0.10 | $0.50 | $1.00 |
| Vidu Q3 | 1080p | $0.13 | $0.65 | $1.30 |
| Vidu Q3 Mix | 1080p | $0.15 | $0.75 | $1.50 |
| Vidu Q4 Preview | 1080p | $0.13 | $0.65 | $1.30 |
| Vidu Q4 Preview | 4K | $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.
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"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 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:
{
"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.