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 video, fijado como wan2.7-r2v
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
Descripción del contenido del video, hasta 5000 caracteresPara múltiples imágenes/videos, use “image 1”, “image 2”, “video 1”, etc. para referenciar los activos de referencia correspondientes (en el orden de entrada)Ejemplo: "The character in image 1 enters the scene in image 2 and looks around"
array<object>
Array de imágenes con roles; debe proporcionarse al menos uno entre este y video_urlsCampos de cada objeto:
  • url (string): URL de la imagen
  • role (string): rol de la imagen
    • reference_image - imagen de referencia (por defecto)
    • first_frame - primer fotograma especificado (cuando se proporciona, size se ignora y la proporción de aspecto sigue la de la imagen del primer fotograma)
  • reference_voice (string, opcional): URL de la muestra de audio de voz para ese personaje de referencia, usado para controlar la voz del personaje en el video generado
Ejemplo:
array<string>
Array de URLs de videos de referencia, hasta 5 videos (total imágenes + videos ≤ 5)Debe proporcionarse al menos uno entre este e image_with_roles
Restricciones del video:
  • Formato: mp4, mov
  • Duración: 1–30s
  • Resolución: ancho y alto en el rango [240, 4096] píxeles
  • Proporción de aspecto: 1:8 – 8:1
  • Tamaño del archivo: hasta 100MB
string
Prompt negativo que describe contenido no deseado, hasta 500 caracteres
string
predeterminado:"1080P"
Resolución del videoOpciones:
  • 720P - Estándar
  • 1080P - Alta definición (por defecto)
integer
predeterminado:"5"
Duración del video (segundos)Rango soportado: 2 ~ 15 segundosPor defecto: 5
Cuando los activos de referencia incluyen un video: un entero entre [2, 10].Cuando los activos de referencia no incluyen un video: un entero entre [2, 15].
string
predeterminado:"16:9"
Proporción de aspectoFormatos soportados:
  • 16:9 - Paisaje panorámico (por defecto)
  • 9:16 - Retrato
  • 1:1 - Cuadrado
  • 4:3 - Paisaje
  • 3:4 - Retrato
Cuando se proporciona first_frame mediante image_with_roles, este parámetro se ignora y la proporción de aspecto sigue la de la imagen del primer fotograma
boolean
predeterminado:"true"
Si se debe activar la reescritura inteligente del promptMejora significativamente los resultados para prompts cortos, pero aumenta el tiempo de procesamientoPor defecto: true
boolean
predeterminado:"false"
Si se debe añadir la marca de agua “AI Generated” al video generado
  • true: añadir marca de agua
  • false: sin marca de agua (por defecto)
integer
Entero de seed usado para controlar la aleatoriedad del contenido generadoRango de valores: entero ≥0
  • Para solicitudes idénticas, el modelo genera resultados diferentes al recibir valores de seed diferentes (por ejemplo, al omitir el seed)
  • Para solicitudes idénticas, el modelo genera resultados similares al recibir el mismo valor de seed, pero no se garantiza consistencia exacta

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: Imagen de referencia única (más simple)

Caso 2: Múltiples imágenes de referencia

Caso 3: Generación basada en video de referencia

Caso 4: Primer fotograma especificado + imagen de referencia

Caso 5: Imagen de referencia + voz de referencia (preciso)

Reglas de referencia de imágenes

Con múltiples imágenes de referencia, use índices numéricos en el prompt para referirse a ellas:
  • 1ª imagen → “image 1” o “the first image”
  • 1er video → “video 1” o “the first video”
Consultar 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.