Wan2.5
Generación de Video wan2.5-preview
- Modelo preview de generación de video Wanxiang 2.5
- Soporta Text-to-Video e Image-to-Video
- Soporta resolución 480p/720p/1080p, duración de 5 o 10 segundos
- Soporta extensión automática del prompt, audio automático y audio personalizado
POST
Autenticación
string
requerido
Todos los endpoints requieren autenticación mediante Bearer TokenObtener API Key:Visite la página de gestión de API Keys para obtener su API KeyAñadir al encabezado de la solicitud:
Parámetros de la solicitud
string
requerido
Nombre del modelo de generación de video, fijado como
wan2.5-previewboolean
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 conomni-moderation-latestfalseu omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
Descripción del contenido del videoObligatorio para text-to-video (sin
image_urls), opcional pero recomendado para image-to-videoDescriba escenas, acciones y estilos en detalle para obtener mejores resultadosEjemplo: "Sunset coastal highway, cinematic shot"array<string>
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úblicamente o codificación Base64 (
data:image/png;base64,...)Ejemplo: ["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. No envíe image_urls para el modo text-to-video.string
Prompt negativo, describe contenido no deseadoMáximo 500 caracteresEjemplo:
"blurry, low quality, distorted"string
predeterminado:"720p"
Resolución del videoOpciones:
480p- SD, admite size:16:9,9:16,1:1720p- HD (por defecto), admite size:16:9,9:16,1:1,4:3,3:41080p- FHD, admite size:16:9,9:16,1:1,4:3,3:4
720pLa resolución afecta directamente al precio: 1080p > 720p > 480p.
integer
predeterminado:"5"
Duración del video (segundos)Solo admite:
5 o 10 segundosPor defecto: 5string
predeterminado:"16:9"
Proporción de aspecto, solo efectiva para text-to-video (sin
image_urls)Las opciones dependen de resolution:480p:16:9- Paisaje (por defecto)9:16- Retrato1:1- Cuadrado
16:9- Paisaje (por defecto)9:16- Retrato1:1- Cuadrado4:3- Paisaje3:4- Retrato
16:9integer
Semilla aleatoria (≥0), especificar la misma semilla puede reproducir resultados similaresEjemplo:
12345boolean
predeterminado:"true"
Si se debe activar la reescritura inteligente del promptMejora significativamente los resultados para prompts cortos, pero aumenta el tiempo de procesamientoPor defecto:
trueboolean
predeterminado:"true"
Si se debe añadir audio automáticamenteCuando está activado, el sistema generará audio que coincida con el videoPor defecto:
truestring
URL de audio personalizado (wav/mp3, 3-30 segundos, ≤ 15MB)Si el audio es más largo que la duración del video, será recortado automáticamente; si es más corto, la parte restante quedará en silencio
boolean
predeterminado:"false"
Si se debe añadir una marca de agua “AI Generated” (esquina inferior derecha)Por defecto:
falseCombinaciones de resolución y proporción de aspecto
Las combinaciones desize y resolution se asignan a dimensiones de píxeles upstream (solo efectivas para text-to-video):
480p solo admite las proporciones
16:9, 9:16, 1:1. Pasar 4:3 o 3:4 provocará un error. 720p y 1080p admiten las 5 proporciones.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 (simple)
Caso 2: Texto a video (parámetros completos)
Caso 3: Imagen a video
Caso 4: Imagen a video (imagen Base64)
Caso 5: Audio personalizado
Descripción de modos
Texto a video (Text-to-Video)
- El parámetro
promptes obligatorio - No envíe
image_urls - Use
sizepara especificar la proporción de aspecto
Imagen a video (Image-to-Video)
- El parámetro
image_urlses obligatorio (solo se admite 1 imagen) promptes opcional, se usa para describir las acciones esperadas- La proporción de aspecto la determina la imagen de entrada, no envíe
size
El sistema selecciona automáticamente el modo según si se incluye
image_urlsConsultar 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.