PixVerse

PixVerse V6

pixverse-v6/image-to-video

Modelo insignia de generación de video de PixVerse, un único modelo que abarca la generación de video a partir de texto y a partir de imágenes, con control preciso de cámara, actuación de personajes y fusión de imágenes de referencia, orientado a la producción de nivel final

pixverse-v6/image-to-video pixverse-v6/text-to-video

Precios

pixverse-v6/image-to-video per second

Especificaciones	360P	540P	720P	1080P
Sound Off	$0.036	$0.050	$0.0645	$0.129
Sound On	$0.050	$0.0645	$0.086	$0.1645

Descripción general

El modelo de imagen a vídeo PixVerse V6 convierte imágenes estáticas en vídeos dinámicos, orientado a desarrolladores y equipos creativos que necesitan transformar rápidamente imágenes de productos, personajes o guiones gráficos en material de vídeo comercializable. El modelo ancla la composición y la proporción del encuadre a partir de la imagen del primer fotograma, describe el movimiento y la atmósfera mediante prompts y permite elegir preajustes de estilo, resolución y duración. La salida es un archivo de vídeo, adecuado para integrarse en flujos automatizados de producción publicitaria, guiones gráficos de microdramas y animación por lotes de material.

Puntos clave

Composición y relación de aspecto ancladas al primer fotograma: el vídeo de salida mantiene la relación de aspecto de la imagen de entrada, lo que reduce los costes de recorte y adaptación entre distintos materiales.
Generación opcional de audio y vídeo sincronizados de forma nativa: al activarla, se generan junto con el vídeo música de fondo, efectos de sonido y diálogos, lo que elimina el paso de doblaje y musicalización por separado.
Doble control mediante preajustes de estilo y prompts negativos: permite aplicar estilos predefinidos como anime, plastilina o ciberpunk, y excluir contenidos no deseados con prompts negativos.
Semilla reproducible del mismo resultado: fijar la seed y el prompt permite reproducir de forma estable la misma salida, lo que facilita la generación por lotes y la comparación de versiones.

Descripción de capacidades

Síntesis de imagen a vídeo: utiliza una URL de imagen pública como primer fotograma y genera vídeo junto con prompts de movimiento y atmósfera, ideal para convertir material visual existente directamente en contenido dinámico.

Duración y resolución flexibles: la duración se puede configurar entre 1 y 15 segundos, y la resolución admite 360p, 540p, 720p y 1080p, lo que facilita ajustar las especificaciones según el canal de difusión y las necesidades de previsualización.

Generación sincronizada de audio y vídeo: se puede activar la generación de audio para producir junto con el vídeo música de fondo, efectos de sonido y diálogos, lo que reduce el trabajo de creación de pistas de audio en posproducción.

Preajustes de estilo y prompts negativos: incluye cinco preajustes de estilo integrados (anime, animación 3D, plastilina, cómic y ciberpunk) y admite prompts negativos para evitar elementos visuales no deseados.

Semilla aleatoria reproducible: fijar la seed y el prompt permite reproducir el mismo resultado, lo que facilita mantener la coherencia en tareas por lotes o realizar experimentos de comparación.

Casos de uso

Equipos de marketing que convierten imágenes de productos en vídeos cortos: generan clips con movimiento y atmósfera a partir de la imagen del producto como primer fotograma, utilizables directamente como material animado para anuncios en feed o páginas de detalle de comercio electrónico.
Equipos de microdramas y guiones gráficos que animan bocetos de composición: convierten las imágenes del guion gráfico en planos dinámicos para previsualización previa o como fragmentos de la pieza final, lo que acelera la validación del ritmo narrativo.
Animación por lotes de material de personajes y de marca: con semilla fija y preajustes de estilo, producen vídeos con estilo uniforme a partir de series de imágenes de personajes o visuales de marca, para la programación de contenidos en redes sociales.
Desarrolladores que integran flujos automatizados de generación de vídeo: envían imágenes y prompts por tarea a través de una interfaz unificada y producen activos de vídeo por lotes para que los consuman plataformas de contenido o herramientas creativas.

Limitaciones y recomendaciones de selección

Este modelo solo admite imagen a vídeo y requiere una imagen de primer fotograma; no puede generar directamente solo a partir de texto. La duración máxima es de 15 segundos, por lo que no es adecuado para narraciones continuas que requieran planos largos. Solo hay cinco preajustes de estilo y la información pública carece de evaluaciones independientes de terceros sobre calidad de imagen y estabilidad del movimiento, por lo que la selección debe basarse en pruebas reales con material propio. La facturación se realiza por segundos de salida, de modo que el coste crece linealmente con la duración del vídeo final; los vídeos largos o las tareas de gran volumen requieren una evaluación presupuestaria previa. Si se necesita mayor duración o narrativa con múltiples planos, se recomienda combinar con la línea de texto a vídeo de la misma familia o generar por segmentos y unir después.

Preguntas frecuentes

Ver todas las preguntas →

¿Qué es el video a partir de imagen de PixVerse V6?

Es la versión de video a partir de imagen de PixVerse V6: sube una imagen como primer fotograma y luego usa un prompt para describir la acción, el movimiento de cámara y la atmósfera que deseas añadir, y genera un video de 1 a 15 segundos, de 360p a 1080p, con audio sincronizado y preajustes de estilo opcionales.
¿Qué determina la relación de aspecto del video de salida?

La determina la relación de aspecto de la imagen del primer fotograma, es decir, de image_url; por eso el modelo de imagen a video no tiene el parámetro aspect_ratio. Si se necesita formato vertical, sube una imagen vertical; si se necesita 16:9, sube una imagen horizontal.
¿Cómo se debe escribir el prompt?

Escribe solo los cambios que deseas que ocurran: la acción del sujeto, el movimiento de cámara, los cambios en el entorno y el sonido; no es necesario repetir lo que ya aparece en la imagen. Especifica claramente qué elementos deben permanecer sin cambios, por ejemplo, «la cámara permanece estática» o «el fondo no cambia».
¿Qué requisitos hay para la imagen de entrada?

image_url debe ser una dirección de imagen accesible directamente desde la red pública; en el Playground también se puede subir directamente. Las imágenes con un sujeto claro, una composición completa y espacio para el movimiento tienden a generar un movimiento más estable.

Crear una tarea de generación

POST https://api.hiapi.ai/v1/tasks

Encabezados

AuthorizationstringObligatorio

Clave API de la cuenta. Obligatoria en cada solicitud. Ejemplo: Bearer YOUR_HIAPI_API_KEY. Obtener clave API

Content-TypestringOpcional

El cuerpo de la solicitud siempre se analiza como JSON; si se envía, solo se acepta application/json (charset opcional) — cualquier otro valor devuelve 415. Ejemplo: application/json.

Idempotency-KeystringOpcional

Clave de idempotencia, hasta 255 bytes. Los reintentos con la misma clave de la misma cuenta crean la tarea una sola vez; las repeticiones devuelven el taskId original.

Clave de idempotencia

Ante timeouts de red o reintentos automáticos del cliente, la misma clave crea la tarea una sola vez, sin doble cobro (alcance = la cuenta de la clave API). Usa un identificador de negocio único (p. ej. "order-42"); las repeticiones devuelven el taskId original y las claves caducan 24 h después de la primera solicitud. La matriz completa de escenarios está en la introducción de la API asíncrona unificada.

Cuerpo

modelstringObligatorio

Valor fijo actual: pixverse-v6/image-to-video

routestringOpcional

Valor fijo actual: default

inputobjectObligatorio

Objeto de parámetros de negocio para pixverse-v6/image-to-video y la ruta default; consulta la tabla de parámetros a continuación.

seedintegerOpcional

Semilla aleatoria para reproducir el resultado de la generación; la misma semilla y el mismo prompt producen la misma salida.

stylestringOpcional

Cadena opcional de preajuste de estilo visual; si se omite, se usa el estilo natural del modelo.

Opciones:anime3d_animationclaycomiccyberpunk

promptstringObligatoriominLength 1maxLength 2048

Describe el movimiento y la atmósfera que se deben añadir a la imagen, con un máximo de 2048 bytes UTF-8 (cada carácter chino ocupa 3 bytes).

durationintegerOpcionalPredeterminado: 5min 1max 15

Duración del vídeo en segundos, con un rango de 1 a 15, por defecto 5.

image_urlstringObligatorio

URL de imagen de acceso público que se usa como primer fotograma; el vídeo de salida conservará la relación de aspecto de esa imagen.

resolutionstringOpcionalPredeterminado: "720p"

Resolución del vídeo de salida, por defecto 720p.

Opciones:360p540p720p1080p

generate_audiobooleanOpcionalPredeterminado: false

Indica si se genera música de fondo, efectos de sonido y diálogos junto con el vídeo; por defecto es false.

negative_promptstringOpcional

Especifica el contenido que se debe evitar en el vídeo, con un máximo de 2048 bytes UTF-8 (cada carácter chino ocupa 3 bytes).

callbackobjectOpcional

Configuración de notificación de estado terminal. Si se omite, no hay callback: consulta la tarea por tu cuenta.

Callbacks (Webhook)

Indica callback.url al crear y HiAPI hará POST a tu servicio en el estado terminal, sin necesidad de sondeo. El cuerpo del callback replica la estructura del detalle de la tarea; firma, reintentos e idempotencia se detallan en la introducción de la API asíncrona unificada.

urlstringObligatorio

Obligatorio si se incluye callback. Al estado terminal se envía un POST a esta URL; debe ser una URL http(s) válida.

whenstringOpcionalPredeterminado: "final"

Actualmente solo se admite final: notifica tanto en success como en fail.

Opciones:final

storagestringOpcionalPredeterminado: "temp"

Nivel de almacenamiento de artefactos: temp (por defecto, ~7 días) o persistent (largo plazo, facturado por tamaño). Saldo insuficiente o exceso de límite ⇒ degradación silenciosa a temp; el nivel efectivo se muestra en la respuesta del detalle.

Opciones:temppersistent

Ejemplos de solicitud

# Envía una tarea asíncrona; devuelve un taskId de inmediato (sin esperar la generación)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "pixverse-v6/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 5,
    "image_url": "…",
    "resolution": "720p",
    "generate_audio": false
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "pixverse-v6/image-to-video",
    input: {
      "prompt": "…",
      "duration": 5,
      "image_url": "…",
      "resolution": "720p",
      "generate_audio": false
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "pixverse-v6/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 5,
          "image_url": "…",
          "resolution": "720p",
          "generate_audio": False
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtener el detalle de la tarea

GET https://api.hiapi.ai/v1/tasks/:id

Campos de respuesta

taskIdstringObligatorio

ID de tarea, siempre con prefijo tk-hiapi-.

modelstringObligatorio

Nombre completo resuelto del modelo. Las tareas enviadas con el parámetro route devuelven base@route (p. ej. gpt-image-2/text-to-image@ext); si no, coincide con el nombre enviado.

routestringOpcional

Solo aparece si se usó el parámetro route explícito; repite el valor enviado.

statusstringObligatorio

Estado de la tarea.

Valores de estado

queued En cola, sin iniciar. handling Procesando. archiving Proceso terminado, preparando artefactos. success Terminal: completado, artefactos disponibles (se devuelve output). fail Terminal: error (se devuelve error). Tras el envío, guíate por status: success y fail son terminales; el resto, no. Sondea cada 1–3 s hasta el estado terminal. Con éxito, descarga los artefactos desde output[].url y transfiérelos antes de expireAt; para retención larga usa storage: "persistent" al crear.

creatednumberObligatorio

Hora de creación de la tarea (segundos Unix).

completednumberObligatorio

Segundos Unix al alcanzar estado terminal; 0 mientras no sea terminal.

outputarrayOpcional

Solo con status == success. Lista de artefactos — siempre un array; una tarea puede devolver varios types a la vez (p. ej. video + first_frame).

Array [ object ]

Elementos del array

urlstringObligatorio

URL del artefacto, descargable directamente.

typestringObligatorio

Valores posibles actuales: video, image, audio, first_frame, last_frame, thumbnail; podrían ampliarse más adelante.

expireAtnumberObligatorio

Segundos Unix hasta los que el artefacto es accesible; descárgalo o transfiérelo antes.

errorobjectOpcional

Solo con status == fail.

codestringObligatorio

Código de error de negocio.

messagestringObligatorio

Descripción del error.

Ejemplos de respuesta

Éxito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En proceso (no terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fallido

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}