APIMaster.ai

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.