ShengshuTutorial
ShengshuCómo usar la API de Vidu Q4
Tutorial paso a paso de la API de Vidu Q4 con Node.js, Python y cURL: envía una tarea de imagen a video, consulta su estado o recibe un webhook y descarga el resultado de video. El ejemplo siguiente cuesta $0,35.
- Endpoints
- 2
- Imagen a video · Video a partir de referencias
- Solicitud de ejemplo
- $0,35
- Imagen a video
- Lenguajes
- 3
- Node.js · Python · cURL
- Generaciones fallidas
- $0
- reembolso automático
Obtener una clave de API
Crea una cuenta, añade saldo y genera una clave en Panel → Claves de API. Guárdala como CHEAPERGEN_API_KEY en tu servidor. Cada solicitud la envía como token bearer.
Elige un endpoint de Vidu Q4
Cada tarea tiene su propio endpoint. Todos reciben un cuerpo JSON y devuelven una generación cuyo estado puedes consultar.
| Tarea | Endpoint | Obligatorio | Desde |
|---|---|---|---|
| Imagen a video | shengshu/vidu-q4/image-to-video | prompt, image_url | $0,0331 por segundo |
| Video a partir de referencias | shengshu/vidu-q4/reference-to-video | prompt, reference_image_urls | $0,0331 por segundo |
Envía un trabajo de imagen a video
Este programa envía la tarea, consulta su estado cada 3 segundos hasta que termina e imprime la URL de video. Cambia el prompt y los ajustes por los tuyos.
const API = "https://cheapergen.com/api/v1";
const headers = {
Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
"Content-Type": "application/json",
};
// 1. Submit the job
let job = await fetch(`${API}/run/shengshu/vidu-q4/image-to-video`, {
method: "POST",
headers,
body: JSON.stringify({
"prompt": "Ella levanta la vista del libro y sonríe mientras empieza a nevar al otro lado de la ventana",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"resolution": "720p",
"duration": 5
}),
}).then((r) => r.json());
// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
await new Promise((r) => setTimeout(r, 3000));
job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}
console.log(job.status === "succeeded" ? job.output.video.url : job.error);Configura los parámetros importantes
Los ajustes de shengshu/vidu-q4/image-to-video y cómo afecta cada uno al precio.
| Parámetro | Tipo · valor predeterminado | Qué hace | Efecto en el precio |
|---|---|---|---|
| resolution | string (enum) · 720p | Resolución de salida. Las resoluciones más altas cuestan más por segundo. 540p · 720p · 1080p · 2K · 4k | 540p: $0,0331 por segundo 720p: $0,0699 por segundo 1080p: $0,0882 por segundo 2K: $0,1397 por segundo 4K: $0,2867 por segundo |
| duration | integer · 5 | Duración del clip generado en segundos (3–16s). Se cobra por segundo. | Se cobra por segundo |
| generate_audio | boolean · true | Genera diálogos y efectos de sonido sincronizados. Están incluidos en el precio. | Ninguno |
| seed | integer | Usa la misma semilla y los mismos ajustes para reproducir un resultado. Déjalo vacío para usar una semilla aleatoria. | Ninguno |
Otros endpoints de Vidu Q4 usan el mismo formato, con sus propias entradas:
POST /api/v1/run/shengshu/vidu-q4/reference-to-video
{
"prompt": "@Image1 saluda a @Image2 en el café de @Image3 y pronuncia la frase de @Audio1",
"reference_image_urls": [
"https://cdn.cheapergen.com/samples/reference-1.jpg",
"https://cdn.cheapergen.com/samples/reference-2.jpg",
"https://cdn.cheapergen.com/samples/reference-3.jpg"
],
"reference_audio_urls": [
"https://cdn.cheapergen.com/samples/reference-1.mp3"
],
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": 5
}Obtén el resultado
Una tarea pasa de queued a running y luego a succeeded, failed o canceled. Consulta GET /api/v1/generations/{id} o proporciona webhook_url para que te enviemos el resultado mediante una solicitud POST. Descarga y guarda el resultado por tu cuenta.
200 — succeeded
{
"id": "gen_8c2QmX1nq0k4",
"object": "generation",
"model": "shengshu/vidu-q4",
"endpoint": "shengshu/vidu-q4/image-to-video",
"mode": "image-to-video",
"status": "succeeded",
"input": {
"prompt": "Ella levanta la vista del libro y sonríe mientras empieza a nevar al otro lado de la ventana",
"image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
"resolution": "720p",
"duration": 5
},
"output": {
"video": {
"url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
"content_type": "video/mp4",
"duration": 5,
"width": 1280,
"height": 720
}
},
"error": null,
"cost": {
"amount_usd": 0.2255,
"currency": "usd",
"estimated": false,
"official_usd": 0.264,
"list_price_source": "official",
"list_price_label": "Official",
"saved_usd": 0.0385
},
"source": "api",
"created_at": "2026-10-15T09:21:04Z",
"started_at": "2026-10-15T09:21:06Z",
"completed_at": "2026-10-15T09:22:31Z"
}Calcula el precio antes de ejecutar una solicitud
El endpoint de cotización es gratis y no requiere una clave. Devuelve el precio, el precio oficial y tu descuento para los datos exactos que envíes.
curl -X POST https://cheapergen.com/api/v1/quote/shengshu/vidu-q4/image-to-video \
-H "Content-Type: application/json" \
-d '{"prompt":"Ella levanta la vista del libro y sonríe mientras empieza a nevar al otro lado de la ventana","image_url":"https://cdn.cheapergen.com/samples/portrait.jpg","resolution":"720p","duration":5}'| Estado | Código | Significado |
|---|---|---|
| 400 | invalid_request | Falta un parámetro o está fuera de rango; el mensaje indica cuál. |
| 401 | unauthorized | Falta la clave de API, está mal formada o fue revocada. |
| 402 | insufficient_balance | El saldo no alcanza para el precio cotizado; añade créditos o activa la recarga automática. |
| 429 | rate_limited | Hay demasiadas solicitudes o generaciones en curso; espera un poco y vuelve a intentarlo. |
| 502 | upstream_error | El proveedor del modelo falló; se reembolsa el importe reservado y puedes volver a intentarlo. |
| 503 | model_unavailable | No hay ninguna ruta disponible en este momento; inténtalo más tarde o elige otro modelo. |
Preguntas frecuentes
Preguntas sobre la API de Vidu Q4
No. La API usa HTTPS y JSON, así que los ejemplos de Node.js (fetch) y Python (requests) de esta página son programas completos. Funciona cualquier lenguaje que pueda enviar solicitudes HTTP.
Sí. Añade "webhook_url" al cuerpo de la solicitud y enviaremos la generación terminada mediante POST, firmada con la cabecera CheaperGen-Signature (HMAC-SHA256 de la marca de tiempo y el cuerpo sin procesar). También puedes consultar GET /api/v1/generations/{id}.
Pasa URL públicas en "image_url", "reference_image_urls", "reference_audio_urls". Si un archivo no tiene URL pública, primero puedes subirlo con POST /api/v1/uploads; recibirás una URL para usar en la solicitud.
Imagen a video cuesta desde $0,0331 por segundo; la solicitud de ejemplo de esta página cuesta $0,35, 26% por debajo de el precio oficial. Las generaciones fallidas se reembolsan automáticamente.