{"servers":[{"url":"https://api.modellix.ai/api/v1/alibaba/wan3.0-i2v"}],"post":{"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":{"content":{"application/json":{"examples":{"first_frame":{"summary":"First-frame generation","value":{"duration":5,"first_frame":"https://example.com/first.png","prompt":"A graffiti character comes alive and raps under a streetlamp","ratio":"1:1"}},"first_last_frame":{"summary":"First-last-frame generation","value":{"duration":5,"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"}},"reference_images":{"summary":"Reference-image generation","value":{"duration":8,"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"]}}},"schema":{"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":[{"description":"First-frame or first-to-last-frame animation.","properties":{"audio":{"default":true,"description":"Whether the output video includes an audio track","example":true,"type":"boolean"},"duration":{"default":5,"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],"example":5,"type":"integer"},"first_frame":{"description":"Required. First-frame image URL. Do not pass reference_images or audio_urls.","example":"https://example.com/first.png","format":"uri","type":"string"},"last_frame":{"description":"Optional. Last-frame image URL. Requires first_frame. Do not pass reference_images or audio_urls.","example":"https://example.com/last.png","format":"uri","type":"string"},"prompt":{"description":"Optional. Text prompt describing the desired video content. Supports Chinese and English. Max 20000 characters.","example":"A cute cat running on a moonlit rooftop, cinematic.","maxLength":20000,"minLength":1,"type":"string"},"ratio":{"default":"1:1","description":"Specifies the aspect ratio for the generated video","enum":["16:9","4:3","1:1","3:4","9:16"],"example":"1:1","type":"string"},"resolution":{"default":"1080P","description":"Specifies the resolution tier for the generated video","enum":["480P","720P","1080P"],"example":"1080P","type":"string"},"seed":{"description":"Random number seed for reproducibility. Identical seeds cannot guarantee completely identical results","example":12345,"maximum":2147483647,"minimum":0,"type":"integer"}},"required":["first_frame"],"title":"Option 1 — Frame mode","type":"object"},{"description":"Multimodal reference images with optional audio.","properties":{"audio":{"default":true,"description":"Whether the output video includes an audio track","example":true,"type":"boolean"},"audio_urls":{"description":"Optional. Reference audio URLs (1-5). Only valid with reference_images.","example":["https://example.com/voice.mp3"],"items":{"format":"uri","type":"string"},"maxItems":5,"minItems":1,"type":"array"},"duration":{"default":5,"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],"example":5,"type":"integer"},"prompt":{"description":"Optional. Text prompt. Supports Chinese and English. Max 20000 characters. Use image1/audio1 style references when citing inputs.","example":"A cute cat running on a moonlit rooftop, cinematic.","maxLength":20000,"minLength":1,"type":"string"},"ratio":{"default":"1:1","description":"Specifies the aspect ratio for the generated video","enum":["16:9","4:3","1:1","3:4","9:16"],"example":"1:1","type":"string"},"reference_images":{"description":"Required. Reference image URLs (1-10). Do not pass first_frame or last_frame.","example":["https://example.com/a.png","https://example.com/b.png"],"items":{"format":"uri","type":"string"},"maxItems":10,"minItems":1,"type":"array"},"resolution":{"default":"1080P","description":"Specifies the resolution tier for the generated video","enum":["480P","720P","1080P"],"example":"1080P","type":"string"},"seed":{"description":"Random number seed for reproducibility. Identical seeds cannot guarantee completely identical results","example":12345,"maximum":2147483647,"minimum":0,"type":"integer"}},"required":["reference_images"],"title":"Option 2 — Reference mode","type":"object"}]}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Detailed data about the submitted asynchronous task.","properties":{"get_result":{"description":"API information to query the task result","properties":{"method":{"description":"HTTP method","example":"GET","type":"string"},"url":{"description":"Full URL to query the task result","example":"https://api.modellix.ai/api/v1/tasks/task-abc123","type":"string"}},"type":"object"},"model_id":{"description":"Model ID","example":"model-123","type":"string"},"status":{"description":"Task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier","example":"task-abc123","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully"}},"summary":"Wan 3.0 I2V","x-mint":{"href":"alibaba/wan3-0-i2v"}}}