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:

Enrutamiento de modos

wan2.7 es una entrada unificada para text-to-video e image-to-video. El backend determina automáticamente el modo según los parámetros entrantes. Ambos modos se facturan de forma idéntica:

Parámetros de la solicitud

string
requerido
Nombre del modelo de generación de video, fijado como wan2.7
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
Descripción del contenido del video, hasta 5000 caracteres
  • Modo Text-to-Video (cuando no se proporciona imagen/video): obligatorio
  • Modo Image-to-Video: opcional, pero recomendado para guiar el movimiento de cámara y las acciones
Ejemplo: "A cat chasing butterflies on the grass, bright sunshine, slow motion"
array<string>
Array de URLs de imágenes. Proporcionarlo entra automáticamente en modo Image-to-Video
  • 1 imagen: primer fotograma del video
  • 2 imágenes: primer y último fotograma del video (1ª = primer fotograma, 2ª = último fotograma)
Use este o image_with_roles
image_urls entra en conflicto con audio_url; no pueden proporcionarse al mismo tiempo
array<object>
Array de imágenes con roles, alternativa a image_urls, usado para especificar con precisión el rol de cada imagenCampos de cada objeto:
  • url (string): URL de la imagen (admite http/https)
  • role (string): rol de la imagen, first_frame / last_frame, por defecto first_frame
Ejemplo:
image_with_roles entra en conflicto con audio_url; no pueden proporcionarse al mismo tiempo
array<string>
Array de URLs de videos. Proporcionarlo entra en el modo de continuación de video (solo se usa el 1er video)
video_urls entra en conflicto con audio_url; no pueden proporcionarse al mismo tiempo
Restricciones del video:
  • Formato: mp4, mov
  • Duración: 2–10s
  • 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 el contenido no deseado, hasta 500 caracteresEjemplo: "blurry, distorted, low quality"
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
string
predeterminado:"16:9"
Proporción de aspecto, solo efectiva en modo Text-to-Video (cuando no se proporciona imagen/video)Formatos soportados:
  • 16:9 - Paisaje panorámico (por defecto)
  • 9:16 - Retrato
  • 1:1 - Cuadrado
  • 4:3 - Paisaje
  • 3:4 - Retrato
Este parámetro se ignora en el modo Image-to-Video; la proporción de aspecto la determina automáticamente la imagen de entrada
string
URL de audio personalizado
  • Modo Text-to-Video: usado como música de fondo
  • Modo Image-to-Video: usado como audio conductor, sincronizado con las acciones en pantalla
Formato: wav / mp3, duración 2-30 segundos, tamaño del archivo ≤ 15MB
audio_url entra en conflicto con video_urls, image_urls e image_with_roles; no pueden proporcionarse al mismo tiempo
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: Texto a video (Solicitud más simple)

Caso 2: Texto a video (Parámetros completos)

Caso 3: Primer fotograma a video

Caso 4: Primer y último fotograma a video

Con 2 imágenes: la 1ª es el primer fotograma, la 2ª es el último fotograma. También puede usar image_with_roles para una especificación precisa.

Caso 5: Continuación de video

Caso 6: Imagen + audio conductor

Guía de selección de modo

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.