> ## Documentation Index > Fetch the complete documentation index at: https://docs.oxen.ai/llms.txt > Use this file to discover all available pages before exploring further. # Kling 4.0 - Reference to Video > Multi-reference video generation and editing > [card] [Try Kling 4.0 - Reference to Video in the Workbench](https://www.oxen.ai/ai/workbench?model=kling-video-v4-0-reference-to-video) > > Run this model interactively, tune parameters, and compare outputs. **Model ID:** `kling-video-v4-0-reference-to-video` Kling 4.0 generates and edits video guided by up to 15 references: images, videos, and consistent character or object elements, with native audio in single takes of 3 to 30 seconds at 720p or 1080p. It keeps faces, outfits, and products consistent with the references while following the motion and camera of a reference video. Add a video to edit and describe what to change and what to keep: swap an object, restyle a scene, or rewrite a line of dialogue, and the edit runs at the source video's length by default. Refer to inputs in the prompt as @image\_1, @video\_1, and @element\_1, and say how each should be used, such as "keep the face and outfit from @image\_1" or "follow the dance moves in @video\_2 but not its background". ## Example request > [!TIP] > > Use the [Workbench](https://www.oxen.ai/ai/workbench?model=kling-video-v4-0-reference-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. > [tab] Sync > > 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](https://docs.oxen.ai/inference-api/reference/video_generation.md) for more details. > > > [tab] Minimal > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "" > > }' > > ``` > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "" > > }, > > ) > > response.raise_for_status() > > print(response.json()) > > ``` > > > [tab] Basic parameters > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > }, > > ) > > response.raise_for_status() > > print(response.json()) > > ``` > > > [tab] All parameters > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "aspect_ratio": "adaptive", > > "resolution": "1080p", > > "duration": "auto" > > }' > > ``` > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "aspect_ratio": "adaptive", > > "resolution": "1080p", > > "duration": "auto" > > }, > > ) > > response.raise_for_status() > > print(response.json()) > > ``` > [tab] Async > > See the [async queue reference](https://docs.oxen.ai/inference-api/reference/async_queue.md) for more details. > > > [tab] Minimal > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "" > > }' | jq -r '.generations[0].generation_id') > > > > # Poll until the generation reaches a terminal status. > > while true; do > > STATUS=$(curl -s -H "Authorization: Bearer $OXEN_API_KEY" \ > > "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq -r '.status') > > echo "Status: $STATUS" > > case $STATUS in succeeded|failed|cancelled) break;; esac > > sleep 5 > > done > > > > # Print the result. > > curl -s -H "Authorization: Bearer $OXEN_API_KEY" \ > > "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq . > > ``` > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "" > > }, > > ) > > enqueue.raise_for_status() > > generation_id = enqueue.json()["generations"][0]["generation_id"] > > > > while True: > > data = requests.get( > > f"https://hub.oxen.ai/api/ai/queue/{generation_id}", > > headers=HEADERS, > > ).json() > > if data["status"] in {"succeeded", "failed", "cancelled"}: > > break > > time.sleep(5) > > > > if data["status"] == "succeeded": > > print(f"Result: {data['result_url']}") > > else: > > print(f"Generation {data['status']}: {data.get('error_message')}") > > ``` > > > [tab] Basic parameters > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > }' | jq -r '.generations[0].generation_id') > > > > # Poll until the generation reaches a terminal status. > > while true; do > > STATUS=$(curl -s -H "Authorization: Bearer $OXEN_API_KEY" \ > > "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq -r '.status') > > echo "Status: $STATUS" > > case $STATUS in succeeded|failed|cancelled) break;; esac > > sleep 5 > > done > > > > # Print the result. > > curl -s -H "Authorization: Bearer $OXEN_API_KEY" \ > > "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq . > > ``` > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_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: > > data = requests.get( > > f"https://hub.oxen.ai/api/ai/queue/{generation_id}", > > headers=HEADERS, > > ).json() > > if data["status"] in {"succeeded", "failed", "cancelled"}: > > break > > time.sleep(5) > > > > if data["status"] == "succeeded": > > print(f"Result: {data['result_url']}") > > else: > > print(f"Generation {data['status']}: {data.get('error_message')}") > > ``` > > > [tab] All parameters > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "aspect_ratio": "adaptive", > > "resolution": "1080p", > > "duration": "auto" > > }' | jq -r '.generations[0].generation_id') > > > > # Poll until the generation reaches a terminal status. > > while true; do > > STATUS=$(curl -s -H "Authorization: Bearer $OXEN_API_KEY" \ > > "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq -r '.status') > > echo "Status: $STATUS" > > case $STATUS in succeeded|failed|cancelled) break;; esac > > sleep 5 > > done > > > > # Print the result. > > curl -s -H "Authorization: Bearer $OXEN_API_KEY" \ > > "https://hub.oxen.ai/api/ai/queue/$GEN_ID" | jq . > > ``` > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "aspect_ratio": "adaptive", > > "resolution": "1080p", > > "duration": "auto" > > }, > > ) > > enqueue.raise_for_status() > > generation_id = enqueue.json()["generations"][0]["generation_id"] > > > > while True: > > data = requests.get( > > f"https://hub.oxen.ai/api/ai/queue/{generation_id}", > > headers=HEADERS, > > ).json() > > if data["status"] in {"succeeded", "failed", "cancelled"}: > > break > > time.sleep(5) > > > > if data["status"] == "succeeded": > > print(f"Result: {data['result_url']}") > > else: > > print(f"Generation {data['status']}: {data.get('error_message')}") > > ``` > [tab] Async with SSE > > See the [async queue reference](https://docs.oxen.ai/inference-api/reference/async_queue.md) for more details. > > > [tab] Minimal > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "" > > }' | 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": "kling-video-v4-0-reference-to-video", > > "prompt": "" > > }, > > ) > > 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 > > ``` > > > [tab] Basic parameters > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_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 > > ``` > > > [tab] All parameters > > > > ```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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "aspect_ratio": "adaptive", > > "resolution": "1080p", > > "duration": "auto" > > }' | 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": "kling-video-v4-0-reference-to-video", > > "prompt": "", > > "input_images": [ > > "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" > > ], > > "input_video": "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4", > > "input_videos": [ > > "https://hub.oxen.ai/api/repos/ox/Oxen-AI-Assets/file/main/images/winter_summer_ox.mp4" > > ], > > "elements": [ > > {} > > ], > > "input_image": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "tail_image_url": "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png", > > "aspect_ratio": "adaptive", > > "resolution": "1080p", > > "duration": "auto" > > }, > > ) > > 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](https://docs.oxen.ai/inference-api/reference/models/overview.md) 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/kling-video-v4-0-reference-to-video ``` ## Request parameters ### Required parameters | Field | Type | Default | Description | | - | - | - | - | | `prompt` | `string` | — | Describe what to generate or change, and how to use each reference: @image\_1, @video\_1, @element\_1, and so on. | ### Optional parameters | Field | Type | Default | Description | | - | - | - | - | | `input_images` | `array` | — | Reference images for characters, objects, scenes, or style. Up to 10 images in total, including first and last frames. | | `input_video` | `string` | — | Video to edit. Describe what to change and what to keep. Format: uri. | | `input_videos` | `array` | — | Videos whose motion, camera, or style guide the output. Up to 5 videos including the video to edit. | | `elements` | `array` | — | Characters or objects to keep consistent, each from a front view plus other angles. Up to 7 elements. | | `input_image` | `string` | — | Optional image the video starts on. Format: uri. | | `tail_image_url` | `string` | — | Optional image the video ends on. Format: uri. | | `aspect_ratio` | `string` | `"adaptive"` | Aspect Ratio One of: adaptive, 16:9, 9:16, 1:1, 21:9. | | `resolution` | `string` | `"1080p"` | Resolution One of: 720p, 1080p. | | `duration` | `['integer', 'string']` | `"auto"` | Duration Range: 3 – 30. | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.