> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Wan2.7 Imagen a video > - El modelo WAN2.7 (wan2.7-image-to-video) admite generación de imagen a video con entradas multimodales (imagen / audio / video) - Elija uno de tres modos de generación mediante `generation_mode`: - `first_frame`: **Primer fotograma a video** — genera un video a partir del fotograma inicial, con audio impulsor opcional - `first_last_frame`: **Primer y último fotograma a video** — genera un video interpolando entre el primer y último fotograma, con audio impulsor opcional - `video_continuation`: **Continuación de video** — continúa un clip de video de entrada; se permite un fotograma final opcional (sin audio impulsor) - `generation_mode` es opcional (compatibilidad hacia atrás); si se omite, se selecciona automáticamente el modo apropiado según los materiales proporcionados - Combinaciones de materiales válidas (cualquier otra será rechazada): 1. `image_start` (primer fotograma) 2. `image_start` + `audio_urls` (primer fotograma + audio impulsor) 3. `image_start` + `image_end` (primer + último fotograma) 4. `image_start` + `image_end` + `audio_urls` (primer + último fotograma + audio impulsor) 5. `video_urls` (continuación de video) 6. `video_urls` + `image_end` (continuación de video + último fotograma) - 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 ## OpenAPI ````yaml es/api-manual/video-series/wan2.7/wan2.7-image-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: wan2.7-image-to-video API description: >- Genera videos a partir de imágenes utilizando el modelo WAN2.7. Admite imágenes de primer/último fotograma, clips de continuación de video y generación impulsada por audio license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Entorno de Producción security: - bearerAuth: [] paths: /v1/videos/generations: post: tags: - Generación de Video summary: wan2.7-image-to-video API description: >- - El modelo WAN2.7 (wan2.7-image-to-video) admite generación de imagen a video con entradas multimodales (imagen / audio / video) - Elija uno de tres modos de generación mediante `generation_mode`: - `first_frame`: **Primer fotograma a video** — genera un video a partir del fotograma inicial, con audio impulsor opcional - `first_last_frame`: **Primer y último fotograma a video** — genera un video interpolando entre el primer y último fotograma, con audio impulsor opcional - `video_continuation`: **Continuación de video** — continúa un clip de video de entrada; se permite un fotograma final opcional (sin audio impulsor) - `generation_mode` es opcional (compatibilidad hacia atrás); si se omite, se selecciona automáticamente el modo apropiado según los materiales proporcionados - Combinaciones de materiales válidas (cualquier otra será rechazada): 1. `image_start` (primer fotograma) 2. `image_start` + `audio_urls` (primer fotograma + audio impulsor) 3. `image_start` + `image_end` (primer + último fotograma) 4. `image_start` + `image_end` + `audio_urls` (primer + último fotograma + audio impulsor) 5. `video_urls` (continuación de video) 6. `video_urls` + `image_end` (continuación de video + último fotograma) - 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 operationId: createWan27ImageToVideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Wan27ImageToVideoRequest' examples: first_frame: summary: Primer fotograma a video value: model: wan2.7-image-to-video generation_mode: first_frame prompt: Un gato tocando el piano image_start: https://example.com/first_frame.jpg first_frame_with_audio: summary: Primer fotograma + audio impulsor value: model: wan2.7-image-to-video generation_mode: first_frame prompt: Un joven interpretando un rap en inglés image_start: https://example.com/first_frame.jpg audio_urls: - https://example.com/rap.mp3 first_last_frame: summary: Primer y último fotograma a video value: model: wan2.7-image-to-video generation_mode: first_last_frame prompt: >- La cámara sube gradualmente desde el nivel de los ojos hasta una vista cenital image_start: https://example.com/first_frame.png image_end: https://example.com/last_frame.png video_continuation: summary: Continuación de video value: model: wan2.7-image-to-video generation_mode: video_continuation prompt: >- Una chica se hace un selfie frente al espejo y luego sale de casa con su mochila video_urls: - https://example.com/clip.mp4 responses: '200': description: Tarea de video creada con éxito 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_request message: Invalid request parameters type: invalid_request_error '401': description: No autenticado, token inválido o caducado 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: Sin permiso de acceso content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: wan2.7-image-to-video' type: invalid_request_error '429': description: Límite de tasa de solicitudes 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: Wan27ImageToVideoRequest: required: - model type: object properties: model: type: string description: Nombre del modelo, debe ser `wan2.7-image-to-video` enum: - wan2.7-image-to-video example: wan2.7-image-to-video generation_mode: type: string description: >- Modo de generación que determina qué combinaciones de materiales son válidas. **Se recomienda especificarlo explícitamente** **Valores:** - `first_frame`: Primer fotograma a video. Requerido: `image_start`. Opcional: `audio_urls`. No aceptado: `image_end`, `video_urls` - `first_last_frame`: Primer y último fotograma a video. Requerido: `image_start` + `image_end`. Opcional: `audio_urls`. No aceptado: `video_urls` - `video_continuation`: Continuación de video. Requerido: `video_urls[0]`. Opcional: `image_end` (como fotograma final). No aceptado: `image_start`, `audio_urls` **Comportamiento de compatibilidad:** cuando se omite `generation_mode`, se selecciona automáticamente el modo apropiado según los materiales proporcionados; especificarlo explícitamente evita ambigüedades enum: - first_frame - first_last_frame - video_continuation example: first_frame prompt: type: string description: >- Prompt textual para la generación de video. Admite chino e inglés; cada carácter/letra cuenta como 1, el exceso se trunca automáticamente. Longitud máxima: 5000 caracteres maxLength: 5000 example: Un gato tocando el piano negative_prompt: type: string description: >- Prompt negativo que describe lo que no debe aparecer en el video. Admite chino e inglés. Longitud máxima 500 caracteres; el exceso se trunca automáticamente maxLength: 500 example: Borroso, baja calidad image_start: type: string format: uri description: |- URL de la imagen del primer fotograma **Restricciones por modo:** - Modo `first_frame`: **requerido** - Modo `first_last_frame`: **requerido** - Modo `video_continuation`: **no permitido** **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 **Restricciones por modo:** - Modo `first_last_frame`: **requerido** - Modo `video_continuation`: opcional (actúa como fotograma final de la continuación) - Modo `first_frame`: **no permitido** (use `first_last_frame` si necesita primer y ú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 video_urls: type: array items: type: string format: uri description: >- Lista de URLs para continuación de video. **Solo se admite 1 elemento** **Restricciones por modo:** - Modo `video_continuation`: **requerido** - Modo `first_frame` / `first_last_frame`: **no permitido** - No puede combinarse con `audio_urls` **Límites de video:** - Formatos: mp4, mov - Duración: `2 ~ 10` segundos (longitud del clip de entrada) - Resolución: ancho y alto en `[240, 4096]` píxeles - Relación de aspecto: 1:8 ~ 8:1 - Tamaño de archivo: hasta `100MB` **Reglas de duración para continuación:** - `duration` representa la **duración total del video final de salida** (clip de entrada + continuación generada por el modelo) - Duración generada por el modelo = `duration` − duración del video de entrada - `duration` debe ser ≥ duración del video de entrada - La facturación se basa en la duración total del video final (es decir, `duration`) **Ejemplos:** | Duración del clip de entrada | duration | Continuación generada | Salida final | Facturado | | --- | --- | --- | --- | --- | | 3s | 15 | 12s | 15s | 15s | | 5s | 10 | 5s | 10s | 10s | | 8s | 8 | 0s (solo entrada) | 8s | 8s | example: - https://example.com/clip.mp4 audio_urls: type: array items: type: string format: uri minItems: 1 maxItems: 1 description: >- Lista de URLs de audio impulsor. **Actualmente solo se admite 1 elemento**. El modelo usará este audio como fuente impulsora para la generación (p. ej. sincronización labial, sincronización de movimiento) **Restricciones por modo:** - Modo `first_frame`: opcional - Modo `first_last_frame`: opcional - Modo `video_continuation`: **no permitido** (no puede combinarse con `video_urls`) **Requisitos de formato:** - Formatos admitidos: `wav`, `mp3` - Duración: `2 ~ 30` segundos - Tamaño de archivo: hasta `15MB` **Manejo de truncamiento:** - Si la duración del audio supera `duration`, se usan los primeros N segundos y el resto se descarta - Si la duración del audio es menor que la del video, la parte restante queda en silencio. Por ejemplo: con audio de 3s y video de 5s, los primeros 3s tienen sonido y los últimos 2s son silenciosos example: - https://example.com/audio.mp3 quality: type: string description: |- Calidad del video, predeterminada `720p` **Opciones:** - `720p`: Definición estándar, precio estándar (predeterminado) - `1080p`: Alta definición, precio mayor enum: - 720p - 1080p default: 720p example: 720p duration: type: number description: >- Duración del video en segundos (entero). Rango `2 ~ 15`, predeterminado `5` **Significado:** - Modos `first_frame` / `first_last_frame`: longitud total del video generado - Modo `video_continuation`: longitud total del video final de salida (= clip de entrada + continuación generada por el modelo) **Restricciones adicionales en modo `video_continuation`:** - `duration` debe ser **≥ duración del video de entrada** (de lo contrario, se devuelve un error) - Duración generada por el modelo = `duration` − duración del video de entrada - Cuando `duration` iguala la duración del video de entrada, no se genera continuación y se devuelve el clip de entrada tal cual - Vea las reglas y ejemplos de continuación en el campo `video_urls` **Facturación:** basada en la duración real del video generado minimum: 2 maximum: 15 default: 5 example: 5 seed: type: integer description: >- Semilla aleatoria, aleatoria por defecto **Notas:** - Rango: `1` ~ `2147483647` - Fijar la semilla reduce la variación al iterar prompts y mejora la reproducibilidad minimum: 1 maximum: 2147483647 example: 42 prompt_extend: type: boolean description: >- Si activar la reescritura inteligente del prompt. Cuando se activa, un modelo grande optimiza el prompt, mejorando notablemente los resultados con prompts simples o poco descriptivos. **Nota:** El valor predeterminado es `false`. Omitir el campo o enviar `false` no activará la reescritura; envíe `true` explícitamente para habilitarla. default: false example: false callback_url: type: string description: >- URL de callback HTTPS para la finalización de la tarea **Momento del callback:** - Se dispara cuando la tarea se completa, falla o se cancela - Se envía tras la confirmación de facturación **Restricciones de seguridad:** - Solo se admite HTTPS - Los callbacks a direcciones IP internas están prohibidos (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - La URL no debe superar `2048` caracteres **Mecanismo de callback:** - Tiempo de espera: `10` segundos - Hasta `3` reintentos tras fallo (a `1`/`2`/`4` segundos) - El formato de respuesta del callback es idéntico al de la API de consulta de tareas - Códigos 2xx se consideran exitosos; otros códigos disparan 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: 1757169743 id: type: string description: ID de la tarea example: task-unified-1757169743-7cvnl5zw model: type: string description: Nombre del modelo realmente usado example: wan2.7-image-to-video object: type: string enum: - video.generation.task description: Tipo específico de tarea progress: type: integer description: Progreso de la tarea en porcentaje (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/Usage' 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 cancelarse example: true estimated_time: type: integer description: Tiempo estimado de finalización (segundos) minimum: 0 example: 120 Usage: 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_call credits_reserved: type: number description: Créditos estimados a consumir minimum: 0 example: 5 user_group: type: string description: Categoría de grupo de usuario enum: - default - vip example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## Todas las APIs requieren autenticación con Bearer Token ## **Obtenga su API Key:** Visite la [página de gestión de API Keys](https://evolink.ai/dashboard/keys) para obtener su API Key **Añada al encabezado de la solicitud:** ``` Authorization: Bearer YOUR_API_KEY ``` ````