> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Wan3.0 Guía completa de parámetros > API unificada de Wan 3.0 (video de referencia todo en uno), el modo se elige con el parámetro `model` **3 modos de generación:** - **Text-to-Video** (`wan3.0-text-to-video`): genera el video solo a partir del prompt de texto - **Image-to-Video** (`wan3.0-image-to-video`): el primer fotograma / los fotogramas inicial y final controlan estrictamente el inicio y el final de la imagen - **Reference-to-Video** (`wan3.0-reference-video`): referencias multimodales mixtas — imágenes de referencia + videos de referencia + audio de referencia + archivos / páginas web **Capacidades comunes:** - Videos de hasta **30 segundos** - Modo de procesamiento asíncrono, use el ID de tarea devuelto para [consultar el estado](/es/api-manual/task-management/get-task-detail) - Los enlaces de video generados son válidos durante 24 horas, guárdelos cuanto antes ## Facturación - **Fórmula de facturación**: duración facturada = duración del video de entrada + duración del video de salida, facturación por segundo - **Multiplicador de resolución**: `480p` = 1x (base), `720p` = 2x, `1080p` = 4x - Las imágenes de referencia, el audio de referencia, los archivos de referencia y los enlaces de páginas web **no se facturan** - Cuando `duration` es `-1` (duración inteligente) se preautoriza el máximo de `30` segundos; tras completarse la tarea se liquida según la duración realmente producida y la diferencia se reembolsa automáticamente - Activar o desactivar la pista `audio` **cuesta lo mismo** - **Las tareas fallidas no se facturan**, los créditos congelados se reembolsan íntegramente ## OpenAPI ````yaml es/api-manual/video-series/wan3.0/wan3.0-overview.json POST /v1/videos/generations openapi: 3.1.0 info: title: Wan3.0 API de todos los modelos description: >- Wan 3.0 generación de video de referencia todo en uno, una sola API que cubre texto a video, imagen a video y referencia a video license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Entorno de producción security: - bearerAuth: [] tags: - name: Generación de video description: APIs de generación de video con IA paths: /v1/videos/generations: post: tags: - Generación de video summary: Wan3.0 API de todos los modelos description: >- API unificada de Wan 3.0 (video de referencia todo en uno), el modo se elige con el parámetro `model` **3 modos de generación:** - **Text-to-Video** (`wan3.0-text-to-video`): genera el video solo a partir del prompt de texto - **Image-to-Video** (`wan3.0-image-to-video`): el primer fotograma / los fotogramas inicial y final controlan estrictamente el inicio y el final de la imagen - **Reference-to-Video** (`wan3.0-reference-video`): referencias multimodales mixtas — imágenes de referencia + videos de referencia + audio de referencia + archivos / páginas web **Capacidades comunes:** - Videos de hasta **30 segundos** - Modo de procesamiento asíncrono, use el ID de tarea devuelto para [consultar el estado](/es/api-manual/task-management/get-task-detail) - Los enlaces de video generados son válidos durante 24 horas, guárdelos cuanto antes ## Facturación - **Fórmula de facturación**: duración facturada = duración del video de entrada + duración del video de salida, facturación por segundo - **Multiplicador de resolución**: `480p` = 1x (base), `720p` = 2x, `1080p` = 4x - Las imágenes de referencia, el audio de referencia, los archivos de referencia y los enlaces de páginas web **no se facturan** - Cuando `duration` es `-1` (duración inteligente) se preautoriza el máximo de `30` segundos; tras completarse la tarea se liquida según la duración realmente producida y la diferencia se reembolsa automáticamente - Activar o desactivar la pista `audio` **cuesta lo mismo** - **Las tareas fallidas no se facturan**, los créditos congelados se reembolsan íntegramente operationId: createWan30Video requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: text_to_video: summary: Texto a video value: model: wan3.0-text-to-video prompt: >- A kitten runs across a rooftop in the moonlight, city neon flickers in the distance, cinematic quality, smooth camera work. duration: 5 quality: 720p aspect_ratio: '16:9' generate_audio: true image_to_video: summary: Imagen a video (fotogramas inicial y final) value: model: wan3.0-image-to-video prompt: >- A young girl's smile gradually turns into a big laugh, the camera slowly pushes in, and the background light shifts from cool tones to warm tones. image_start: https://example.com/first_frame.jpg image_end: https://example.com/last_frame.jpg duration: 5 quality: 720p reference_to_video: summary: Referencia a video (materiales multimodales) value: model: wan3.0-reference-video prompt: >- The character in Video 1 holds Image 3 and plays a soft country folk tune on the chair in Image 4, saying: “What lovely sunshine today.” image_urls: - https://example.com/role.jpg - https://example.com/object.png - https://example.com/guitar.png - https://example.com/chair.png video_urls: - https://example.com/ref_role.mp4 duration: 10 quality: 720p aspect_ratio: adaptive smart_duration: summary: Duración inteligente (el modelo decide la longitud) value: model: wan3.0-text-to-video prompt: >- A high-end smart glasses product ad, minimalist and futuristic, the camera glides over the lens and hinge details and finally settles on the brand logo. duration: -1 quality: 1080p aspect_ratio: '16:9' responses: '200': description: Tarea de generación de video creada exitosamente content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Parámetros de solicitud inválidos content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_parameter message: Invalid request parameters type: invalid_request_error '401': description: No autenticado, token inválido o expirado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Cuota insuficiente, se requiere recarga content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Acceso denegado content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: wan3.0-text-to-video' type: invalid_request_error '429': description: Límite de velocidad excedido content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model properties: model: type: string description: Nombre del modelo de generación de video enum: - wan3.0-text-to-video - wan3.0-image-to-video - wan3.0-reference-video example: wan3.0-text-to-video prompt: type: string description: >- Prompt de texto para la generación de video. Admite chino e inglés, **cada carácter chino / letra cuenta como 1 carácter**, longitud máxima `20000` caracteres; el excedente se trunca automáticamente (sin error) **Obligatoriedad:** obligatorio para `wan3.0-text-to-video`; para `wan3.0-reference-video` debe haber al menos prompt o materiales de referencia; para `wan3.0-image-to-video` se recomienda enviarlo para describir el cambio de imagen **Reglas para referirse a los materiales (referencia a video):** - Use "Image 1", "Video 1" y "Audio 1" para referirse a los materiales del array correspondiente (empezando en 1) - Imágenes, videos y audio se **cuentan de forma independiente**, por lo que "Image 1" y "Video 1" pueden coexistir example: >- The character in Video 1 holds Image 3 and plays a soft country folk tune on the chair in Image 4, saying: “What lovely sunshine today.” image_start: type: string format: uri description: >- URL de la imagen del primer fotograma, usada estrictamente como primer fotograma del video generado. **Solo disponible para `wan3.0-image-to-video`** **Límites de imagen:** - Formatos: JPEG, JPG, PNG (sin transparencia), BMP, WEBP - Resolución: ancho y alto en `[240, 8000]` píxeles - Relación de aspecto: 1:8 ~ 8:1 - Tamaño de archivo: hasta `20MB` example: https://example.com/first_frame.jpg image_end: type: string format: uri description: >- URL de la imagen del último fotograma, usada estrictamente como último fotograma del video generado. **Solo disponible para `wan3.0-image-to-video`** **Restricción:** debe usarse junto con `image_start`, no se admite enviar solo el último fotograma. **Límites de imagen:** - Formatos: JPEG, JPG, PNG (sin transparencia), BMP, WEBP - Resolución: ancho y alto en `[240, 8000]` píxeles - Relación de aspecto: 1:8 ~ 8:1 - Tamaño de archivo: hasta `20MB` example: https://example.com/last_frame.jpg image_urls: type: array items: type: string format: uri maxItems: 10 description: >- Array de URL de imágenes de referencia, **hasta 10 imágenes**, **solo disponible para `wan3.0-reference-video`**. Puede aportar sujetos (personas/animales/objetos) o fondos de escena; cuando incluya un sujeto, se recomienda que cada imagen contenga un **único** personaje El orden del array se corresponde con "Image 1, Image 2..." del prompt **Nota:** para los fotogramas inicial y final de imagen a video use `image_start` / `image_end`, no este campo **Límites de imagen:** - Formatos: JPEG, JPG, PNG (sin transparencia), BMP, WEBP - Resolución: ancho y alto en `[240, 8000]` píxeles - Relación de aspecto: 1:8 ~ 8:1 - Tamaño de archivo: hasta `20MB` example: - https://example.com/ref1.jpg - https://example.com/ref2.png video_urls: type: array items: type: string format: uri maxItems: 5 description: >- Array de URL de videos de referencia, **hasta 5 clips**, **solo disponible para `wan3.0-reference-video`**. El orden del array se corresponde con "Video 1, Video 2..." del prompt **Límites de duración:** - `1 ~ 15` segundos por clip - **15 segundos como máximo en total** - La duración total de los videos de referencia + la duración del video de salida **no puede superar 30 segundos** **🔴 Los videos de referencia cuentan para la facturación**: duración facturada = duración del video de entrada + duración del video de salida. Las imágenes de referencia, el audio de referencia, los archivos y las páginas web no se facturan **Límites de video:** - Formatos: mp4, mov - Resolución: ancho y alto en `[240, 4096]` píxeles - Relación de aspecto: 1:8 ~ 8:1 - Tamaño por archivo: hasta `100MB` example: - https://example.com/ref_video.mp4 audio_urls: type: array items: type: string format: uri maxItems: 5 description: >- Array de URL de audio de referencia, **hasta 5 clips**, **solo disponible para `wan3.0-reference-video`**. El orden del array se corresponde con "Audio 1, Audio 2..." del prompt **⚠️ Semántica distinta a la de Wan2.7:** en Wan2.7, `audio_urls` era una **voz** vinculada a una imagen o un video de referencia concretos; en Wan3.0 el audio de referencia es un **material independiente** al que el prompt hace referencia directamente como "Audio 1", y el protocolo de vinculación de voz `model_params.voice_bindings` **no se admite**. Tenga en cuenta la reescritura al migrar desde Wan2.7. **Límites de duración:** - `1 ~ 15` segundos por clip, 15 segundos como máximo en total - El audio de referencia **no se factura** **Límites de audio:** - Formatos: wav, mp3 - Tamaño de archivo: hasta `15MB` example: - https://example.com/ref_audio.mp3 duration: type: integer description: >- Duración del video generado (segundos), `5` de forma predeterminada **Valores admitidos:** - Cualquier entero entre `2` y `30` - `-1`: duración inteligente, el modelo decide la longitud de salida a partir del prompt y los materiales de entrada **Cómo se factura la duración inteligente:** al enviar la solicitud no se sabe cuánto durará el resultado, por lo que se **preautoriza el máximo** de `30` segundos; tras completarse la tarea se liquida según la duración realmente producida y el exceso congelado se libera automáticamente. Si su saldo no cubre la preautorización máxima, indique un número de segundos explícito. **Restricción adicional al enviar videos de referencia:** - La duración total de los videos de referencia + la duración del video de salida **no puede superar 30 segundos** - Ejemplo: con 10 segundos de video de referencia en total, `duration` puede ser como mucho 20 default: 5 example: 5 quality: type: string description: >- Resolución del video, `720p` de forma predeterminada **Valores posibles:** - `480p`: menor definición, precio más bajo (base de facturación) - `720p`: definición estándar, valor predeterminado, precio 2x el de `480p` - `1080p`: alta definición, precio 4x el de `480p` enum: - 480p - 720p - 1080p default: 720p example: 720p aspect_ratio: type: string description: >- Relación de aspecto del video, `adaptive` de forma predeterminada **Valores posibles:** - `adaptive`: adaptativa, el modelo recomienda una relación de aspecto adecuada según la proporción de los materiales de entrada y la intención del prompt, valor predeterminado - `16:9` (horizontal), `9:16` (vertical), `1:1` (cuadrado), `4:3`, `3:4` enum: - adaptive - '16:9' - '9:16' - '1:1' - '4:3' - '3:4' default: adaptive example: '16:9' generate_audio: type: boolean description: >- Indica si el video de salida incluye pista de audio, `true` de forma predeterminada **Valores posibles:** - `true`: el video de salida incluye sonido (voces, efectos, música de fondo), valor predeterminado - `false`: video de salida sin sonido **Con o sin sonido el precio es el mismo**, no hay cargo adicional. default: true example: true seed: type: integer description: >- Semilla aleatoria, sirve para reproducir los resultados, aleatoria de forma predeterminada **Notas:** - Rango: `0` ~ `2147483647` - Fijar la semilla reduce la variación al iterar prompts y mejora la reproducibilidad minimum: 0 maximum: 2147483647 example: 42 model_params: type: object description: >- Parámetros de extensión del modelo, **solo disponibles para `wan3.0-reference-video`**. `file_url` y `link_url` son **excluyentes**, solo puede usar uno de los dos properties: file_url: type: string format: uri description: >- URL del archivo de referencia, **1 como máximo**. El modelo entiende automáticamente el contenido del archivo y genera el video a partir de él (por ejemplo, convertir un deck de producto en un video promocional) **Excluyente con `link_url`**, no se pueden enviar ambos a la vez **Límites de archivo:** - Formatos: docx, doc, xlsx, xls, pptx, ppt, pdf, txt, key, pages, numbers, md - Tamaño de archivo: hasta `100MB` - Número de páginas: 50 páginas como máximo example: https://example.com/product-deck.pptx link_url: type: string format: uri description: >- Enlace de la página web de referencia, **1 como máximo**. El modelo rastrea y entiende automáticamente el contenido de la página y luego genera el video **Excluyente con `file_url`**, no se pueden enviar ambos a la vez **Limitación:** solo se pueden analizar páginas públicas **que no requieran inicio de sesión** (noticias, blogs, artículos de boletines, etc.) example: https://example.com/article/12345 callback_url: type: string description: >- URL de callback HTTPS después de completar la tarea **Momento del callback:** - Se activa cuando la tarea se completa (completed), falla (failed) o se cancela (cancelled) - Se envía después de completar la confirmación de facturación **Restricciones de seguridad:** - Solo se admite el protocolo HTTPS - Se prohíben los callbacks a direcciones IP de red interna (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - La longitud de la URL no debe exceder `2048` caracteres **Mecanismo de callback:** - Tiempo de espera: `10` segundos - Máximo de `3` reintentos después de un fallo (los reintentos ocurren después de `1`/`2`/`4` segundos tras el fallo) - El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas - Un código de estado 2xx se considera exitoso, otros códigos de estado activan reintentos format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Marca de tiempo de creación de la tarea example: 1761313744 id: type: string description: ID de tarea example: task-unified-1774857405-abc123 model: type: string description: Nombre del modelo realmente utilizado example: wan3.0-text-to-video object: type: string enum: - video.generation.task description: Tipo específico de la tarea progress: type: integer description: Porcentaje de progreso de la tarea (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Estado de la tarea enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Información detallada de la tarea de video type: type: string enum: - text - image - audio - video description: Tipo de salida de la tarea example: video usage: $ref: '#/components/schemas/VideoUsage' description: Información de uso y facturación ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Identificador del código de error message: type: string description: Descripción del error type: type: string description: Tipo de error VideoTaskInfo: type: object properties: can_cancel: type: boolean description: Si la tarea puede ser cancelada example: true estimated_time: type: integer description: Tiempo estimado de finalización (segundos) minimum: 0 example: 165 video_duration: type: integer description: Duración del video (segundos) example: 8 VideoUsage: type: object description: Información de uso y facturación properties: billing_rule: type: string description: Regla de facturación enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: Créditos estimados consumidos minimum: 0 example: 50 user_group: type: string description: Categoría de grupo de usuarios example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##Todas las APIs requieren autenticación Bearer Token## **Obtener API Key:** Visita la [Página de gestión de API Key](https://evolink.ai/dashboard/keys) para obtener tu API Key **Agregar al encabezado de la solicitud:** ``` Authorization: Bearer YOUR_API_KEY ``` ````