> ## 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 Reference-to-Video > - Con imágenes / videos / audio de referencia, archivos o páginas web como material, el modelo entiende automáticamente la intención y genera el video - En el prompt, use "Image 1", "Video 1" y "Audio 1" para referirse al material correspondiente; **los tres tipos de material se cuentan de forma independiente** - `prompt` y los materiales de referencia: **debe proporcionarse al menos uno de los dos** - **No se aceptan fotogramas inicial y final** (`image_start` / `image_end`): los materiales de referencia y los fotogramas inicial y final son excluyentes. Si necesita controlar estrictamente el inicio y el final de la imagen, use [Wan3.0 imagen a video](/es/api-manual/video-series/wan3.0/wan3.0-image-to-video) - **🔴 Los videos de referencia cuentan para la facturación**, las imágenes de referencia / audio de referencia / archivos / páginas web no se facturan - 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-reference-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: Wan3.0 Reference-to-Video API description: >- Wan 3.0 referencia a video, admite entrada multimodal mixta de imágenes, videos y audio de referencia, archivos y páginas web 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 Reference-to-Video description: >- - Con imágenes / videos / audio de referencia, archivos o páginas web como material, el modelo entiende automáticamente la intención y genera el video - En el prompt, use "Image 1", "Video 1" y "Audio 1" para referirse al material correspondiente; **los tres tipos de material se cuentan de forma independiente** - `prompt` y los materiales de referencia: **debe proporcionarse al menos uno de los dos** - **No se aceptan fotogramas inicial y final** (`image_start` / `image_end`): los materiales de referencia y los fotogramas inicial y final son excluyentes. Si necesita controlar estrictamente el inicio y el final de la imagen, use [Wan3.0 imagen a video](/es/api-manual/video-series/wan3.0/wan3.0-image-to-video) - **🔴 Los videos de referencia cuentan para la facturación**, las imágenes de referencia / audio de referencia / archivos / páginas web no se facturan - 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: createWan30ReferenceVideo requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: multi_modal: summary: Referencia con varios materiales (imágenes + video) 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 with_audio: summary: Con audio de referencia value: model: wan3.0-reference-video prompt: >- The character in Image 1 dances to the rhythm of Audio 1, with the camera orbiting around them. image_urls: - https://example.com/dancer.jpg audio_urls: - https://example.com/beat.mp3 duration: 10 from_file: summary: Archivo de referencia a video (PPT a video promocional) value: model: wan3.0-reference-video prompt: >- Turn this product deck into a high-end product ad, minimalist, futuristic and upmarket overall, with restrained lighting. model_params: file_url: https://example.com/product-deck.pptx duration: 10 quality: 1080p aspect_ratio: '16:9' from_link: summary: Página web de referencia a video value: model: wan3.0-reference-video prompt: >- Turn the key points of this article into a short infographic-style video. model_params: link_url: https://example.com/article/12345 duration: 15 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-reference-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, fijo en `wan3.0-reference-video` enum: - wan3.0-reference-video example: wan3.0-reference-video default: wan3.0-reference-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) **Reglas para referirse a los materiales:** - Use "Image 1", "Image 2" para las imágenes en la posición correspondiente de `image_urls` (empezando en 1) - Use "Video 1", "Video 2" para los videos en la posición correspondiente de `video_urls` - Use "Audio 1", "Audio 2" para el audio en la posición correspondiente de `audio_urls` - **Imágenes, videos y audio se cuentan de forma independiente**, por lo que "Image 1" y "Video 1" pueden coexistir - En prompts en inglés escriba "Image 1", "Video 1", "Audio 1" (inicial en mayúscula y espacio entre la palabra y el número) 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_urls: type: array items: type: string format: uri maxItems: 10 description: >- Array de URL de imágenes de referencia, **hasta 10 imágenes**. 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. **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**. 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**. 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 model_params: type: object description: >- Parámetros de extensión del modelo. `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 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 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-reference-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 ``` ````