Vídeo

Vidu Q4 Preview API

Vidu Q4 API en APIMart (model ID viduq4-preview, a menudo escrito viduq4): Vidu Q4 Preview de ShengShu convierte un primer fotograma, o 1–15 imágenes de referencia con hasta 3 clips de audio de referencia, en videos de 3–16 segundos hasta 4K con audio nativo. Es el modelo más reciente de la familia Vidu API en APIMart.

Imagen a vídeoReferencias a vídeo3–16 segundosHasta 4K

Obtener Clave de API Documentación de API

Aspectos destacados del servicio

Descuentos Oficiales
Pago por uso
Rápido y baja latencia

Input

Modelo

Modo de generación

Primer frame

Prompt

Resolución

Duración5s

Audio

Semilla

Output

Video link valid for 72 hours

Detalles de Precios

Precios transparentes sin tarifas ocultas. Paga solo por lo que uses.

Variante	Nivel	Precio OroPrecio actual	Precio Platino	Precio Diamante	Precio oficial	Tu ahorro
`viduq4-preview`	540p	0.448Credits(~$0.0448)/seg	0.4256Credits(~$0.0426)/seg	0.4032Credits(~$0.0403)/seg	0.56Credits(~$0.056)/seg	20%
	720p	0.912Credits(~$0.0912)/seg	0.8664Credits(~$0.0866)/seg	0.8208Credits(~$0.0821)/seg	1.14Credits(~$0.114)/seg	20%
	1080p	1.024Credits(~$0.1024)/seg	0.9728Credits(~$0.0973)/seg	0.9216Credits(~$0.0922)/seg	1.28Credits(~$0.128)/seg	20%
	2K	1.624Credits(~$0.1624)/seg	1.5428Credits(~$0.1543)/seg	1.4616Credits(~$0.1462)/seg	2.03Credits(~$0.203)/seg	20%
	4K	3.328Credits(~$0.3328)/seg	3.1616Credits(~$0.3162)/seg	2.9952Credits(~$0.2995)/seg	4.16Credits(~$0.416)/seg	20%

* Los costos reales dependen del resultado final.

Vidu Q4 API: anima imágenes y referencias hasta 4K

Genera videos con Vidu Q4 online en el generador de arriba o llama a la Vidu Q4 API desde tu app. Empieza con un primer fotograma y un prompt opcional, o combina 1–15 imágenes de referencia, un prompt y hasta 3 MP3. Elige 3–16 segundos y de 540p a 4K; el audio viene activado por defecto al mismo precio.

Funciones de la API Vidu Q4 Preview

Entradas compatibles, controles de salida y entrega asíncrona

Imagen inicial o referencias

I2V utiliza una imagen inicial y R2V de 1 a 15 imágenes de referencia. Admite PNG, JPEG y WEBP, hasta 50 MB cada una. No admite texto solo ni fotogramas finales.

Prompts según el modo

Describe la acción, la cámara o la escena con hasta 20.000 caracteres. El prompt es opcional con una imagen inicial y obligatorio para vídeo basado en referencias.

Cinco resoluciones de salida

Elige 540p, 720p, 1080p, 2K o 4K. La opción predeterminada es 720p. Ajusta la resolución al destino, las necesidades visuales y el presupuesto.

Clips de 3 a 16 segundos

Define una duración entera entre 3 y 16 segundos, con 5 por defecto. Evalúa el movimiento en un clip corto antes de planificar una escena más larga.

Audio generado y de referencia

El audio generado está activado por defecto; desactivarlo no cambia el precio. R2V admite hasta 3 MP3 de 3–12 segundos y hasta 50 MB cada uno, sin recargo por materiales.

Control de semilla

Utiliza una semilla entera para explorar resultados relacionados. Omítela o usa 0 para un resultado aleatorio. Revisa el movimiento antes de publicar.

Flujo de tareas unificado

Envía POST /v1/videos/generations y guarda el task_id. Consulta GET /v1/tasks/{task_id} hasta completar o fallar, sin crear de nuevo la tarea.

Facturación por resolución

Ambos modos facturan la duración por la tarifa actual por segundo de la resolución elegida. Las imágenes y el audio de referencia, así como el audio generado, no añaden recargos. Consulta las tarifas de la cuenta; las tareas fallidas reciben un reembolso completo.

Usos de vídeo desde imágenes y referencias

Flujos creativos a partir de una imagen inicial aprobada o de referencias

Clips de productos y marcas

Anima una foto de producto para crear una breve presentación. Sugiere el movimiento y revisa los detalles del producto y su adecuación a la marca.

Contenido para redes sociales

Convierte una imagen en una introducción de vídeo de 3 a 16 segundos. Elige la resolución según el canal y decide entre audio o salida silenciosa.

Guiones gráficos y propuestas

Anima una viñeta de storyboard o combina referencias y un prompt para explorar una escena y la dirección de cámara. Revisa cada clip antes del montaje final.

Estudios de movimiento de personajes

Explora el movimiento de un retrato o ilustración, o guía una escena con referencias del personaje y audio opcional. Revisa identidad, movimiento e idoneidad antes de usarla.

Educación y explicaciones

Anima una escena o ilustración preparada para una lección breve. Comprueba la exactitud visual y añade narración o subtítulos verificados durante la edición.

Conceptos de juegos y entornos

Da movimiento a un concepto de entorno o una escena de juego. Utiliza los clips para explorar la atmósfera y realizar revisiones creativas internas.

Cómo obtener una API key de Vidu Q4 y empezar

Tres pasos para tu primer video con Vidu Q4 en APIMart.

Regístrate y recarga

Crea una cuenta de APIMart y recarga saldo. Sirve para todos los modelos de la plataforma, incluida la Vidu API.

→

Crea tu API key

Genera una API key en tu panel. La misma key llama a Vidu Q4 y a los demás modelos de APIMart.

→

Envía tu primera petición

POST /v1/videos/generations con model viduq4-preview y consulta GET /v1/tasks/{task_id} hasta que el video esté listo.

Comenzar a Crear

Ejemplo de Vidu Q4 API: imagen a video y referencias a video

Llama a Vidu Q4 Preview en APIMart con una sola petición POST. La generación es asíncrona: envía una tarea y luego consulta el endpoint de tareas para obtener la URL del video.

1
Autentica las peticiones a la Vidu Q4 API
Guarda tu key de APIMart en la variable de entorno APIMART_API_KEY y envíala como Authorization: Bearer <key> en cada petición.
2
Envía una tarea de Vidu Q4
POST /v1/videos/generations con model viduq4-preview y los recursos del ejemplo. El ID de tarea está en data[0].task_id.
3
Obtén el video de Vidu Q4
Consulta GET /v1/tasks/{task_id} hasta que status sea completed y lee la URL del video en data.result.videos[0].url[0]. Los resultados se guardan 72 horas, así que descárgalos a tiempo.
Consulta la referencia de Vidu Q4 Preview API para ver cada parámetro, regla de recursos y campo de respuesta.

POST /v1/videos/generations

curl -X POST https://api.apimart.ai/v1/videos/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq4-preview",
    "prompt": "La cámara se acerca lentamente mientras la persona se gira y sonríe",
    "image_urls": [
      "https://example.com/first-frame.png"
    ],
    "duration": 5,
    "resolution": "720p",
    "audio": true
  }'

import os
import time
import requests

API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}

# 1. Submit the generation task
payload = {
  "model": "viduq4-preview",
  "prompt": "La cámara se acerca lentamente mientras la persona se gira y sonríe",
  "image_urls": [
    "https://example.com/first-frame.png"
  ],
  "duration": 5,
  "resolution": "720p",
  "audio": True
}
resp = requests.post(f"{API_BASE}/v1/videos/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]

# 2. Poll the task until it finishes
for _ in range(200):
    task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
    task_resp.raise_for_status()
    task = task_resp.json()["data"]
    if task["status"] == "completed":
        print(task["result"]["videos"][0]["url"][0])
        break
    if task["status"] == "failed":
        raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
    time.sleep(10)
else:
    raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")

curl -X POST https://api.apimart.ai/v1/videos/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq4-preview",
    "prompt": "El personaje de la imagen 1 camina por la calle de la imagen 2 al atardecer, diálogo natural y sonidos de ciudad",
    "image_urls": [
      "https://example.com/character.png",
      "https://example.com/scene.png"
    ],
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

TASK_ID="task_xxx"  # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $APIMART_API_KEY"

Parámetros de Vidu Q4 API

Parámetro	Tipo	Obligatorio	Por defecto	Descripción
`model`	string	Sí	Por defecto: —	Usa viduq4-preview.
`prompt`	string	Opcional	Por defecto: —	Hasta 20.000 caracteres. Opcional en imagen a video, obligatorio en referencias a video.
`image_urls`	string[]	Opcional	Por defecto: —	URL públicas o data URL en Base64. 1 imagen para imagen a video, 1–15 para referencias a video.
`image_with_roles`	object[]	Opcional	Por defecto: —	Imágenes con rol: first_frame, o reference_image para referencias a video.
`first_frame_image`	string	Opcional	Por defecto: —	Primer fotograma solo para imagen a video. No lo combines con otras imágenes ni con audio.
`audio_urls`	string[]	Opcional	Por defecto: —	Hasta 3 clips MP3 de referencia, de 3–12 segundos cada uno, solo para referencias a video.
`duration`	integer	Opcional	Por defecto: 5	Duración en segundos: 3–16. Por defecto 5.
`resolution`	string	Opcional	Por defecto: 720p	Resolución de salida: 540p, 720p, 1080p, 2K o 4K. Por defecto 720p.
`aspect_ratio`	string	Opcional	Por defecto: 16:9	1:1, 9:16, 16:9, 3:4 o 4:3 en referencias a video. Por defecto 16:9; se ignora en imagen a video.
`audio`	boolean	Opcional	Por defecto: true	Genera diálogos y efectos de sonido. Por defecto true; false devuelve un video sin sonido.
`seed`	integer	Opcional	Por defecto: —	Seed entera que controla la aleatoriedad. Omítela para una seed aleatoria.

Familia de modelos Vidu API

Compara todos los modelos de video Vidu en APIMart. Una sola API key los llama a todos, con cobro por segundo de video.

Modelo	Ideal para	Resolución	Duración
Vidu Q4 Preview APIEsta página	Última generación: anima un primer fotograma o combina de 1 a 15 imágenes de referencia con hasta 3 clips de audio	540p – 4K	3–16s
Vidu Q3 Pro API	Texto a video, imagen a video y primer-último fotograma, con audio por defecto	540p / 720p / 1080p	1–16s
Vidu Q3 Turbo API	Los mismos modos que Vidu Q3 Pro con la tarifa por segundo más baja de la serie Vidu	540p / 720p / 1080p	1–16s
Vidu Q3 API	Referencia a video del día a día con 1 a 7 imágenes y cambio inteligente de ángulo de cámara	540p / 720p / 1080p	3–16s
Vidu Q3 Mix API	Referencia a video premium con 1 a 7 imágenes, transiciones inteligentes más fluidas y efectos de movimiento cortos	720p / 1080p	1–16s

Preguntas sobre la API Vidu Q4 Preview

Entradas, parámetros, facturación y resultados

¿Qué es Vidu Q4 Preview?

Vidu Q4 Preview es el modelo de video Vidu más reciente de ShengShu en APIMart, también buscado como Vidu Q4, viduq4 o Vidu AI Q4. Su ID de API es viduq4-preview. Anima un primer fotograma o sigue 1–15 imágenes de referencia, con audio de referencia opcional, y genera clips de 3–16 segundos hasta 4K.

¿Cuándo salió Vidu Q4?

ShengShu lanzó Vidu Q4 Preview el 7 de octubre de 2026 y todavía no ha anunciado fecha para la versión final de Vidu Q4. En APIMart, la Vidu Q4 API llama a Vidu Q4 Preview con el model ID viduq4-preview.

¿Vidu Q4 Preview y la Vidu Q4 API son lo mismo?

Sí. Vidu Q4 Preview es la versión de Vidu Q4 disponible hoy, y la Vidu Q4 API de APIMart la llama con el model ID viduq4-preview. Escribe el model ID tal cual, en minúsculas.

¿Vidu Q4 Preview admite texto a video?

No. viduq4-preview requiere imágenes: una imagen inicial para I2V o de 1 a 15 referencias para R2V. R2V también admite hasta 3 clips de audio de referencia. No admite generación solo con texto ni control conjunto del fotograma inicial y final.

¿Cómo elijo la imagen inicial o las referencias?

first_frame_image o el rol first_frame seleccionan I2V, al igual que una imagen sin rol ni audio de referencia. El rol reference_image (alias reference), varias imágenes o imágenes sin rol con audio de referencia seleccionan R2V. No mezcles un fotograma inicial explícito con referencias o su audio. image_urls e image_with_roles comparten un máximo de 15 referencias. PNG, JPEG/JPG y WEBP: hasta 50 MB por imagen; la solicitud Base64 debe ocupar menos de 20 MB.

¿Es obligatorio indicar instrucciones?

El prompt es opcional en I2V y obligatorio en R2V, con hasta 20.000 caracteres en ambos modos. Describe la acción, la escena y cómo deben guiar el vídeo las referencias.

¿Cuál es la duración máxima de un video de Vidu Q4 y qué resoluciones admite?

Los videos de Vidu Q4 Preview duran como máximo 16 segundos. Duración entera de 3–16 segundos, 5 por defecto. Resoluciones: 540p, 720p, 1080p, 2K o 4K, con 720p por defecto. R2V admite 1:1, 9:16, 16:9, 3:4 y 4:3; el valor predeterminado es 16:9. aspect_ratio tiene prioridad sobre su alias size. I2V ignora ambos campos y sigue la imagen inicial.

¿Cómo funcionan el audio y la semilla?

El audio generado vale true por defecto; false crea vídeo silencioso al mismo precio. R2V acepta 0–3 MP3 de referencia, de 3–12 segundos y hasta 50 MB cada uno. El proveedor comprueba formato y duración; un clip inválido puede causar un fallo con reembolso. Seed acepta un entero; omitirlo o usar 0 solicita un valor aleatorio.

¿Cuánto cuesta la Vidu Q4 API?

Vidu Q4 se cobra por segundo de salida según la resolución elegida. Al 4 de noviembre de 2026, las tarifas Gold son 540p $0,0448, 720p $0,0912, 1080p $0,1024, 2K $0,1624 y 4K $0,3328 por segundo, así que un clip de 5 segundos en 720p cuesta unos $0,46. Con o sin audio cuesta lo mismo, y las imágenes o audios de referencia no tienen cargo adicional. La tabla de precios muestra las tarifas en vivo.

¿Me cobran si una tarea de Vidu Q4 falla?

No. Los errores de parámetros, como mezclar un primer fotograma con imágenes de referencia o superar el límite de imágenes o audios, devuelven HTTP 400 al enviar, sin crear la tarea ni cobrar. Si una tarea falla durante la generación, por ejemplo por un audio de referencia no válido, se reembolsa por completo de forma automática.

¿Cómo consigo una API key de Vidu Q4?

Regístrate en APIMart, recarga saldo y crea una key en la página API Keys. La misma key llama a Vidu Q4, a los modelos Vidu Q3 y a todos los demás modelos de APIMart, con pago por uso y sin suscripción.

¿Cómo recupero el vídeo generado?

POST /v1/videos/generations devuelve un task_id. Consulta GET /v1/tasks/{task_id} cada 5–10 segundos hasta completed o failed. Los enlaces del vídeo aparecen en data.result.videos[0].url[0].

¿Cuánto tiempo se guardan los videos de Vidu Q4?

Los resultados se guardan durante 72 horas, así que descárgalos a tiempo. Si una consulta de estado agota el tiempo, la tarea no ha fallado necesariamente; sigue consultando el task ID original en vez de enviar una nueva.

¿Puedo probar Vidu Q4 online?

Sí. Inicia sesión en APIMart, crea una API key y recarga saldo; luego usa el generador de la parte superior de esta página para crear videos con Vidu Q4 en tu navegador. El playground llama a la misma API y se cobra por segundo con las mismas tarifas, y los videos terminados aparecen en tus generaciones recientes.

Vidu Q4 vs Vidu Q3: ¿cuál uso?

Usa Vidu Q4 para salida hasta 4K, 1–15 imágenes de referencia o audio de referencia. Vidu Q4 necesita una imagen, así que para texto a video o primer y último fotograma usa Vidu Q3 Pro o Q3 Turbo. Para video por referencias con 1–7 imágenes, Vidu Q3 cuesta menos por segundo que Vidu Q4 y Vidu Q3 Mix admite clips desde 1 segundo.

Vidu Q4 vs Seedance 2.5 vs Kling 4.0: ¿cuál conviene?

Usa Vidu Q4 para salida de hasta 4K a partir de un primer fotograma o de hasta 15 imágenes de referencia; al 5 de noviembre de 2026 cuesta $0,0912 por segundo en 720p para miembros Gold, pero no hace texto a video y los clips llegan a 16 segundos. Usa Seedance 2.5 para hasta 30 segundos en hasta 1080p con texto a video, edición y extensión de video, y hasta 50 referencias. Usa Kling 4.0 para clips de 3–30 segundos en 720p o 1080p con audio estéreo siempre activo, además de edición y extensión. Las tarifas de Seedance 2.5 y Kling 4.0 están en sus páginas de modelo.

Modelos Relacionados

Explora más modelos de la misma categoría.

Ver Todos los Modelos →