Skip to main content
POST

Autorización

string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala al encabezado de la solicitud:

Parámetros de la solicitud

string
requerido
Nombre del modelo de generación de videoModelos compatibles:
  • viduq3-mix - Calidad premium, transiciones inteligentes más potentes, admite videos cortos de 1 segundo
  • viduq3 - Opción predeterminada, cambio de cámara más inteligente
Cómo elegir: Use viduq3 para uso diario; use viduq3-mix para calidad premium o efectos de movimiento de 1-2 segundos.
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
requerido
Prompt de texto, máximo 5000 caracteresDescriba acciones y movimientos de cámara, no la apariencia (la apariencia está determinada por las imágenes de referencia).Ejemplo: "Santa Claus and the bear hug by the lakeside"
array<url>
requerido
Array de URLs de imágenes de referencia, 1-7 imágenesAdmite URLs de imágenes de acceso público (http:// o https://)Ejemplo: ["https://example.com/santa.png", "https://example.com/bear.png"]
  • Cantidad: 1-7 imágenes
  • Formatos compatibles: PNG, JPEG, JPG, WebP
  • Tamaño mínimo: 128×128
  • Relación de aspecto: entre 1:4 y 4:1
  • Tamaño máximo de archivo: ≤ 50MB por imagen
  • Deben ser URLs de acceso público
integer
predeterminado:"5"
Duración del video (segundos)
  • viduq3-mix: 1 a 16
  • viduq3: 3 a 16
Predeterminado: 5
viduq3 admite un mínimo de 3 segundos, viduq3-mix admite un mínimo de 1 segundo. Pase una duración válida según el modelo seleccionado.
string
predeterminado:"720p"
Resolución del video
  • viduq3-mix: 720p (predeterminado) / 1080p
  • viduq3: 540p / 720p (predeterminado) / 1080p
viduq3-mix no admite 540p, use 720p o 1080p.
string
predeterminado:"16:9"
Relación de aspecto del videoOpciones:
  • 16:9 - Horizontal (predeterminado)
  • 9:16 - Vertical
  • 4:3 - Tradicional
  • 3:4 - Vertical tradicional
  • 1:1 - Cuadrado
integer
Semilla aleatoria para controlar la aleatoriedad de la generaciónSi no se proporciona, se usará una semilla aleatoria.
Usar la misma semilla con parámetros idénticos producirá resultados similares, pero no se garantiza que sean exactamente iguales.

Comparación de modelos

Respuesta

integer
Código de estado de la respuesta, 200 en caso de éxito
array
Array de datos de la respuesta

Casos de uso

Caso 1: Reference-to-Video básico con viduq3

Caso 2: Reference-to-Video de alta calidad con viduq3-mix

Consultar los resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un task_id al enviarse. Use el endpoint Obtener estado de la tarea para consultar el progreso y los resultados de la generación.