> ## Documentation Index > Fetch the complete documentation index at: https://oxenai-eric-revamp-getting-started.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # WAN 2.7 - Image to Video > Animates images into videos up to 15s at 1080p with improved motion, scene fidelity, and optional end-frame or audio guidance. Run this model interactively, tune parameters, and compare outputs. **Model ID:** `wan-v2-7-image-to-video` WAN 2.7 image-to-video animates a static image into video with enhanced motion smoothness, superior scene fidelity, and greater visual coherence over previous versions. It supports first-frame-to-video, first+last-frame-to-video, and video continuation scenarios. Output up to 1080p resolution with durations from 2-15 seconds, multiple aspect ratios, and optional driving audio. ## Example request Use the [Workbench](https://www.oxen.ai/ai/workbench?model=wan-v2-7-image-to-video) as a request builder: configure parameters for this model in the UI, then open the **API** tab to copy the exact cURL or Python call. This blocks until the video is ready (typically 5-15 minutes). Prefer **Async** or **Async with SSE** for anything beyond quick experimentation. See the [video generation reference](/inference-api/reference/video_generation) for more details. ```bash cURL theme={null} curl -X POST https://hub.oxen.ai/api/ai/videos/generate \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY" \ -d '{ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png" }' ``` ```python Python theme={null} import os import requests response = requests.post( "https://hub.oxen.ai/api/ai/videos/generate", headers={ "Content-Type": "application/json", "Authorization": f"Bearer {os.environ['OXEN_API_KEY']}", }, json={ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png" }, ) response.raise_for_status() print(response.json()) ``` ```bash cURL theme={null} curl -X POST https://hub.oxen.ai/api/ai/videos/generate \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY" \ -d '{ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" }' ``` ```python Python theme={null} import os import requests response = requests.post( "https://hub.oxen.ai/api/ai/videos/generate", headers={ "Content-Type": "application/json", "Authorization": f"Bearer {os.environ['OXEN_API_KEY']}", }, json={ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" }, ) response.raise_for_status() print(response.json()) ``` ```bash cURL theme={null} curl -X POST https://hub.oxen.ai/api/ai/videos/generate \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY" \ -d '{ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", "resolution": "1080p", "duration": 5 }' ``` ```python Python theme={null} import os import requests response = requests.post( "https://hub.oxen.ai/api/ai/videos/generate", headers={ "Content-Type": "application/json", "Authorization": f"Bearer {os.environ['OXEN_API_KEY']}", }, json={ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", "resolution": "1080p", "duration": 5 }, ) response.raise_for_status() print(response.json()) ``` See the [async queue reference](/inference-api/reference/async_queue) for more details. ```bash cURL theme={null} # Enqueue, capture the generation id. GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY" \ -d '{ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png" }' | jq -r '.generations[0].generation_id') # Poll the single generation until it 404s (terminal state). while curl -s -o /dev/null -w "%{http_code}" \ -H "Authorization: Bearer $OXEN_API_KEY" \ "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | grep -q "^200$"; do sleep 5 done echo "Done. See the 'Async with SSE' tab to receive the result URL." ``` ```python Python theme={null} import os import time import requests HEADERS = { "Content-Type": "application/json", "Authorization": f"Bearer {os.environ['OXEN_API_KEY']}", } enqueue = requests.post( "https://hub.oxen.ai/api/ai/queue", headers=HEADERS, json={ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png" }, ) enqueue.raise_for_status() generation_id = enqueue.json()["generations"][0]["generation_id"] while True: resp = requests.get( f"https://hub.oxen.ai/api/ai/queue/{generation_id}", headers=HEADERS, ) if resp.status_code == 404: break time.sleep(5) print("Done. See the 'Async with SSE' tab to receive the result URL.") ``` ```bash cURL theme={null} # Enqueue, capture the generation id. GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY" \ -d '{ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" }' | jq -r '.generations[0].generation_id') # Poll the single generation until it 404s (terminal state). while curl -s -o /dev/null -w "%{http_code}" \ -H "Authorization: Bearer $OXEN_API_KEY" \ "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | grep -q "^200$"; do sleep 5 done echo "Done. See the 'Async with SSE' tab to receive the result URL." ``` ```python Python theme={null} import os import time import requests HEADERS = { "Content-Type": "application/json", "Authorization": f"Bearer {os.environ['OXEN_API_KEY']}", } enqueue = requests.post( "https://hub.oxen.ai/api/ai/queue", headers=HEADERS, json={ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" }, ) enqueue.raise_for_status() generation_id = enqueue.json()["generations"][0]["generation_id"] while True: resp = requests.get( f"https://hub.oxen.ai/api/ai/queue/{generation_id}", headers=HEADERS, ) if resp.status_code == 404: break time.sleep(5) print("Done. See the 'Async with SSE' tab to receive the result URL.") ``` ```bash cURL theme={null} # Enqueue, capture the generation id. GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY" \ -d '{ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", "resolution": "1080p", "duration": 5 }' | jq -r '.generations[0].generation_id') # Poll the single generation until it 404s (terminal state). while curl -s -o /dev/null -w "%{http_code}" \ -H "Authorization: Bearer $OXEN_API_KEY" \ "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | grep -q "^200$"; do sleep 5 done echo "Done. See the 'Async with SSE' tab to receive the result URL." ``` ```python Python theme={null} import os import time import requests HEADERS = { "Content-Type": "application/json", "Authorization": f"Bearer {os.environ['OXEN_API_KEY']}", } enqueue = requests.post( "https://hub.oxen.ai/api/ai/queue", headers=HEADERS, json={ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", "resolution": "1080p", "duration": 5 }, ) enqueue.raise_for_status() generation_id = enqueue.json()["generations"][0]["generation_id"] while True: resp = requests.get( f"https://hub.oxen.ai/api/ai/queue/{generation_id}", headers=HEADERS, ) if resp.status_code == 404: break time.sleep(5) print("Done. See the 'Async with SSE' tab to receive the result URL.") ``` See the [async queue reference](/inference-api/reference/async_queue) for more details. ```bash cURL theme={null} # Enqueue, capture the generation id. GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY" \ -d '{ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png" }' | jq -r '.generations[0].generation_id') # Stream the SSE channel, grab the data line that follows a # media_generation_completed event for our id, and pretty-print it. curl -sN -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/events \ | awk -v id="$GEN_ID" ' /^event: media_generation_completed$/ { expect=1; next } /^data: / && expect { payload = substr($0, 7) if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit } expect = 0 } ' | jq . ``` ```python Python theme={null} import json import os import requests API_KEY = os.environ["OXEN_API_KEY"] AUTH = {"Authorization": f"Bearer {API_KEY}"} enqueue = requests.post( "https://hub.oxen.ai/api/ai/queue", headers={**AUTH, "Content-Type": "application/json"}, json={ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png" }, ) enqueue.raise_for_status() generation_id = enqueue.json()["generations"][0]["generation_id"] with requests.get( "https://hub.oxen.ai/api/events", headers=AUTH, stream=True, ) as stream: event_name = None for line in stream.iter_lines(decode_unicode=True): if line.startswith("event: "): event_name = line.removeprefix("event: ") elif line.startswith("data: ") and event_name == "media_generation_completed": payload = json.loads(line.removeprefix("data: ")) if payload.get("generation_id") == generation_id: print(payload) break ``` ```bash cURL theme={null} # Enqueue, capture the generation id. GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY" \ -d '{ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" }' | jq -r '.generations[0].generation_id') # Stream the SSE channel, grab the data line that follows a # media_generation_completed event for our id, and pretty-print it. curl -sN -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/events \ | awk -v id="$GEN_ID" ' /^event: media_generation_completed$/ { expect=1; next } /^data: / && expect { payload = substr($0, 7) if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit } expect = 0 } ' | jq . ``` ```python Python theme={null} import json import os import requests API_KEY = os.environ["OXEN_API_KEY"] AUTH = {"Authorization": f"Bearer {API_KEY}"} enqueue = requests.post( "https://hub.oxen.ai/api/ai/queue", headers={**AUTH, "Content-Type": "application/json"}, json={ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" }, ) enqueue.raise_for_status() generation_id = enqueue.json()["generations"][0]["generation_id"] with requests.get( "https://hub.oxen.ai/api/events", headers=AUTH, stream=True, ) as stream: event_name = None for line in stream.iter_lines(decode_unicode=True): if line.startswith("event: "): event_name = line.removeprefix("event: ") elif line.startswith("data: ") and event_name == "media_generation_completed": payload = json.loads(line.removeprefix("data: ")) if payload.get("generation_id") == generation_id: print(payload) break ``` ```bash cURL theme={null} # Enqueue, capture the generation id. GEN_ID=$(curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY" \ -d '{ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", "resolution": "1080p", "duration": 5 }' | jq -r '.generations[0].generation_id') # Stream the SSE channel, grab the data line that follows a # media_generation_completed event for our id, and pretty-print it. curl -sN -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/events \ | awk -v id="$GEN_ID" ' /^event: media_generation_completed$/ { expect=1; next } /^data: / && expect { payload = substr($0, 7) if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit } expect = 0 } ' | jq . ``` ```python Python theme={null} import json import os import requests API_KEY = os.environ["OXEN_API_KEY"] AUTH = {"Authorization": f"Bearer {API_KEY}"} enqueue = requests.post( "https://hub.oxen.ai/api/ai/queue", headers={**AUTH, "Content-Type": "application/json"}, json={ "model": "wan-v2-7-image-to-video", "prompt": "The camera slowly zooms in while the subject comes to life, cinematic lighting.", "input_image": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png", "end_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", "resolution": "1080p", "duration": 5 }, ) enqueue.raise_for_status() generation_id = enqueue.json()["generations"][0]["generation_id"] with requests.get( "https://hub.oxen.ai/api/events", headers=AUTH, stream=True, ) as stream: event_name = None for line in stream.iter_lines(decode_unicode=True): if line.startswith("event: "): event_name = line.removeprefix("event: ") elif line.startswith("data: ") and event_name == "media_generation_completed": payload = json.loads(line.removeprefix("data: ")) if payload.get("generation_id") == generation_id: print(payload) break ``` ## Fetch model details The [models endpoint](/inference-api/reference/models/overview) returns the full model object, including its `json_request_schema`. ```bash theme={null} curl -H "Authorization: Bearer $OXEN_API_KEY" https://hub.oxen.ai/api/ai/models/wan-v2-7-image-to-video ``` ## Request parameters ### Required parameters | Field | Type | Default | Description | | ------------- | -------- | ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | | `prompt` | `string` | `"The camera slowly zooms in while the subject comes to life, cinematic lighting."` | Text prompt describing the desired video. Max 5000 characters. | | `input_image` | `string` | `"https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/ox_zoom_out_1926_1076.png"` | URL of the first frame image. Formats: JPEG, JPG, PNG, BMP, WEBP. Max 20 MB. Format: uri. | ### Optional parameters | Field | Type | Default | Description | | ----------------- | --------- | --------- | ------------------------------------------------------------------------------------------------------------------- | | `end_image_url` | `string` | — | URL of the last frame image for first-and-last-frame-to-video. Same format constraints as input image. Format: uri. | | `resolution` | `string` | `"1080p"` | Output video resolution tier. One of: 720p, 1080p. | | `duration` | `integer` | `5` | Output video duration in seconds (2-15). Range: 2 – 15. | | `negative_prompt` | `string` | — | Content to avoid in the video. Max 500 characters. | | `audio_url` | `string` | — | URL of driving audio. Supports WAV and MP3. Duration: 2-30s. Max 15 MB. Format: uri. | | `seed` | `integer` | — | Random seed for reproducibility (0-2147483647). |