Merge branch 'main' of https://github.com/aimlapi/api-docs

Author: techpro-aimlapi

docs/api-references/image-models/topaz-labs/sharpen-generative.md

@@ -115,5 +115,5 @@ main();
 
 </details>
 
-<table data-full-width="false"><thead><tr><th width="372.73321533203125" valign="top">Blurred Image</th><th valign="top">Deblurred Image</th></tr></thead><tbody><tr><td valign="top"><div><figure><img src="../../../.gitbook/assets/blurred-face.jpeg" alt=""><figcaption></figcaption></figure></div></td><td valign="top"><div><figure><img src="../../../.gitbook/assets/5cff080e-5d24-4fc3-85f5-0e57621ead7d.jpeg" alt=""><figcaption><p>"mode": "Super Focus V2"<br>"strength": 0.6</p></figcaption></figure></div></td></tr></tbody></table>
+<table data-full-width="true"><thead><tr><th valign="top">Blurred Image</th><th valign="top">Deblurred Image</th><th></th></tr></thead><tbody><tr><td valign="top"><div><figure><img src="../../../.gitbook/assets/blurred-face.jpeg" alt=""><figcaption></figcaption></figure></div></td><td valign="top"><div><figure><img src="../../../.gitbook/assets/5cff080e-5d24-4fc3-85f5-0e57621ead7d.jpeg" alt=""><figcaption><p>"mode": "Super Focus V2"<br>"strength": 0.6</p></figcaption></figure></div></td><td></td></tr></tbody></table>
 

docs/api-references/image-models/topaz-labs/sharpen.md

@@ -30,7 +30,7 @@ If you don’t have an API key for the AI/ML API yet, feel free to use our [Quic
 
 ## Quick Example
 
-Let's sharpen a relatively strongly blurred image using the _Strong_ mode while adjusting the _strength_ parameter.
+Let's sharpen a relatively strongly blurred image using the `Strong` mode while adjusting the `strength` parameter.
 
 {% tabs %}
 {% tab title="Python" %}
@@ -117,7 +117,7 @@ main();
 
 </details>
 
-<table data-full-width="false"><thead><tr><th width="372.73321533203125" valign="top">Blurred Image</th><th valign="top">Deblurred Image</th></tr></thead><tbody><tr><td valign="top"><div><figure><img src="../../../.gitbook/assets/blurred-landscape.png" alt=""><figcaption></figcaption></figure></div></td><td valign="top"><div><figure><img src="../../../.gitbook/assets/sharpen_strength_0.9.png" alt=""><figcaption><p>"mode": "Strong"<br>"strength": 0.9</p></figcaption></figure></div></td></tr></tbody></table>
+<table data-full-width="true"><thead><tr><th valign="top">Blurred Image</th><th valign="top">Deblurred Image</th><th></th></tr></thead><tbody><tr><td valign="top"><div><figure><img src="../../../.gitbook/assets/blurred-landscape.png" alt=""><figcaption></figcaption></figure></div></td><td valign="top"><div><figure><img src="../../../.gitbook/assets/sharpen_strength_0.9.png" alt=""><figcaption><p>"mode": "Strong"<br>"strength": 0.9</p></figcaption></figure></div></td><td></td></tr></tbody></table>
 
 For clarity, we’ve created a split image showing the results of different parameter settings.
 

docs/api-references/model-database.md

@@ -1,8 +1,3 @@
----
-hidden: true
-noIndex: true
----
-
 # krea-wan-14b/text-to-video
 
 {% columns %}
@@ -19,7 +14,7 @@ This documentation is valid for the following list of our models:
 {% endcolumn %}
 {% endcolumns %}
 
-
+A 14-billion parameter model for text-to-video generation.
 
 ## Setup your API Key
 
@@ -56,16 +51,15 @@ api_key = "<YOUR_AIMLAPI_KEY>"
 
 # Creating and sending a video generation task to the server
 def generate_video():
-    url = "https://api.aimlapi.com/v2/generate/video/pixverse/generation"
+    url = "https://api.aimlapi.com/v2/video/generations"
     headers = {
         "Authorization": f"Bearer {api_key}", 
     }
 
     data = {
         "model": "krea/krea-wan-14b/text-to-video",
         "prompt": "A menacing evil dragon appears in a distance above the tallest mountain, then rushes toward the camera with its jaws open, revealing massive fangs. We see it's coming.",
-        "resolution": "1080p",
-        "duration": 5
+        "num_frames": 90 
     }
 
     response = requests.post(url, json=data, headers=headers)
@@ -79,7 +73,7 @@ def generate_video():
 
 # Requesting the result of the task from the server using the generation_id
 def get_video(gen_id):
-    url = "https://api.aimlapi.com/v2/generate/video/pixverse/generation"
+    url = "https://api.aimlapi.com/v2/video/generations"
     params = {
         "generation_id": gen_id,
     }
@@ -147,7 +141,7 @@ function generateVideo(callback) {
         prompt: `
 A menacing evil dragon appears in a distance above the tallest mountain, then rushes toward the camera with its jaws open, revealing massive fangs. We see it's coming.
 `,
-        // duration: 5,
+        num_frames: 90,
     });
 
     const url = new URL(`${baseUrl}/video/generations`);
@@ -268,14 +262,22 @@ main();
 
 {% code overflow="wrap" %}
 ```json5
+{'id': '67b69e0c-922f-4eae-9b90-8c4605131d3b:krea/krea-wan-14b/text-to-video', 'status': 'queued', 'meta': {'usage': {'tokens_used': 315000}}}
+Generation ID:   67b69e0c-922f-4eae-9b90-8c4605131d3b:krea/krea-wan-14b/text-to-video
+Status: queued
+Still waiting... Checking again in 10 seconds.
+Status: completed
+Processing complete:/n {'id': '67b69e0c-922f-4eae-9b90-8c4605131d3b:krea/krea-wan-14b/text-to-video', 'status': 'completed', 'video': {'url': 'https://cdn.aimlapi.com/flamingo/files/b/zebra/GR3ehIPWwREVvJduWH6Pn_R07gifMb.mp4'}}
 ```
 {% endcode %}
 
 </details>
 
-**Processing time**: \~2 min 28 sec.
+**Processing time**:  11.6 sec.
+
+**Generated Video** (832x480, without sound):
 
-**Generated Video** (768x512, without sound):
+{% embed url="https://drive.google.com/file/d/1lgAtCN0R_QTHStjbU4jFmggeFRd0PK-A/view" %}
 
 ## API Schemas
 
@@ -284,6 +286,10 @@ main();
 You can generate a video using this API. In the basic setup, you only need a prompt. \
 This endpoint creates and sends a video generation task to the server — and returns a generation ID.
 
+Note that in this model, the video duration is defined by the number of frames, not seconds. You can calculate the duration in seconds based on the frame rate of 16 frames per second.
+
+
+
 {% openapi-operation spec="krea-wan-14b-text-to-video" path="/v2/video/generations" method="post" %}
 [OpenAPI krea-wan-14b-text-to-video](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/video-models/Krea/krea-wan-14b-text-to-video.json)
 {% endopenapi-operation %}

docs/api-references/video-models/README.md

@@ -1,8 +1,3 @@
----
-hidden: true
-noIndex: true
----
-
 # krea-wan-14b/video-to-video
 
 {% columns %}
@@ -19,7 +14,7 @@ This documentation is valid for the following list of our models:
 {% endcolumn %}
 {% endcolumns %}
 
-
+A 14-billion parameter model for video edition.
 
 ## Setup your API Key
 
@@ -56,16 +51,18 @@ api_key = "<YOUR_AIMLAPI_KEY>"
 
 # Creating and sending a video generation task to the server
 def generate_video():
-    url = "https://api.aimlapi.com/v2/generate/video/pixverse/generation"
+    url = "https://api.aimlapi.com/v2/video/generations"
     headers = {
         "Authorization": f"Bearer {api_key}", 
     }
 
     data = {
-        "model": "krea/krea-wan-14b/text-to-video",
-        "prompt": "A menacing evil dragon appears in a distance above the tallest mountain, then rushes toward the camera with its jaws open, revealing massive fangs. We see it's coming.",
-        "resolution": "1080p",
-        "duration": 5
+        "model": "krea/krea-wan-14b/video-to-video",
+        "video_url":"https://zovi0.github.io/public_misc/kling-v2-master-t2v-racoon.mp4",
+        "prompt":'''
+            Add a small fairy as a rider on the raccoon’s back. She must have a black-and-golden face and a cloak in the colors of a dark emerald tropical butterfly with bright blue shimmering spots.
+        ''',
+        "strength": 0.55,
     }
 
     response = requests.post(url, json=data, headers=headers)
@@ -79,7 +76,7 @@ def generate_video():
 
 # Requesting the result of the task from the server using the generation_id
 def get_video(gen_id):
-    url = "https://api.aimlapi.com/v2/generate/video/pixverse/generation"
+    url = "https://api.aimlapi.com/v2/video/generations"
     params = {
         "generation_id": gen_id,
     }
@@ -143,11 +140,12 @@ const { URL } = require("url");
 // Creating and sending a video generation task to the server
 function generateVideo(callback) {
     const data = JSON.stringify({
-        model: "krea/krea-wan-14b/text-to-video",
+        model: "krea/krea-wan-14b/video-to-video",
         prompt: `
-A menacing evil dragon appears in a distance above the tallest mountain, then rushes toward the camera with its jaws open, revealing massive fangs. We see it's coming.
+Add a small fairy as a rider on the raccoon’s back. She must have a black-and-golden face and a cloak in the colors of a dark emerald tropical butterfly with bright blue shimmering spots.
 `,
-        // duration: 5,
+        video_url:'https://zovi0.github.io/public_misc/kling-v2-master-t2v-racoon.mp4',
+        strength: 0.55
     });
 
     const url = new URL(`${baseUrl}/video/generations`);
@@ -268,16 +266,22 @@ main();
 
 {% code overflow="wrap" %}
 ```json5
+{'id': '3637be63-2db8-4ecc-bc0f-00afbdf10a55:krea/krea-wan-14b/video-to-video', 'status': 'queued', 'meta': {'usage': {'tokens_used': 315000}}}
+Generation ID:   3637be63-2db8-4ecc-bc0f-00afbdf10a55:krea/krea-wan-14b/video-to-video
+Status: generating
+Still waiting... Checking again in 10 seconds.
+Status: completed
+Processing complete:/n {'id': '3637be63-2db8-4ecc-bc0f-00afbdf10a55:krea/krea-wan-14b/video-to-video', 'status': 'completed', 'video': {'url': 'https://cdn.aimlapi.com/flamingo/files/b/panda/W9bYaX0QBdz6mzlOcKVRo_mF899FFI.mp4'}}
 ```
 {% endcode %}
 
 </details>
 
-**Processing time**: \~2 min 28 sec.
-
-**Generated Video** (768x512, without sound):
+**Processing time**: 11.4 sec.
 
+**Generated Video** (832x480, without sound):
 
+{% embed url="https://drive.google.com/file/d/1Npu3ROPtLTf2CY07jRwZMCNGunxaBEAU/view?usp=sharing" %}
 
 ## API Schemas
 

docs/api-references/video-models/krea/krea-wan-14b-text-to-video.md

@@ -6,10 +6,16 @@ export default {
     minimax: {
       desc: `Lyrics with optional formatting. You can use a newline to separate each line of lyrics. You can use two newlines to add a pause between lines. You can use double hash marks (##) at the beginning and end of the lyrics to add accompaniment. Maximum 600 characters.`,
     },
+    minimax15: {
+      desc: `A description of the music, specifying style, mood, and scenario. Length: 10–300 characters.`,
+    },
     elevenlabs: {
       desc: `A text description that can define the genre, mood, instruments, vocals, tempo, structure, and even lyrics of the track. It can be high-level (“peaceful meditation with voiceover”) or detailed (“solo piano in C minor, 90 BPM, raw and emotional”). Use keywords to control genre, emotional tone, vocals (e.g., a cappella, two singers harmonizing), structure (e.g., “lyrics begin at 15 seconds”), or provide custom lyrics directly in the prompt.`,
     },
   },
+  lyrics: {
+    desc: `Lyrics of the song. Use (\n) to separate lines. You may add structure tags like [Intro], [Verse], [Chorus], [Bridge], [Outro] to enhance the arrangement. Length: 10–3000 characters.`,
+  },
   reference_audio_url: {
     desc: `Reference song, should contain music and vocals. Must be a .wav or .mp3 file longer than 15 seconds.`,
   },
@@ -67,4 +73,9 @@ export default {
       desc: `The length of the song to generate in milliseconds. This parameter may not always be respected by the model, and the actual audio length can differ.`,
     },
   },
+  output_format: {
+    minimax: {
+      desc: `The output format of the audio. Options: url or hex.`,
+    },
+  },
 };

docs/api-references/video-models/krea/krea-wan-14b-video-to-video.md

@@ -13,14 +13,12 @@ export default {
       desc: `For hug, kiss, and heart_gesture effects, pass an array containing exactly two image URLs. For squish or expansion, only one image URL is required.`,
     },
     minimax: {
-      desc: `The model will use the image passed in this parameter as the first frame to generate a video. 
-      Supported formats: 
-      - URL of the image;
-      - base64 encoding of the image.
-      Image specifications:
-      - format must be JPG, JPEG, or PNG;
-      - aspect ratio should be greater than 2:5 and less than 5:2; the shorter side must exceed 300 pixels;
-      - file size must not exceed 20MB.`,
+      desc: `A direct link to an online image or a Base64-encoded local image that will serve as the first frame for the video.
+Image specifications: 
+- format must be JPG, JPEG, or PNG; 
+- aspect ratio should be greater than 2:5 and less than 5:2; 
+- the shorter side must exceed 300 pixels; 
+- file size must not exceed 20MB.`,
     },
     google: {
       desc: `URL of the input image to animate. Should be 720p or higher resolution.`,

packages/openapi/descriptions/audio.js

@@ -0,0 +1,8 @@
+{
+  "title": "Generate an audio",
+  "docs": "https://docs.aimlapi.com/api-references/music-models/minimax/music-15",
+  "payload": {
+    "baseUrl": "https://api.aimlapi.com/v2",
+    "apiKey": "<YOUR_API_KEY>"
+  }
+}

packages/openapi/descriptions/video.js

@@ -0,0 +1,18 @@
+const main = async () => {
+  const response = await fetch('{{baseUrl}}/generate/audio', {
+    method: 'POST',
+    headers: {
+      Authorization: 'Bearer {{apiKey}}',
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify({
+      model: '{{model}}',
+      prompt: 'A calm and soothing instrumental music with gentle piano and soft strings.',
+      lyrics: `[Verse]\nStreetlights flicker, the night breeze sighs\nShadows stretch as I walk alone\nAn old coat wraps my silent sorrow\nWandering, longing, where should I go\n[Chorus]\nPushing the wooden door, the aroma spreads\nIn a familiar corner, a stranger gazes back\nWarm lights flicker, memories awaken\nIn this small cafe, I find my way\n[Verse]\nRaindrops tap on the windowpane\nA melody plays, soft and low\nThe clink of cups, the murmur of dreams\nIn this haven, I find my home\n[Chorus]\nPushing the wooden door, the aroma spreads\nIn a familiar corner, a stranger gazes back\nWarm lights flicker, memories awaken\nIn this small cafe, I find my way`,
+    }),
+  }).then((res) => res.json());
+
+  console.log('Generation:', response);
+};
+
+main()