GITBOOK-944: docs: fix some slugs/urls, add redirects, change how to make a call section for llms

Author: techpro-aimlapi

docs/SUMMARY.md

@@ -121,7 +121,7 @@
   * [NVIDIA](api-references/text-models-llm/NVIDIA/README.md)
     * [llama-3.1-nemotron-70b](api-references/text-models-llm/NVIDIA/llama-3.1-nemotron-70b.md)
     * [nemotron-nano-9b-v2](api-references/text-models-llm/nvidia/nemotron-nano-9b-v2.md)
-    * [nemotron-nano-12b-v2-vl](api-references/text-models-llm/nvidia/llama-3.1-nemotron-70b-1.md)
+    * [nemotron-nano-12b-v2-vl](api-references/text-models-llm/nvidia/nemotron-nano-12b-v2-vl.md)
   * [OpenAI](api-references/text-models-llm/OpenAI/README.md)
     * [gpt-3.5-turbo](api-references/text-models-llm/OpenAI/gpt-3.5-turbo.md)
     * [gpt-4](api-references/text-models-llm/OpenAI/gpt-4.md)
@@ -231,7 +231,7 @@
     * [DALL·E 3](api-references/image-models/OpenAI/dall-e-3.md)
     * [gpt-image-1](api-references/image-models/openai/gpt-image-1.md)
     * [gpt-image-1-mini](api-references/image-models/openai/gpt-image-1-mini.md)
-    * [gpt-image-1-5](api-references/image-models/openai/gpt-image-1-mini-1.md)
+    * [gpt-image-1-5](api-references/image-models/openai/gpt-image-1-5.md)
   * [RecraftAI](api-references/image-models/RecraftAI/README.md)
     * [Recraft v3](api-references/image-models/RecraftAI/recraft-v3.md)
   * [Reve](api-references/image-models/reve/README.md)

…mage-models/openai/gpt-image-1-mini-1.md …ces/image-models/openai/gpt-image-1-5.mddocs/api-references/image-models/openai/gpt-image-1-mini-1.md renamed to docs/api-references/image-models/openai/gpt-image-1-5.md docs/api-references/image-models/openai/gpt-image-1-mini-1.md renamed to docs/api-references/image-models/openai/gpt-image-1-5.md

@@ -25,33 +25,31 @@ All three IDs listed above refer to the same model; we support them for backward
 
 DeepSeek V3 (or deepseek-chat) is an advanced conversational AI designed to deliver highly engaging and context-aware dialogues. This model excels in understanding and generating human-like text, making it an ideal solution for creating responsive and intelligent chatbots.
 
-## How to Make a Call
+{% hint style="success" %}
+[Create AI/ML API Key](https://aimlapi.com/app/keys)
+{% endhint %}
 
 <details>
 
-<summary>Step-by-Step Instructions</summary>
-
-:digit\_one: **Setup You Can’t Skip**
-
-:black\_small\_square: [**Create an Account**](https://aimlapi.com/app/sign-up): Visit the AI/ML API website and create an account (if you don’t have one yet).\
-:black\_small\_square: [**Generate an API Key**](https://aimlapi.com/app/keys): After logging in, navigate to your account dashboard and generate your API key. Ensure that key is enabled on UI.
-
-:digit\_two: **Copy the code example**
-
-At the bottom of this page, you'll find [a code example](deepseek-chat.md#code-example) that shows how to structure the request. Choose the code snippet in your preferred programming language and copy it into your development environment.
-
-:digit\_three: **Modify the code example**
+<summary>How to make the first API call</summary>
 
-:black\_small\_square: Replace `<YOUR_AIMLAPI_KEY>` with your actual AI/ML API key from your account.\
-:black\_small\_square: Insert your question or request into the `content` field—this is what the model will respond to.
+**1️⃣ Required setup (don’t skip this)**\
+▪ **Create an account:** Sign up on the AI/ML API website (if you don’t have one yet).\
+▪ **Generate an API key:** In your account dashboard, create an API key and make sure it’s **enabled** in the UI.
 
-:digit\_four: <sup><sub><mark style="background-color:yellow;">**(Optional)**<mark style="background-color:yellow;"><sub></sup>**&#x20;Adjust other optional parameters if needed**
+**2️ Copy the code example**\
+At the bottom of this page, pick the snippet for your preferred programming language (Python / Node.js) and copy it into your project.
 
-Only `model` and `messages` are required parameters for this model (and we’ve already filled them in for you in the example), but you can include optional parameters if needed to adjust the model’s behavior. Below, you can find the corresponding [API schema](deepseek-chat.md#api-schema), which lists all available parameters along with notes on how to use them.
+**3️ Update the snippet for your use case**\
+▪ **Insert your API key:** replace `<YOUR_AIMLAPI_KEY>` with your real AI/ML API key.\
+▪ **Select a model:** set the `model` field to the model you want to call.\
+▪ **Provide input:** fill in the request input field(s) shown in the example (for example, `messages` for chat/LLM models, or other inputs for image/video/audio models).
 
-:digit\_five: **Run your modified code**
+**4️ (Optional) Tune the request**\
+Depending on the model type, you can add optional parameters to control the output (e.g., generation settings, quality, length, etc.). See the API schema below for the full list.
 
-Run your modified code in your development environment. Response time depends on various factors, but for simple prompts it rarely exceeds a few seconds.
+**5️ Run your code**\
+Run the updated code in your development environment. Response time depends on the model and request size, but simple requests typically return quickly.
 
 {% hint style="success" %}
 If you need a more detailed walkthrough for setting up your development environment and making a request step by step — feel free to use our [Quickstart guide](/broken/pages/ngeSCZKxiGVWqYZTHDjY).

docs/api-references/model-database.md

@@ -23,33 +23,31 @@ Both IDs listed above refer to the same model; we support them for backward comp
 
 DeepSeek R1 is a cutting-edge reasoning model developed by DeepSeek AI, designed to excel in complex problem-solving, mathematical reasoning, and programming assistance.
 
-## How to Make a Call
+{% hint style="success" %}
+[Create AI/ML API Key](https://aimlapi.com/app/keys)
+{% endhint %}
 
 <details>
 
-<summary>Step-by-Step Instructions</summary>
-
-:digit\_one: **Setup You Can’t Skip**
-
-:black\_small\_square: [**Create an Account**](https://aimlapi.com/app/sign-up): Visit the AI/ML API website and create an account (if you don’t have one yet).\
-:black\_small\_square: [**Generate an API Key**](https://aimlapi.com/app/keys): After logging in, navigate to your account dashboard and generate your API key. Ensure that key is enabled on UI.
-
-:digit\_two: **Copy the code example**
-
-At the bottom of this page, you'll find [a code example](deepseek-r1.md#code-example) that shows how to structure the request. Choose the code snippet in your preferred programming language and copy it into your development environment.
-
-:digit\_three: **Modify the code example**
+<summary>How to make the first API call</summary>
 
-:black\_small\_square: Replace `<YOUR_AIMLAPI_KEY>` with your actual AI/ML API key from your account.\
-:black\_small\_square: Insert your question or request into the `content` field—this is what the model will respond to.
+**1️⃣ Required setup (don’t skip this)**\
+▪ **Create an account:** Sign up on the AI/ML API website (if you don’t have one yet).\
+▪ **Generate an API key:** In your account dashboard, create an API key and make sure it’s **enabled** in the UI.
 
-:digit\_four: <sup><sub><mark style="background-color:yellow;">**(Optional)**<mark style="background-color:yellow;"><sub></sup>**&#x20;Adjust other optional parameters if needed**
+**2️ Copy the code example**\
+At the bottom of this page, pick the snippet for your preferred programming language (Python / Node.js) and copy it into your project.
 
-Only `model` and `messages` are required parameters for this model (and we’ve already filled them in for you in the example), but you can include optional parameters if needed to adjust the model’s behavior. Below, you can find the corresponding [API schema](deepseek-r1.md#api-schema), which lists all available parameters along with notes on how to use them.
+**3️ Update the snippet for your use case**\
+▪ **Insert your API key:** replace `<YOUR_AIMLAPI_KEY>` with your real AI/ML API key.\
+▪ **Select a model:** set the `model` field to the model you want to call.\
+▪ **Provide input:** fill in the request input field(s) shown in the example (for example, `messages` for chat/LLM models, or other inputs for image/video/audio models).
 
-:digit\_five: **Run your modified code**
+**4️ (Optional) Tune the request**\
+Depending on the model type, you can add optional parameters to control the output (e.g., generation settings, quality, length, etc.). See the API schema below for the full list.
 
-Run your modified code in your development environment. Response time depends on various factors, but for simple prompts it rarely exceeds a few seconds.
+**5️ Run your code**\
+Run the updated code in your development environment. Response time depends on the model and request size, but simple requests typically return quickly.
 
 {% hint style="success" %}
 If you need a more detailed walkthrough for setting up your development environment and making a request step by step — feel free to use our [Quickstart guide](/broken/pages/ngeSCZKxiGVWqYZTHDjY).

docs/api-references/text-models-llm/DeepSeek/deepseek-chat.md

@@ -19,33 +19,31 @@ This documentation is valid for the following list of our models:
 
 A cutting-edge multimodal AI model developed by Google DeepMind, designed to power agentic experiences. This model is capable of processing text and images.
 
-## How to Make a Call
+{% hint style="success" %}
+[Create AI/ML API Key](https://aimlapi.com/app/keys)
+{% endhint %}
 
 <details>
 
-<summary>Step-by-Step Instructions</summary>
-
-:digit\_one: **Setup You Can’t Skip**
-
-:black\_small\_square: [**Create an Account**](https://aimlapi.com/app/sign-up): Visit the AI/ML API website and create an account (if you don’t have one yet).\
-:black\_small\_square: [**Generate an API Key**](https://aimlapi.com/app/keys): After logging in, navigate to your account dashboard and generate your API key. Ensure that key is enabled on UI.
-
-:digit\_two: **Copy the code example**
-
-At the bottom of this page, you'll find [a code example](gemini-2.0-flash-exp.md#code-example) that shows how to structure the request. Choose the code snippet in your preferred programming language and copy it into your development environment.
-
-:digit\_three: **Modify the code example**
+<summary>How to make the first API call</summary>
 
-:black\_small\_square: Replace `<YOUR_AIMLAPI_KEY>` with your actual AI/ML API key from your account.\
-:black\_small\_square: Insert your question or request into the `content` field—this is what the model will respond to.
+**1️⃣ Required setup (don’t skip this)**\
+▪ **Create an account:** Sign up on the AI/ML API website (if you don’t have one yet).\
+▪ **Generate an API key:** In your account dashboard, create an API key and make sure it’s **enabled** in the UI.
 
-:digit\_four: <sup><sub><mark style="background-color:yellow;">**(Optional)**<mark style="background-color:yellow;"><sub></sup>**&#x20;Adjust other optional parameters if needed**
+**2️ Copy the code example**\
+At the bottom of this page, pick the snippet for your preferred programming language (Python / Node.js) and copy it into your project.
 
-Only `model` and `messages` are required parameters for this model (and we’ve already filled them in for you in the example), but you can include optional parameters if needed to adjust the model’s behavior. Below, you can find the corresponding [API schema](gemini-2.0-flash-exp.md#api-schema), which lists all available parameters along with notes on how to use them.
+**3️ Update the snippet for your use case**\
+▪ **Insert your API key:** replace `<YOUR_AIMLAPI_KEY>` with your real AI/ML API key.\
+▪ **Select a model:** set the `model` field to the model you want to call.\
+▪ **Provide input:** fill in the request input field(s) shown in the example (for example, `messages` for chat/LLM models, or other inputs for image/video/audio models).
 
-:digit\_five: **Run your modified code**
+**4️ (Optional) Tune the request**\
+Depending on the model type, you can add optional parameters to control the output (e.g., generation settings, quality, length, etc.). See the API schema below for the full list.
 
-Run your modified code in your development environment. Response time depends on various factors, but for simple prompts it rarely exceeds a few seconds.
+**5️ Run your code**\
+Run the updated code in your development environment. Response time depends on the model and request size, but simple requests typically return quickly.
 
 {% hint style="success" %}
 If you need a more detailed walkthrough for setting up your development environment and making a request step by step — feel free to use our [Quickstart guide](/broken/pages/ngeSCZKxiGVWqYZTHDjY).

docs/api-references/text-models-llm/DeepSeek/deepseek-r1.md

@@ -18,33 +18,31 @@ This documentation is valid for the following list of our models:
 
 A large language model (LLM) optimized for instruction-following tasks, striking a balance between computational efficiency and high-quality performance. It excels in multilingual tasks, offering a lightweight solution without compromising on quality.
 
-## How to Make a Call
+{% hint style="success" %}
+[Create AI/ML API Key](https://aimlapi.com/app/keys)
+{% endhint %}
 
 <details>
 
-<summary>Step-by-Step Instructions</summary>
-
-:digit\_one: **Setup You Can’t Skip**
-
-:black\_small\_square: [**Create an Account**](https://aimlapi.com/app/sign-up): Visit the AI/ML API website and create an account (if you don’t have one yet).\
-:black\_small\_square: [**Generate an API Key**](https://aimlapi.com/app/keys): After logging in, navigate to your account dashboard and generate your API key. Ensure that key is enabled on UI.
-
-:digit\_two: **Copy the code example**
-
-At the bottom of this page, you'll find [a code example](Llama-3.2-3B-Instruct-Turbo.md#code-example) that shows how to structure the request. Choose the code snippet in your preferred programming language and copy it into your development environment.
-
-:digit\_three: **Modify the code example**
+<summary>How to make the first API call</summary>
 
-:black\_small\_square: Replace `<YOUR_AIMLAPI_KEY>` with your actual AI/ML API key from your account.\
-:black\_small\_square: Insert your question or request into the `content` field—this is what the model will respond to.
+**1️⃣ Required setup (don’t skip this)**\
+▪ **Create an account:** Sign up on the AI/ML API website (if you don’t have one yet).\
+▪ **Generate an API key:** In your account dashboard, create an API key and make sure it’s **enabled** in the UI.
 
-:digit\_four: <sup><sub><mark style="background-color:yellow;">**(Optional)**<mark style="background-color:yellow;"><sub></sup>**&#x20;Adjust other optional parameters if needed**
+**2️ Copy the code example**\
+At the bottom of this page, pick the snippet for your preferred programming language (Python / Node.js) and copy it into your project.
 
-Only `model` and `messages` are required parameters for this model (and we’ve already filled them in for you in the example), but you can include optional parameters if needed to adjust the model’s behavior. Below, you can find the corresponding [API schema](Llama-3.2-3B-Instruct-Turbo.md#api-schema), which lists all available parameters along with notes on how to use them.
+**3️ Update the snippet for your use case**\
+▪ **Insert your API key:** replace `<YOUR_AIMLAPI_KEY>` with your real AI/ML API key.\
+▪ **Select a model:** set the `model` field to the model you want to call.\
+▪ **Provide input:** fill in the request input field(s) shown in the example (for example, `messages` for chat/LLM models, or other inputs for image/video/audio models).
 
-:digit\_five: **Run your modified code**
+**4️ (Optional) Tune the request**\
+Depending on the model type, you can add optional parameters to control the output (e.g., generation settings, quality, length, etc.). See the API schema below for the full list.
 
-Run your modified code in your development environment. Response time depends on various factors, but for simple prompts it rarely exceeds a few seconds.
+**5️ Run your code**\
+Run the updated code in your development environment. Response time depends on the model and request size, but simple requests typically return quickly.
 
 {% hint style="success" %}
 If you need a more detailed walkthrough for setting up your development environment and making a request step by step — feel free to use our [Quickstart guide](/broken/pages/ngeSCZKxiGVWqYZTHDjY).

docs/api-references/text-models-llm/Google/gemini-2.0-flash-exp.md

@@ -18,33 +18,31 @@ This documentation is valid for the following list of our models:
 
 An optimized language model designed for efficient text generation with advanced features and multilingual support. Specifically tuned for instruction-following tasks, making it suitable for applications requiring conversational capabilities and task-oriented responses.
 
-## How to Make a Call
+{% hint style="success" %}
+[Create AI/ML API Key](https://aimlapi.com/app/keys)
+{% endhint %}
 
 <details>
 
-<summary>Step-by-Step Instructions</summary>
-
-:digit\_one: **Setup You Can’t Skip**
-
-:black\_small\_square: [**Create an Account**](https://aimlapi.com/app/sign-up): Visit the AI/ML API website and create an account (if you don’t have one yet).\
-:black\_small\_square: [**Generate an API Key**](https://aimlapi.com/app/keys): After logging in, navigate to your account dashboard and generate your API key. Ensure that key is enabled on UI.
-
-:digit\_two: **Copy the code example**
-
-At the bottom of this page, you'll find [a code example](Llama-3.3-70B-Instruct-Turbo.md#code-example) that shows how to structure the request. Choose the code snippet in your preferred programming language and copy it into your development environment.
-
-:digit\_three: **Modify the code example**
+<summary>How to make the first API call</summary>
 
-:black\_small\_square: Replace `<YOUR_AIMLAPI_KEY>` with your actual AI/ML API key from your account.\
-:black\_small\_square: Insert your question or request into the `content` field—this is what the model will respond to.
+**1️⃣ Required setup (don’t skip this)**\
+▪ **Create an account:** Sign up on the AI/ML API website (if you don’t have one yet).\
+▪ **Generate an API key:** In your account dashboard, create an API key and make sure it’s **enabled** in the UI.
 
-:digit\_four: <sup><sub><mark style="background-color:yellow;">**(Optional)**<mark style="background-color:yellow;"><sub></sup>**&#x20;Adjust other optional parameters if needed**
+**2️ Copy the code example**\
+At the bottom of this page, pick the snippet for your preferred programming language (Python / Node.js) and copy it into your project.
 
-Only `model` and `messages` are required parameters for this model (and we’ve already filled them in for you in the example), but you can include optional parameters if needed to adjust the model’s behavior. Below, you can find the corresponding [API schema](Llama-3.3-70B-Instruct-Turbo.md#api-schema), which lists all available parameters along with notes on how to use them.
+**3️ Update the snippet for your use case**\
+▪ **Insert your API key:** replace `<YOUR_AIMLAPI_KEY>` with your real AI/ML API key.\
+▪ **Select a model:** set the `model` field to the model you want to call.\
+▪ **Provide input:** fill in the request input field(s) shown in the example (for example, `messages` for chat/LLM models, or other inputs for image/video/audio models).
 
-:digit\_five: **Run your modified code**
+**4️ (Optional) Tune the request**\
+Depending on the model type, you can add optional parameters to control the output (e.g., generation settings, quality, length, etc.). See the API schema below for the full list.
 
-Run your modified code in your development environment. Response time depends on various factors, but for simple prompts it rarely exceeds a few seconds.
+**5️ Run your code**\
+Run the updated code in your development environment. Response time depends on the model and request size, but simple requests typically return quickly.
 
 {% hint style="success" %}
 If you need a more detailed walkthrough for setting up your development environment and making a request step by step — feel free to use our [Quickstart guide](/broken/pages/ngeSCZKxiGVWqYZTHDjY).