PixVerse V6.0 / C1 · Referencia de la API
Generar vídeos PixVerse a partir de texto, imágenes, marcos de inicio y fin, o referencias.
Utilice pixverse-video-v6.0 o pixverse-video-c1 como el ID del modelo. Enviar JSON con una clave de API APIMaster en la cabecera Authorization: Bearer.
| Operación | Endpoint |
|---|---|
| Text-to-video | POST /v1/wand/pixverse/text-to-video |
| Image-to-video | POST /v1/wand/pixverse/image-to-video |
| Marcos de inicio/final | POST /v1/wand/pixverse/start-end-to-video |
| Reference-to-video | POST /v1/wand/pixverse/reference-to-video |
| Estado de las tareas | GET /v1/wand/pixverse/tasks/{task_id} |
| Campo | Tipo | Descripción |
|---|---|---|
model |
string | Obligatorio. Utilice uno de los ID de modelo anteriores. |
prompt |
string | Requerido, hasta 5,000 caracteres. Los avisos de referencia pueden usar @ref_name. |
duration |
integer | 1–15 segundos, incluyendo 1080p. El valor predeterminado es 5 segundos. |
quality |
string | Obligatorio. 360p, 540p, 720p, o 1080p. |
aspect_ratio |
string | Text-to-video y reference-to-video únicamente. 16:9 (predeterminado), 4:3, 1:1, 3:4, 9:16, 2:3, 3:2, o 21:9. Otras rutas siguen la imagen de entrada. |
seed |
integer | De 0 a 2,147,483,647. Omite el campo o usa 0 para elegir una semilla aleatoria. |
generate_audio_switch |
boolean | Establecer true para el audio. Valor predeterminado: false. |
camera_movement |
string | Movimiento opcional como zoom_in, para text-to-video y image-to-video. |
generate_multi_clip_switch |
boolean | Opcional para V6.0 text-to-video y image-to-video. Valor predeterminado: false. |
img_id |
string | Requerido para image-to-video. Imagen pública URL o Base64. |
img_ids |
string[] | Reservado para una plantilla de múltiples imágenes image-to-video. Una solicitud image-to-video estándar utiliza img_id. |
first_frame_img, last_frame_img |
string | Requerido para solicitudes de inicio/final de marco. Utilice URLs público o Base64. Utilice las relaciones de aspecto correspondientes. |
image_references |
object[] | Requerido para reference-to-video. Hasta siete elementos con img_id, opcional type (subject o background), y ref_name de hasta 30 caracteres. |
curl -X POST "https://apimaster.ai/v1/wand/pixverse/text-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"pixverse-video-v6.0","prompt":"A slow pan across a mountain lake","duration":5,"quality":"720p"}'
Requerir ErrCode=0, así como un estado HTTP exitoso. La respuesta contiene ErrMsg, Resp.video_id y request_id. Vota cada segundo de 3–5 con la misma cuenta. Resp.status es 1 para el éxito, 5 para el procesamiento, 6 para el borrado, 7 para el fallo de revisión de contenido, y 8 para el fallo de generación. Resp.url es la descarga temporal final URL y dura hasta 12 horas. La respuesta también puede incluir dimensiones, tamaño, semilla, estilo y marcas de tiempo.
Consultar el estado no vuelve a generar el resultado ni genera otro cargo. Utilice un Idempotency-Key de 8–128 visible ASCII caracteres para recuperar una presentación. La misma clave con los mismos parámetros devuelve un recibo de recuperación con HTTP 202. La misma clave con otros parámetros devuelve HTTP 409. Véase Guía para recuperar una solicitud. La API no acepta un parámetro negativo prompt o callback_url.
tokenhub_usage.total_tokens informa de uso facturable. La resolución y la configuración de audio afectan el precio. Ver la PixVerse V6.0 y PixVerse C1 modelo de tarjetas para corriente APIMaster precios.
