# v2-master/image-to-video {% columns %} {% column width="66.66666666666666%" %} {% hint style="info" %} This documentation is valid for the following list of our models: * `klingai/v2-master-image-to-video` {% endhint %} {% endcolumn %} {% column width="33.33333333333334%" %} Try in Playground {% endcolumn %} {% endcolumns %} Compared to [v1.6](https://docs.aimlapi.com/api-references/video-models/kling-ai/v1.6-pro-image-to-video), this Kling model better aligns with the prompt and delivers more dynamic and visually appealing results. ## Setup your API Key If you don’t have an API key for the AI/ML API yet, feel free to use our [Quickstart guide](https://docs.aimlapi.com/quickstart/setting-up). ## How to Make a Call
Step-by-Step Instructions Generating a video using this model involves sequentially calling two endpoints: * The first one is for creating and sending a video generation task to the server (returns a generation ID). * The second one is for requesting the generated video from the server using the generation ID received from the first endpoint. Below, you can find both corresponding API schemas.
## API Schemas {% hint style="success" %} Now, all of our API schemas for video models use our new universal short URL — `https://api.aimlapi.com/v2/video/generations`.\ However, you can still call this model using the legacy URL that includes the vendor name. {% endhint %} ### Create a video generation task and send it to the server ## POST /v2/video/generations > ```json {"openapi":"3.0.0","info":{"title":"AIML API","version":"1.0.0"},"servers":[{"url":"https://api.aimlapi.com"}],"paths":{"/v2/video/generations":{"post":{"operationId":"_v2_video_generations","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"model":{"type":"string","enum":["klingai/v2-master-image-to-video"]},"image_url":{"type":"string","format":"uri","description":"A direct link to an online image or a Base64-encoded local image that will serve as the visual base or the first frame for the video."},"prompt":{"type":"string","description":"The text description of the scene, subject, or action to generate in the video."},"duration":{"type":"integer","description":"The length of the output video in seconds.","enum":[5,10],"default":"5"},"negative_prompt":{"type":"string","description":"The description of elements to avoid in the generated video."},"cfg_scale":{"type":"number","minimum":0,"maximum":1,"description":"The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt."},"static_mask":{"type":"string","format":"uri","description":"URL of the image for Static Brush Application Area (Mask image created by users using the motion brush)."},"dynamic_masks":{"type":"array","items":{"type":"object","properties":{"mask":{"type":"string"},"trajectories":{"type":"array","items":{"type":"object","properties":{"x":{"type":"integer"},"y":{"type":"integer"}},"required":["x","y"]},"minItems":2,"maxItems":77}},"required":["mask","trajectories"]},"maxItems":6,"description":"List of dynamic masks."},"camera_control":{"type":"object","properties":{"type":{"type":"string","enum":["simple","down_back","forward_up","right_turn_forward","left_turn_forward"]},"config":{"type":"object","properties":{"horizontal":{"type":"number","minimum":-10,"maximum":10},"vertical":{"type":"number","minimum":-10,"maximum":10},"pan":{"type":"number","minimum":-10,"maximum":10},"tilt":{"type":"number","minimum":-10,"maximum":10},"roll":{"type":"number","minimum":-10,"maximum":10},"zoom":{"type":"number","minimum":-10,"maximum":10}}}},"description":"Camera control parameters."}},"required":["model","image_url"],"title":"klingai/v2-master-image-to-video"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the generated video."},"status":{"type":"string","enum":["queued","generating","completed","error"],"description":"The current status of the generation task."},"video":{"type":"object","nullable":true,"properties":{"url":{"type":"string","format":"uri","description":"The URL where the file can be downloaded from."}},"required":["url"]},"error":{"type":"object","nullable":true,"properties":{"name":{"type":"string"},"message":{"type":"string"}},"required":["name","message"],"description":"Description of the error, if any."},"meta":{"type":"object","nullable":true,"properties":{"usage":{"type":"object","nullable":true,"properties":{"credits_used":{"type":"number","description":"The number of tokens consumed during generation."}},"required":["credits_used"]}},"description":"Additional details about the generation."}},"required":["id","status"]}}}}}}}}} ``` ### Retrieve the generated video from the server After sending a request for video generation, this task is added to the queue. This endpoint lets you check the status of a video generation task using its `id`, obtained from the endpoint described above.\ If the video generation task status is `completed`, the response will include the final result — with the generated video URL and additional metadata. ## GET /v2/video/generations > ```json {"openapi":"3.0.0","info":{"title":"AIML API","version":"1.0.0"},"servers":[{"url":"https://api.aimlapi.com"}],"security":[{"access-token":[]}],"components":{"securitySchemes":{"access-token":{"scheme":"bearer","bearerFormat":"","type":"http","description":"Bearer key","in":"header"}}},"paths":{"/v2/video/generations":{"get":{"operationId":"_v2_video_generations","parameters":[{"name":"generation_id","required":true,"in":"query","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the generated video."},"status":{"type":"string","enum":["queued","generating","completed","error"],"description":"The current status of the generation task."},"video":{"type":"object","nullable":true,"properties":{"url":{"type":"string","format":"uri","description":"The URL where the file can be downloaded from."}},"required":["url"]},"error":{"type":"object","nullable":true,"properties":{"name":{"type":"string"},"message":{"type":"string"}},"required":["name","message"],"description":"Description of the error, if any."},"meta":{"type":"object","nullable":true,"properties":{"usage":{"type":"object","nullable":true,"properties":{"credits_used":{"type":"number","description":"The number of tokens consumed during generation."}},"required":["credits_used"]}},"description":"Additional details about the generation."}},"required":["id","status"]}}}}}}}}} ``` ## Code Example The code below creates a video generation task, then automatically polls the server every **10** seconds until it finally receives the video URL. {% hint style="info" %} This model produces highly detailed and natural-looking videos, so generation may take around 5–6 minutes for a 5-second video and 11-14 minutes for a 10-second video. {% endhint %} {% tabs %} {% tab title="Python" %} {% code overflow="wrap" %} ```python import requests import time base_url = "https://api.aimlapi.com/v2" api_key = "" # Creating and sending a video generation task to the server def generate_video(): url = f"{base_url}/generate/video/kling/generation" headers = { "Authorization": f"Bearer {api_key}", } data = { "model": "klingai/v2-master-image-to-video", "prompt": "Mona Lisa puts on glasses with her hands.", "image_url": "https://s2-111386.kwimgs.com/bs2/mmu-aiplatform-temp/kling/20240620/1.jpeg", "duration": "5", } response = requests.post(url, json=data, headers=headers) if response.status_code >= 400: print(f"Error: {response.status_code} - {response.text}") else: response_data = response.json() return response_data # Requesting the result of the task from the server using the generation_id def get_video(gen_id): url = f"{base_url}/generate/video/kling/generation" params = { "generation_id": gen_id, } # Insert your AIML API Key instead of : headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" } response = requests.get(url, params=params, headers=headers) # print("Generation:", response.json()) return response.json() def main(): # Running video generation and getting a task id gen_response = generate_video() gen_id = gen_response.get("id") print("Gen_ID: ", gen_id) # Trying to retrieve the video from the server every 15 sec if gen_id: start_time = time.time() timeout = 1000 while time.time() - start_time < timeout: response_data = get_video(gen_id) if response_data is None: print("Error: No response from API") break status = response_data.get("status") if status in ["queued", "generating"]: print(f"Status: {status}. Checking again in 15 seconds.") time.sleep(15) else: print("Processing complete:\n", response_data) return response_data print("Timeout reached. Stopping.") return None if __name__ == "__main__": main() ``` {% endcode %} {% endtab %} {% endtabs %}
Response {% code overflow="wrap" %} ```json5 Gen_ID: 88a64d31-cce4-41e8-b9d8-5392e8c2a6d4:kling-video/v2/master/image-to-video Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: generating Still waiting... Checking again in 10 seconds. Status: completed Processing complete:\n {'id': '88a64d31-cce4-41e8-b9d8-5392e8c2a6d4:kling-video/v2/master/image-to-video', 'status': 'completed', 'video': {'url': 'https://cdn.aimlapi.com/eagle/files/kangaroo/iKWC3BJOdav7Cy8cWSO9k_output.mp4', 'content_type': 'video/mp4', 'file_name': 'output.mp4', 'file_size': 5150376}} ``` {% endcode %}
Generated Video **Original**: [784x1172](https://drive.google.com/file/d/1CtkWU6zvsTZj5O82dWnp42tcfRWSDWyH/view?usp=sharing) **Low-res GIF preview**:

"prompt": "Mona Lisa puts on glasses with her hands."