Saltar al contenido principal
POST
/
v3
/
async
/
vidu-q2-pro-fast-startend2video
VIDU Q2 Pro Fast: fotogramas inicial y final
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-pro-fast-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 de fotogramas inicial y final (modo rápido). Admite dos resoluciones: 720p y 1080p. El modo rápido puede reducir significativamente el tiempo de generación y es adecuado para escenarios con altos requisitos de velocidad.
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 del resultado de la tarea y recuperar el resultado generado.

​
Encabezados de la solicitud

​
Content-Type
string
requerido
Valores enumerados: 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 preestablecida y la añadirá; false: no se añadirá 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. Si no se envía de forma predeterminada o se envía 0, se usará un número aleatorio en su lugar; si se configura manualmente, se usará la semilla establecida.
​
images
array
requerido
Array 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 utilizando las imágenes proporcionadas en este parámetro. Admite la entrada de dos imágenes. Nota 1: las resoluciones de las dos imágenes de entrada de fotograma inicial y final deben ser similares; la resolución del fotograma inicial / la resolución del fotograma 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 sean accesibles). Nota 3: las imágenes admiten 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 array: 2 - 2
​
is_rec
boolean
predeterminado:false
Indica si se deben usar prompts recomendados. true: sí, el sistema recomendará automáticamente prompts y usará su contenido para generar el video (cada tarea consume 10 créditos adicionales); false: no, el video se generará según el prompt de entrada
​
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 is_rec de prompts recomendados, el modelo no tendrá en cuenta el prompt introducido en este parámetroLí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 usará la marca de agua predeterminada: contenido generado por AI
​
payload
string
Parámetro de paso directo; no se realiza ningún procesamiento, solo transmisión de datos. Máximo 1048576 caracteres.Límite de longitud: 0 - 1048576
​
duration
integer
predeterminado:5
Duración del video (segundos), admite 1-8 segundosValores opcionales: 1, 2, 3, 4, 5, 6, 7, 8
​
off_peak
boolean
predeterminado:false
Modo fuera de horas punta. true: genera el video fuera de horas punta (consume menos créditos, se genera dentro de 48 horas); false: genera el video de inmediato. Nota: en el modo fuera de horas punta, las tareas enviadas 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 horas punta.
​
meta_data
string
Identificador de metadatos, cadena en formato json, campo de paso directo. 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. De forma predeterminada no se añade marca de agua. Puede consultar y 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. Admite 720p y 1080p. El valor predeterminado es 720p.Valores opcionales: 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 izquierdaValores opcionales: 1, 2, 3, 4
​
movement_amplitude
string
predeterminado:"auto"
Amplitud de movimiento, controla la intensidad del movimiento de los objetos en el videoValores opcionales: auto, small, medium, large

​
Información de respuesta

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