> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # Wan 3.0 I2V > [Core Function] Wan 3.0 I2V is Alibaba Wan 3.0 image-to-video generation supporting first-frame, first-last-frame, and reference-image modes. [Strengths] It can strictly lock the first and last frames or fuse up to 10 reference images with optional reference audio for multimodal guidance. [Best For] Highly recommended for: animating a single keyframe, cinematic first-to-last transitions, multi-image character or product consistency, and image-led storytelling. [Limitations] Do NOT use this model for text-only generation, document/webpage reference, or when a reference video is required. Do NOT mix first_frame/last_frame with reference_images/audio_urls. [Routing] Prefer this model for Wan 3.0 image-driven video. Use Wan 3.0 T2V for prompt/file/link inputs and Wan 3.0 V2V when video_urls are provided. ## OpenAPI ````yaml /media-model-api/alibaba/alibaba-i2v.json post /alibaba/wan3.0-i2v openapi: 3.1.0 info: description: The image-to-video models API from Alibaba. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: Alibaba Image-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The image-to-video models API from Alibaba. security: - bearerAuth: [] paths: /alibaba/wan3.0-i2v: post: summary: Wan 3.0 I2V description: >- [Core Function] Wan 3.0 I2V is Alibaba Wan 3.0 image-to-video generation supporting first-frame, first-last-frame, and reference-image modes. [Strengths] It can strictly lock the first and last frames or fuse up to 10 reference images with optional reference audio for multimodal guidance. [Best For] Highly recommended for: animating a single keyframe, cinematic first-to-last transitions, multi-image character or product consistency, and image-led storytelling. [Limitations] Do NOT use this model for text-only generation, document/webpage reference, or when a reference video is required. Do NOT mix first_frame/last_frame with reference_images/audio_urls. [Routing] Prefer this model for Wan 3.0 image-driven video. Use Wan 3.0 T2V for prompt/file/link inputs and Wan 3.0 V2V when video_urls are provided. operationId: wan30I2vAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/Wan30I2vRequest' examples: first_frame: summary: First-frame generation value: first_frame: https://example.com/first.png prompt: A graffiti character comes alive and raps under a streetlamp duration: 5 ratio: '1:1' first_last_frame: summary: First-last-frame generation value: first_frame: https://example.com/first.png last_frame: https://example.com/last.png prompt: >- A young woman transitions from a smile to a laugh as the camera slowly pushes in resolution: 1080P duration: 5 reference_images: summary: Reference-image generation value: prompt: >- Image 1 walks past image 2 and places object image 3 on the table reference_images: - https://example.com/person.png - https://example.com/scene.png - https://example.com/object.png duration: 8 responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' components: schemas: Wan30I2vRequest: description: >- Wan 3.0 image-to-video. Choose **one** option — Frame and Reference fields are mutually exclusive. `prompt` is optional. audio_urls is only valid with reference_images. oneOf: - $ref: '#/components/schemas/Wan30I2vFrameOption' title: Option 1 — Frame mode description: First-frame or first-to-last-frame animation. - $ref: '#/components/schemas/Wan30I2vReferenceOption' title: Option 2 — Reference mode description: Multimodal reference images with optional audio. AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier example: task-abc123 model_id: type: string description: Model ID example: model-123 get_result: type: object description: API information to query the task result properties: method: type: string description: HTTP method example: GET url: type: string description: Full URL to query the task result example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. Wan30I2vFrameOption: type: object description: >- First-frame or first-to-last-frame animation. Do not pass `reference_images` or `audio_urls`. required: - first_frame properties: first_frame: type: string format: uri description: >- Required. First-frame image URL. Do not pass reference_images or audio_urls. example: https://example.com/first.png last_frame: type: string format: uri description: >- Optional. Last-frame image URL. Requires first_frame. Do not pass reference_images or audio_urls. example: https://example.com/last.png prompt: type: string description: >- Optional. Text prompt describing the desired video content. Supports Chinese and English. Max 20000 characters. minLength: 1 maxLength: 20000 example: A cute cat running on a moonlit rooftop, cinematic. resolution: type: string description: Specifies the resolution tier for the generated video enum: - 480P - 720P - 1080P default: 1080P example: 1080P ratio: type: string description: Specifies the aspect ratio for the generated video enum: - '16:9' - '4:3' - '1:1' - '3:4' - '9:16' default: '1:1' example: '1:1' duration: type: integer description: Video duration in seconds. Allowed values are integers from 2 to 30 enum: - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 - 11 - 12 - 13 - 14 - 15 - 16 - 17 - 18 - 19 - 20 - 21 - 22 - 23 - 24 - 25 - 26 - 27 - 28 - 29 - 30 default: 5 example: 5 audio: type: boolean description: Whether the output video includes an audio track default: true example: true seed: type: integer description: >- Random number seed for reproducibility. Identical seeds cannot guarantee completely identical results minimum: 0 maximum: 2147483647 example: 12345 Wan30I2vReferenceOption: type: object description: >- Multimodal reference images (and optional audio). Do not pass `first_frame` or `last_frame`. required: - reference_images properties: reference_images: type: array description: >- Required. Reference image URLs (1-10). Do not pass first_frame or last_frame. minItems: 1 maxItems: 10 items: type: string format: uri example: - https://example.com/a.png - https://example.com/b.png audio_urls: type: array description: >- Optional. Reference audio URLs (1-5). Only valid with reference_images. minItems: 1 maxItems: 5 items: type: string format: uri example: - https://example.com/voice.mp3 prompt: type: string description: >- Optional. Text prompt. Supports Chinese and English. Max 20000 characters. Use image1/audio1 style references when citing inputs. minLength: 1 maxLength: 20000 example: A cute cat running on a moonlit rooftop, cinematic. resolution: type: string description: Specifies the resolution tier for the generated video enum: - 480P - 720P - 1080P default: 1080P example: 1080P ratio: type: string description: Specifies the aspect ratio for the generated video enum: - '16:9' - '4:3' - '1:1' - '3:4' - '9:16' default: '1:1' example: '1:1' duration: type: integer description: Video duration in seconds. Allowed values are integers from 2 to 30 enum: - 2 - 3 - 4 - 5 - 6 - 7 - 8 - 9 - 10 - 11 - 12 - 13 - 14 - 15 - 16 - 17 - 18 - 19 - 20 - 21 - 22 - 23 - 24 - 25 - 26 - 27 - 28 - 29 - 30 default: 5 example: 5 audio: type: boolean description: Whether the output video includes an audio track default: true example: true seed: type: integer description: >- Random number seed for reproducibility. Identical seeds cannot guarantee completely identical results minimum: 0 maximum: 2147483647 example: 12345 securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ````