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.6
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 videoRequerido para el modo text-to-video. Describa escenas, acciones y estilos en detalle para obtener mejores resultadosEjemplo: "A cute cat stretching in the sunlight"
array<url>
Array de URLs de imágenes de referencia (solo se admite 1 imagen)Requerido para el modo image-to-video. Admite URLs de imágenes accesibles públicamenteEjemplo: ["https://example.com/image.jpg"]
El sistema selecciona automáticamente el modo text-to-video o image-to-video según si se incluye image_urls
string
Prompt negativo que describe contenido no deseadoEjemplo: "blurry, low quality, distorted"
string
predeterminado:"16:9"
Proporción de aspecto del videoOpciones:
  • 16:9 - Paisaje (por defecto)
  • 9:16 - Retrato
  • 1:1 - Cuadrado
  • 4:3 - Paisaje
  • 3:4 - Retrato
Por defecto: 16:9
No soportado en el modo image-to-video
string
predeterminado:"720p"
Resolución del videoOpciones:
  • 720p - Estándar (por defecto)
  • 1080p - Alta definición
Por defecto: 720p
La resolución 480p no es soportada
Facturado por segundo. El precio varía según la resolución. Consulte el marketplace de modelos para conocer los precios específicos
integer
predeterminado:"5"
Duración del video (segundos)Valores soportados: 5, 10, 15 segundos únicamentePor defecto: 5
integer
Semilla aleatoria para resultados reproduciblesEjemplo: 12345
boolean
Si se debe extender automáticamente el promptCuando está activado, el sistema optimizará y enriquecerá automáticamente su prompt
boolean
Si se debe añadir audio automáticamenteCuando está activado, el sistema generará audio que coincida con el video
string
URL de audio especificadaTiene prioridad sobre el parámetro audio
La duración del audio no puede superar la duración del video. Si el audio es más corto que la duración del video, la primera parte del video tendrá sonido mientras que el resto será silencioso.
string
Tipo de tomaOpciones:
  • single - Toma única
  • multi - Múltiples tomas
boolean
Si se debe añadir una marca de agua
string
Nombre de la plantilla de efecto para el modo de efectos especiales image-to-video
Al usar el modo de efectos:
  • Solo se requiere una imagen (pasada mediante image_urls)
  • No se necesita prompt (el modelo ignora el campo prompt)
Efectos generales:
  • squish - Squish & Squeeze
  • rotation - Rotación
  • poke - Pinchar
  • inflate - Inflado de globo
  • dissolve - Disolución molecular
  • melt - Derretimiento por ola de calor
  • icecream - Planeta helado
  • flying - Levitación mágica
Efectos para una sola persona:
  • carousel - Carrusel del tiempo
  • singleheart - Te amo
  • dance1 - Momento swing
  • dance2 - Movimiento de baile
Para más efectos, consulte la Documentación de plantillas de Alibaba Wanxiang

Combinaciones de resolución y proporción de aspecto

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 simple)

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

Caso 3: Imagen a video

Caso 4: Imagen a video (Imagen Base64)

Descripción de modos

Texto a video (Text-to-Video)

  • El parámetro prompt es obligatorio
  • El parámetro image_urls no es necesario

Imagen a video (Image-to-Video)

  • El parámetro image_urls es obligatorio (solo se admite 1 imagen)
  • El parámetro prompt es opcional, se usa para describir las acciones esperadas
El sistema selecciona automáticamente el modo según si se incluye image_urls en la solicitud
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.