GITBOOK-394: docs: move examples up for klings

Author: techpro-aimlapi

docs/.gitbook/assets/image (14).png

@@ -6,8 +6,6 @@ This documentation is valid for the following list of our models:
 * `kling-video/v1/pro/image-to-video`
 {% endhint %}
 
-## Model Overview
-
 This model transforms static images into dynamic video clips. Offers more advanced camera controls than v1 Standard model, including options for tilt, pan, zoom, and roll movements. Results in richer details and more stable camera movements, enhancing the overall visual quality of the generated videos. Produces significantly sharper and more detailed videos. Enhanced animations make elements like water flow and character movements appear more natural and engaging.
 
 ## Setup your API Key

docs/api-references/video-models/Kling-AI/v1-pro-image-to-video.md

@@ -6,9 +6,7 @@ This documentation is valid for the following list of our models:
 * `kling-video/v1/pro/text-to-video`
 {% endhint %}
 
-## Model Overview
-
-This model converts textual descriptions into high-quality video content. Provides advanced camera control options, including more sophisticated movements and stabilization. Maximum Video Length: 10 s.
+This model converts textual descriptions into high-quality video content. Provides advanced camera control options, including more sophisticated movements and stabilization. 
 
 ## Setup your API Key
 

docs/api-references/video-models/Kling-AI/v1-pro-text-to-video.md

@@ -6,8 +6,6 @@ This documentation is valid for the following list of our models:
 * `kling-video/v1/standard/image-to-video`
 {% endhint %}
 
-## Model Overview
-
 A model transforms static images into dynamic video clips.
 
 ## Setup your API Key
@@ -29,26 +27,6 @@ Below, you can find both corresponding API schemas.
 
 </details>
 
-## API Schemas
-
-### Create a video generation task and send it to the server
-
-{% hint style="warning" %}
-The `ratio` and `aspect_ratio` parameters are deprecated. The aspect ratio of the generated video is solely determined by the aspect ratio of the input reference image.
-{% endhint %}
-
-{% openapi src="v1-standard-image-to-video.json" path="/v2/generate/video/kling/generation" method="post" %}
-[v1-standard-image-to-video.json](v1-standard-image-to-video.json)
-{% endopenapi %}
-
-### Retrieve the generated video from the server
-
-After sending a request for video generation, this task is added to the queue. Based on the service's load, the generation can be completed in seconds or take a bit more. &#x20;
-
-{% openapi src="v1-standard-image-to-video-pair.json" path="/v2/generate/video/kling/generation" method="get" %}
-[v1-standard-image-to-video-pair.json](v1-standard-image-to-video-pair.json)
-{% endopenapi %}
-
 ## Full Example: Generating and Retrieving the Video From the Server
 
 We have a classic [reproduction](https://s2-111386.kwimgs.com/bs2/mmu-aiplatform-temp/kling/20240620/1.jpeg) of the famous da Vinci painting. Let's ask the model to generate a video where the Mona Lisa puts on glasses.
@@ -355,3 +333,23 @@ Processing complete:/n {'id': '0ebebc75-7c09-404b-ac36-345ef346a0ac:kling-video/
 <figure><img src="../../../.gitbook/assets/kling-video-v1-standard-image-to-video_preview.gif" alt=""><figcaption></figcaption></figure>
 
 </details>
+
+## API Schemas
+
+### Create a video generation task and send it to the server
+
+{% hint style="warning" %}
+The `ratio` and `aspect_ratio` parameters are deprecated. The aspect ratio of the generated video is solely determined by the aspect ratio of the input reference image.
+{% endhint %}
+
+{% openapi src="v1-standard-image-to-video.json" path="/v2/generate/video/kling/generation" method="post" %}
+[v1-standard-image-to-video.json](v1-standard-image-to-video.json)
+{% endopenapi %}
+
+### Retrieve the generated video from the server
+
+After sending a request for video generation, this task is added to the queue. Based on the service's load, the generation can be completed in seconds or take a bit more. &#x20;
+
+{% openapi src="v1-standard-image-to-video-pair.json" path="/v2/generate/video/kling/generation" method="get" %}
+[v1-standard-image-to-video-pair.json](v1-standard-image-to-video-pair.json)
+{% endopenapi %}

docs/api-references/video-models/Kling-AI/v1-standard-image-to-video.md

@@ -6,8 +6,6 @@ This documentation is valid for the following list of our models:
 * `kling-video/v1/standard/text-to-video`
 {% endhint %}
 
-## Model Overview
-
 This model converts textual descriptions into high-quality video content. Maximum Video Length: 5 s.
 
 ## Setup your API Key

docs/api-references/video-models/Kling-AI/v1-standard-text-to-video.md

@@ -6,8 +6,6 @@ This documentation is valid for the following list of our models:
 * `kling-video/v1.6/pro/image-to-video`
 {% endhint %}
 
-## Model Overview
-
 An advanced AI video generation model, designed to create high-quality videos from image. This version introduces significant improvements in visual quality and dynamic action rendering, enabling users to generate more consistent and visually appealing results compared to its predecessor, Kling 1.5. Incorporates natural camera movements and transitions for more cinematic outputs.
 
 ## Setup your API Key

docs/api-references/video-models/Kling-AI/v1.6-pro-image-to-video.md

@@ -6,8 +6,6 @@ This documentation is valid for the following list of our models:
 * `kling-video/v1.6/standard/text-to-video`
 {% endhint %}
 
-## Model Overview
-
 An advanced AI video generation model, designed to create high-quality videos from text prompts and images. This version introduces significant improvements in prompt adherence, visual quality, and dynamic action rendering, enabling users to generate more consistent and visually appealing results compared to its predecessor, Kling 1.5.
 
 ## Setup your API Key

docs/api-references/video-models/Kling-AI/v1.6-standard-text-to-video.md

@@ -6,8 +6,6 @@ This documentation is valid for the following list of our models:
 * `kling-video/v1.6/standard/image-to-video`
 {% endhint %}
 
-## Model Overview
-
 An advanced AI video generation model developed by Kuaishou Technology, designed to create high-quality videos from text prompts and images. This version introduces significant improvements in prompt adherence, visual quality, and dynamic action rendering, enabling users to generate more consistent and visually appealing results compared to its predecessor, Kling 1.5.
 
 ## Setup your API Key

docs/api-references/video-models/Kling-AI/v1.6-standart-image-to-video.md

@@ -6,8 +6,6 @@ This documentation is valid for the following list of our models:
 * `klingai/kling-video-v1.6-pro-effects`
 {% endhint %}
 
-## Model Overview
-
 A specialized video model that generates short clips based on reference images of people, applying one of several preset scenarios: two people hugging, kissing, or making a heart shape with their hands (requires **2** reference images), or a single person being humorously squished like clay or inflated like a balloon (requires **1** reference image).
 
 <details>
@@ -38,38 +36,7 @@ Processing complete:/n {'id': '50f3e8ae-3d88-482f-95ea-7faa4799f60f:kling-video/
 
 If you don’t have an API key for the AI/ML API yet, feel free to use our [Quickstart guide](../../../quickstart/setting-up.md).
 
-## How to Make a Call
-
-<details>
-
-<summary>Step-by-Step Instructions</summary>
-
-Generating a video using this model involves sequentially calling two endpoints:&#x20;
-
-* 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.&#x20;
-
-Below, you can find two corresponding API schemas and an example with both endpoint calls.
-
-</details>
-
-## API Schemas
-
-### Create a video generation task and send it to the server
-
-{% openapi-operation spec="klingai-v1-6-pro-effects" path="/v2/generate/video/kling/generation" method="post" %}
-[OpenAPI klingai-v1-6-pro-effects](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/video-models/Kling-AI/v1.6-pro-effects.json)
-{% endopenapi-operation %}
-
-### Retrieve the generated video from the server
-
-After sending a request for video generation, this task is added to the queue. Based on the service's load, the generation can be completed in seconds or take a bit more.&#x20;
-
-{% openapi-operation spec="kling-video-retrieve" path="/v2/generate/video/kling/generation" method="get" %}
-[OpenAPI kling-video-retrieve](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/video-models/Kling-AI/v1.6-pro-effects-pair.json)
-{% endopenapi-operation %}
-
-## Code Example (Python)
+## Code Example
 
 In this example, we'll try to make two people from different photos (provided via URLs) form a romantic heart shape with their hands. No prompt is required — the effect is selected by setting the appropriate value for the `effect_scene` parameter.
 
@@ -91,6 +58,8 @@ In videos featuring a single person (the `squish` and `expansion` effects), an a
 
 The code below creates a video generation task, then automatically polls the server every **10** seconds until it finally receives the video URL.
 
+{% tabs %}
+{% tab title="Python" %}
 {% code overflow="wrap" %}
 ```python
 import requests
@@ -122,7 +91,6 @@ def generate_video():
         print(f"Error: {response.status_code} - {response.text}")
     else:
         response_data = response.json()
-        #print(response_data)
         return response_data
 
 
@@ -138,17 +106,14 @@ def get_video(gen_id):
         "Authorization": f"Bearer {api_key}", 
         "Content-Type": "application/json"
         }
-
     response = requests.get(url, params=params, headers=headers)
     return response.json()
 
-
-
 def main():
-     # Running video generation and getting a task id
+    # Running video generation and getting a task id
     gen_response = generate_video()
     gen_id = gen_response.get("id")
-    print("Gen_ID:  ", gen_id)
+    print("Generation ID:  ", gen_id)
 
     # Trying to retrieve the video from the server every 10 sec
     if gen_id:
@@ -173,13 +138,14 @@ def main():
                 return response_data
 
         print("Timeout reached. Stopping.")
-        return None     
-
+        return None
 
 if __name__ == "__main__":
     main()
 ```
 {% endcode %}
+{% endtab %}
+{% endtabs %}
 
 <details>
 
@@ -226,3 +192,26 @@ Processing complete:/n {'id': '91bc5296-f0f9-4336-ab6a-60f993cbb971:kling-video/
 <figure><img src="../../../.gitbook/assets/kling-effects-heart (1).gif" alt=""><figcaption></figcaption></figure>
 
 </details>
+
+## API Schemas
+
+Generating a video using this model involves sequentially calling two endpoints:&#x20;
+
+* 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.&#x20;
+
+Below, you can find two corresponding API schemas and an example with both endpoint calls.
+
+### Create a video generation task and send it to the server
+
+{% openapi-operation spec="klingai-v1-6-pro-effects" path="/v2/generate/video/kling/generation" method="post" %}
+[OpenAPI klingai-v1-6-pro-effects](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/video-models/Kling-AI/v1.6-pro-effects.json)
+{% endopenapi-operation %}
+
+### Retrieve the generated video from the server
+
+After sending a request for video generation, this task is added to the queue. Based on the service's load, the generation can be completed in seconds or take a bit more.&#x20;
+
+{% openapi-operation spec="kling-video-retrieve" path="/v2/generate/video/kling/generation" method="get" %}
+[OpenAPI kling-video-retrieve](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/video-models/Kling-AI/v1.6-pro-effects-pair.json)
+{% endopenapi-operation %}

docs/api-references/video-models/kling-ai/v1.6-pro-effects.md

@@ -6,8 +6,6 @@ This documentation is valid for the following list of our models:
 * `kling-video/v1.6/pro/text-to-video`
 {% endhint %}
 
-## Model Overview
-
 An advanced AI video generation model, designed to create high-quality videos from text prompts and images. This version introduces significant improvements in prompt adherence, visual quality, and dynamic action rendering, enabling users to generate more consistent and visually appealing results compared to its predecessor, Kling 1.5.
 
 ## Setup your API Key