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-videoedit
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)
array<string>
requerido
Array de URLs del video fuente para editar
Solo se usa el 1er video
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
Instrucción de edición que describe los cambios deseados, hasta 5000 caracteres
Si se omite, el modelo realiza una transferencia de estilo por defecto
Ejemplo: "Change the character's outfit to a red gown", "Replace the background with a snowy mountain scene"
string
Prompt negativo que describe contenido no deseado, hasta 500 caracteres
array<string>
Array de URLs de imágenes de referencia, hasta 4 imágenesUsado para especificar el estilo o apariencia deseados (por ejemplo, estilo de referencia para transferencia de estilo)
string
predeterminado:"1080P"
Resolución del video de salidaOpciones:
  • 720P - Estándar
  • 1080P - Alta definición (por defecto)
integer
predeterminado:"0"
Duración del video de salida (segundos)
  • 0 (por defecto): mantiene la duración completa del video original
  • Entero entre 2-10: toma la duración especificada desde el inicio
Cuando duration=0, la facturación se basa en la duración real del video de salidaLa duración especificada no puede superar la duración del video original en video_urls
string
Proporción de aspecto de salidaFormatos soportados:
  • 16:9 - Paisaje panorámico
  • 9:16 - Retrato
  • 1:1 - Cuadrado
  • 4:3 - Paisaje
  • 3:4 - Retrato
Si se omite, la proporción de aspecto coincide con la del video de entrada
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
object
Objeto de parámetros adicionales

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: Edición básica de video (más simple)

Caso 2: Transferencia de estilo (con imagen de referencia)

Caso 3: Mantener el audio original del video

Adecuado para videos con sonido de fondo o diálogos importantes:

Caso 4: Parámetros completos

Gestión de audio

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.