Saltar al contenido principal
POST
/
v3
/
async
/
vidu-q2-turbo-startend2video
VIDU Q2 Turbo fotogramas inicial y final
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/vidu-q2-turbo-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 rápidamente un video coherente a partir de dos imágenes como fotogramas inicial y final. Admite tres resoluciones: 540p, 720p y 1080p. La versión Turbo logra un equilibrio entre velocidad de generación y calidad de video.
Esta es una API asíncrona que solo devuelve 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
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 agregar música de fondo al video generado. true: el sistema seleccionará automáticamente música adecuada de una biblioteca de BGM predefinida y la agregará; false: no se agregará 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 de forma predeterminada o se proporciona 0, se sustituirá por un número aleatorio; si se establece manualmente, se usará la semilla configurada.
​
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 a partir de las imágenes proporcionadas en este parámetro. Se 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: se admite proporcionar imágenes codificadas en Base64 o URL de imagen (asegúrese de que sean accesibles). 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 array: 2 - 2
​
is_rec
boolean
predeterminado:false
Indica si se deben usar prompts recomendados. true: sí, el sistema recomendará automáticamente un prompt y usará su contenido para generar el video (cada tarea consume 10 créditos adicionales); false: no, se generará el video 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 de prompt recomendado is_rec, el modelo no tendrá en cuenta el prompt introducido 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 usará la marca de agua predeterminada: contenido generado por AI.
​
payload
string
Parámetro de paso directo; no se procesa de ninguna manera, 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 horas punta. true: genera el video fuera de horas punta (consume menos créditos y se genera dentro de 48 horas); false: genera el video de inmediato. Nota: las tareas enviadas en modo fuera de horas punta que no logren completarse 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 agregar una marca de agua. De forma predeterminada no se agrega 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)