Saltar al contenido principal
POST
/
v3
/
async
/
vidu-q2-pro-startend2video
VIDU Q2 Pro fotogramas inicial y final
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-startend2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "seed": 123,
  "images": [
    {}
  ],
  "is_rec": true,
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "duration": 123,
  "off_peak": true,
  "meta_data": "<string>",
  "watermark": true,
  "resolution": "<string>",
  "wm_position": 123,
  "movement_amplitude": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
Genera un video coherente a partir de dos imágenes correspondientes al fotograma inicial y final. Admite tres resoluciones: 540p, 720p y 1080p.
Esta es una API asíncrona y solo devolverá el task_id de la tarea asíncrona. Debe usar ese task_id para solicitar la API de consulta de resultado de tarea y recuperar el resultado generado.

​
Encabezados de solicitud

​
Content-Type
string
requerido
Valor enumerado: application/json
​
Authorization
string
requerido
Formato de autenticación Bearer: Bearer {{API Key}}.

​
Cuerpo de la solicitud

​
bgm
boolean
predeterminado:false
Indica si se debe añadir música de fondo al video generado. true: el sistema seleccionará automáticamente música adecuada de la biblioteca BGM predefinida y la añadirá; false: no se añade BGM. La BGM no tiene límite de duración; el sistema la adapta automáticamente según la duración del video.
​
seed
integer
Semilla aleatoria. Cuando no se proporciona por defecto o se pasa 0, se usará un número aleatorio en su lugar; si se establece manualmente, se usará la semilla configurada.
​
images
array
requerido
Arreglo de imágenes: la primera imagen se considera el fotograma inicial y la segunda imagen se considera el fotograma final. El modelo generará el video usando las imágenes pasadas en este parámetro. Admite la entrada de dos imágenes. Nota 1: las resoluciones de las dos imágenes de fotograma inicial y final deben ser similares; la resolución de la imagen inicial / la resolución de la imagen final debe estar entre 0.8 y 1.25. Nota 2: admite imágenes codificadas en Base64 o URL de imagen (asegúrese de que sea accesible). Nota 3: las imágenes admiten los formatos png, jpeg, jpg y webp. Nota 4: el tamaño de la imagen no debe superar los 50M. Nota 5: la codificación Base64 debe incluir la cadena de tipo de contenido adecuada, por ejemplo: data:image/png;base64,Longitud del arreglo: 2 - 2
​
is_rec
boolean
predeterminado:false
Indica si se deben usar prompts recomendados. true: sí, el sistema recomienda automáticamente el prompt y usa el contenido del prompt para generar el video (cada tarea consume 10 créditos adicionales); false: no, se genera el video según el prompt ingresado.
​
prompt
string
Prompt de texto, descripción textual para generar el video. Nota 1: la longitud no puede superar los 2000 caracteres. Nota 2: si se usa el parámetro de prompt recomendado is_rec, el modelo no tendrá en cuenta el prompt ingresado en este parámetro.Límite de longitud: 0 - 2000
​
wm_url
string
Contenido de la marca de agua; aquí es una URL de imagen. Si no se proporciona, se usa la marca de agua predeterminada: contenido generado por IA.
​
payload
string
Parámetro de transmisión directa; no se procesa de ninguna forma, solo se transmite como datos. Máximo 1048576 caracteres.Límite de longitud: 0 - 1048576
​
duration
integer
predeterminado:5
Duración del video (segundos), admite de 1 a 8 segundos.Valores opcionales: 1, 2, 3, 4, 5, 6, 7, 8
​
off_peak
boolean
predeterminado:false
Modo fuera de hora punta. true: genera el video fuera de hora punta (consume menos créditos, se genera dentro de 48 horas); false: genera el video de forma inmediata. Nota: las tareas enviadas en modo fuera de hora punta que no se completen se cancelarán automáticamente y se reembolsarán los créditos; también puede cancelar manualmente las tareas fuera de hora punta.
​
meta_data
string
Identificador de metadatos, cadena en formato JSON, campo de transmisión directa. Puede personalizar el formato o usar el formato de ejemplo. Cuando este parámetro está vacío, se usa de forma predeterminada el identificador de metadatos generado por vidu.
​
watermark
boolean
predeterminado:false
Indica si se debe añadir una marca de agua. Por defecto no se añade marca de agua. Puede obtener el contenido del video con marca de agua mediante el parámetro watermarked_url.
​
resolution
string
predeterminado:"720p"
Resolución del video de salida. El valor predeterminado es 720p.Valores opcionales: 540p, 720p, 1080p
​
wm_position
integer
predeterminado:3
Posición de la marca de agua, indica dónde aparece la marca de agua en la imagen. 1: esquina superior izquierda; 2: esquina superior derecha; 3: esquina inferior derecha (predeterminado); 4: esquina inferior izquierda.Valores opcionales: 1, 2, 3, 4
​
movement_amplitude
string
predeterminado:"auto"
Amplitud de movimiento, controla la intensidad del movimiento de los objetos en el video.Valores opcionales: auto, small, medium, large

​
Información de respuesta

​
task_id
string
requerido
Use task_id para solicitar la API de consulta de resultado de tarea y recuperar la salida generada.
​
provider_request_id
string
ID de solicitud del proveedor (opcional)