GITBOOK-366: docs: move the lastest chat models' examples up

Author: techpro-aimlapi

docs/api-references/text-models-llm/openai/gpt-5-chat.md

@@ -1,10 +1,8 @@
 # gpt-5-chat
 
-{% hint style="info" %}
-This documentation is valid for the following list of our models:
 
-* `openai/gpt-5-chat-latest`
-{% endhint %}
+
+<table data-header-hidden data-full-width="true"><thead><tr><th width="546.4443969726562" valign="top"></th><th width="202.666748046875" valign="top"></th></tr></thead><tbody><tr><td valign="top"><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This documentation is valid for the following list of our models:</p><ul><li><code>openai/gpt-5-chat-latest</code></li></ul></div></td><td valign="top"><a href="https://aimlapi.com/app/?model=openai/gpt-5-chat-latest&#x26;mode=chat" class="button primary">Try in Playground</a></td></tr></tbody></table>
 
 ## Model Overview
 
@@ -23,7 +21,7 @@ The non-reasoning version of [GPT‑5](gpt-5.md).
 
 ### &#x20;:digit\_two:  Copy the code example
 
-At the bottom of this page, you'll find [a code example](gpt-5-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.
+Below, you'll find [a code example](gpt-5-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
 
@@ -44,20 +42,6 @@ If you need a more detailed walkthrough for setting up your development environm
 
 </details>
 
-## API Schema
-
-{% openapi-operation spec="gpt-5-chat" path="/v1/chat/completions" method="post" %}
-[OpenAPI gpt-5-chat](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-5-chat.json)
-{% endopenapi-operation %}
-
-### Responses Endpoint
-
-This endpoint is currently used _only_ with OpenAI models. Some models support both the `/chat/completions` and `/responses` endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the `/responses` endpoint in the future.
-
-{% openapi-operation spec="responses-all-models" path="/v1/responses" method="post" %}
-[OpenAPI responses-all-models](https://api.aimlapi.com/docs-public-yaml)
-{% endopenapi-operation %}
-
 ## Code Example
 
 {% tabs %}
@@ -185,6 +169,20 @@ main();
 
 </details>
 
+## API Schema
+
+{% openapi-operation spec="gpt-5-chat" path="/v1/chat/completions" method="post" %}
+[OpenAPI gpt-5-chat](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-5-chat.json)
+{% endopenapi-operation %}
+
+### Responses Endpoint
+
+This endpoint is currently used _only_ with OpenAI models. Some models support both the `/chat/completions` and `/responses` endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the `/responses` endpoint in the future.
+
+{% openapi-operation spec="responses-all-models" path="/v1/responses" method="post" %}
+[OpenAPI responses-all-models](https://api.aimlapi.com/docs-public-yaml)
+{% endopenapi-operation %}
+
 ## Code Example #2: Using /responses Endpoint
 
 {% tabs %}

docs/api-references/text-models-llm/openai/gpt-5-mini.md

@@ -23,7 +23,7 @@ OA quicker, more budget-friendly variant of [GPT-5](gpt-5.md), ideal for clear t
 
 ###  :digit\_two:  Copy the code example
 
-At the bottom of this page, you'll find [a code example](gpt-5-mini.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.
+Below, you'll find [a code example](gpt-5-mini.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
 
@@ -44,20 +44,6 @@ If you need a more detailed walkthrough for setting up your development environm
 
 </details>
 
-## API Schema
-
-{% openapi-operation spec="gpt-5-mini" path="/v1/chat/completions" method="post" %}
-[OpenAPI gpt-5-mini](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-5-mini.json)
-{% endopenapi-operation %}
-
-### Responses Endpoint
-
-This endpoint is currently used _only_ with OpenAI models. Some models support both the `/chat/completions` and `/responses` endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the `/responses` endpoint in the future.
-
-{% openapi-operation spec="responses-all-models" path="/v1/responses" method="post" %}
-[OpenAPI responses-all-models](https://api.aimlapi.com/docs-public-yaml)
-{% endopenapi-operation %}
-
 ## Code Example
 
 {% tabs %}
@@ -184,6 +170,20 @@ main();
 
 </details>
 
+## API Schema
+
+{% openapi-operation spec="gpt-5-mini" path="/v1/chat/completions" method="post" %}
+[OpenAPI gpt-5-mini](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-5-mini.json)
+{% endopenapi-operation %}
+
+### Responses Endpoint
+
+This endpoint is currently used _only_ with OpenAI models. Some models support both the `/chat/completions` and `/responses` endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the `/responses` endpoint in the future.
+
+{% openapi-operation spec="responses-all-models" path="/v1/responses" method="post" %}
+[OpenAPI responses-all-models](https://api.aimlapi.com/docs-public-yaml)
+{% endopenapi-operation %}
+
 ## Code Example #2: Using /responses Endpoint
 
 {% tabs %}

docs/api-references/text-models-llm/openai/gpt-5-nano.md

@@ -1,10 +1,6 @@
 # gpt-5-nano
 
-{% hint style="info" %}
-This documentation is valid for the following list of our models:
-
-* `openai/gpt-5-nano-2025-08-07`
-{% endhint %}
+<table data-header-hidden data-full-width="true"><thead><tr><th width="546.4443969726562" valign="top"></th><th width="202.666748046875" valign="top"></th></tr></thead><tbody><tr><td valign="top"><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This documentation is valid for the following list of our models:</p><ul><li><code>openai/gpt-5-nano-2025-08-07</code></li></ul></div></td><td valign="top"><a href="https://aimlapi.com/app/?model=openai/gpt-5-nano-2025-08-07&#x26;mode=chat" class="button primary">Try in Playground</a></td></tr></tbody></table>
 
 ## Model Overview
 
@@ -23,7 +19,7 @@ The smallest, fastest, and most affordable model in the GPT-5 lineup. While it
 
 ### &#x20;:digit\_two:  Copy the code example
 
-At the bottom of this page, you'll find [a code example](gpt-5-nano.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.
+Below, you'll find [a code example](gpt-5-nano.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
 
@@ -44,20 +40,6 @@ If you need a more detailed walkthrough for setting up your development environm
 
 </details>
 
-## API Schema
-
-{% openapi-operation spec="gpt-5-nano" path="/v1/chat/completions" method="post" %}
-[OpenAPI gpt-5-nano](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-5-nano.json)
-{% endopenapi-operation %}
-
-### Responses Endpoint
-
-This endpoint is currently used _only_ with OpenAI models. Some models support both the `/chat/completions` and `/responses` endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the `/responses` endpoint in the future.
-
-{% openapi-operation spec="responses-all-models" path="/v1/responses" method="post" %}
-[OpenAPI responses-all-models](https://api.aimlapi.com/docs-public-yaml)
-{% endopenapi-operation %}
-
 ## Code Example
 
 {% tabs %}
@@ -184,6 +166,20 @@ main();
 
 </details>
 
+## API Schema
+
+{% openapi-operation spec="gpt-5-nano" path="/v1/chat/completions" method="post" %}
+[OpenAPI gpt-5-nano](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-5-nano.json)
+{% endopenapi-operation %}
+
+### Responses Endpoint
+
+This endpoint is currently used _only_ with OpenAI models. Some models support both the `/chat/completions` and `/responses` endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the `/responses` endpoint in the future.
+
+{% openapi-operation spec="responses-all-models" path="/v1/responses" method="post" %}
+[OpenAPI responses-all-models](https://api.aimlapi.com/docs-public-yaml)
+{% endopenapi-operation %}
+
 ## Code Example #2: Using /responses Endpoint
 
 {% tabs %}

docs/api-references/text-models-llm/openai/gpt-5.md

@@ -23,7 +23,7 @@ OpenAI’s most advanced (and the most capable coding) model as of **August 2025
 
 ###  :digit\_two:  Copy the code example
 
-At the bottom of this page, you'll find [a code example](gpt-5.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.
+Below, you'll find [a code example](gpt-5.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
 
@@ -44,20 +44,6 @@ If you need a more detailed walkthrough for setting up your development environm
 
 </details>
 
-## API Schema
-
-{% openapi-operation spec="gpt-5-test" path="/v1/chat/completions" method="post" %}
-[OpenAPI gpt-5-test](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-5.json)
-{% endopenapi-operation %}
-
-### Responses Endpoint
-
-This endpoint is currently used _only_ with OpenAI models. Some models support both the `/chat/completions` and `/responses` endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the `/responses` endpoint in the future.
-
-{% openapi-operation spec="responses-all-models" path="/v1/responses" method="post" %}
-[OpenAPI responses-all-models](https://api.aimlapi.com/docs-public-yaml)
-{% endopenapi-operation %}
-
 ## Code Example
 
 {% tabs %}
@@ -184,6 +170,20 @@ main();
 
 </details>
 
+## API Schema
+
+{% openapi-operation spec="gpt-5-test" path="/v1/chat/completions" method="post" %}
+[OpenAPI gpt-5-test](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-5.json)
+{% endopenapi-operation %}
+
+### Responses Endpoint
+
+This endpoint is currently used _only_ with OpenAI models. Some models support both the `/chat/completions` and `/responses` endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the `/responses` endpoint in the future.
+
+{% openapi-operation spec="responses-all-models" path="/v1/responses" method="post" %}
+[OpenAPI responses-all-models](https://api.aimlapi.com/docs-public-yaml)
+{% endopenapi-operation %}
+
 ## Code Example #2: Using /responses Endpoint
 
 {% tabs %}

docs/api-references/text-models-llm/openai/gpt-oss-120b.md

@@ -1,10 +1,6 @@
 # gpt-oss-120b
 
-{% hint style="info" %}
-This documentation is valid for the following list of our models:
-
-* `openai/gpt-oss-120b`
-{% endhint %}
+<table data-header-hidden data-full-width="true"><thead><tr><th width="546.4443969726562" valign="top"></th><th width="202.666748046875" valign="top"></th></tr></thead><tbody><tr><td valign="top"><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This documentation is valid for the following list of our models:</p><ul><li><code>openai/gpt-oss-120b</code></li></ul></div></td><td valign="top"><a href="https://aimlapi.com/app/?model=openai/gpt-oss-120b&#x26;mode=chat" class="button primary">Try in Playground</a></td></tr></tbody></table>
 
 ## Model Overview
 
@@ -23,7 +19,7 @@ This OSS model is text-only and designed for strong reasoning and tool use.
 
 ### &#x20;:digit\_two:  Copy the code example
 
-At the bottom of this page, you'll find [a code example](gpt-oss-120b.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.
+Below, you'll find [a code example](gpt-oss-120b.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
 
@@ -44,12 +40,6 @@ If you need a more detailed walkthrough for setting up your development environm
 
 </details>
 
-## API Schema
-
-{% openapi-operation spec="gpt-oss-120b" path="/v1/chat/completions" method="post" %}
-[OpenAPI gpt-oss-120b](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-oss-120b.json)
-{% endopenapi-operation %}
-
 ## Code Example
 
 {% tabs %}
@@ -166,3 +156,9 @@ main();
 {% endcode %}
 
 </details>
+
+## API Schema
+
+{% openapi-operation spec="gpt-oss-120b" path="/v1/chat/completions" method="post" %}
+[OpenAPI gpt-oss-120b](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-oss-120b.json)
+{% endopenapi-operation %}

docs/api-references/text-models-llm/openai/gpt-oss-20b.md

@@ -1,10 +1,6 @@
 # gpt-oss-20b
 
-{% hint style="info" %}
-This documentation is valid for the following list of our models:
-
-* `openai/gpt-oss-20b`
-{% endhint %}
+<table data-header-hidden data-full-width="true"><thead><tr><th width="546.4443969726562" valign="top"></th><th width="202.666748046875" valign="top"></th></tr></thead><tbody><tr><td valign="top"><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This documentation is valid for the following list of our models:</p><ul><li><code>openai/gpt-oss-20b</code></li></ul></div></td><td valign="top"><a href="https://aimlapi.com/app/?model=openai/gpt-oss-20b&#x26;mode=chat" class="button primary">Try in Playground</a></td></tr></tbody></table>
 
 ## Model Overview
 
@@ -23,7 +19,7 @@ This OSS model is text-only and designed for strong reasoning and tool use.
 
 ### &#x20;:digit\_two:  Copy the code example
 
-At the bottom of this page, you'll find [a code example](gpt-oss-20b.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.
+Below, you'll find [a code example](gpt-oss-20b.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
 
@@ -44,12 +40,6 @@ If you need a more detailed walkthrough for setting up your development environm
 
 </details>
 
-## API Schema
-
-{% openapi-operation spec="gpt-oss-20b" path="/v1/chat/completions" method="post" %}
-[OpenAPI gpt-oss-20b](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-oss-20b.json)
-{% endopenapi-operation %}
-
 ## Code Example
 
 {% tabs %}
@@ -166,3 +156,9 @@ main();
 {% endcode %}
 
 </details>
+
+## API Schema
+
+{% openapi-operation spec="gpt-oss-20b" path="/v1/chat/completions" method="post" %}
+[OpenAPI gpt-oss-20b](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/gpt-oss-20b.json)
+{% endopenapi-operation %}

docs/api-references/text-models-llm/openai/o4-mini.md

@@ -1,10 +1,6 @@
 # o4-mini
 
-{% hint style="info" %}
-This documentation is valid for the following list of our models:
-
-* `openai/o4-mini-2025-04-16`
-{% endhint %}
+<table data-header-hidden data-full-width="true"><thead><tr><th width="546.4443969726562" valign="top"></th><th width="202.666748046875" valign="top"></th></tr></thead><tbody><tr><td valign="top"><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>This documentation is valid for the following list of our models:</p><ul><li><code>openai/o4-mini-2025-04-16</code></li></ul></div></td><td valign="top"><a href="https://aimlapi.com/app/?model=openai/o4-mini-2025-04-16&#x26;mode=chat" class="button primary">Try in Playground</a></td></tr></tbody></table>
 
 ## Model Overview
 
@@ -23,7 +19,7 @@ The newest small model in our o-series lineup, built for speed and smart reasoni
 
 ### &#x20;:digit\_two:  Copy the code example
 
-At the bottom of this page, you'll find [a code example](o4-mini.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.
+Below, you'll find [a code example](o4-mini.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
 
@@ -44,20 +40,6 @@ If you need a more detailed walkthrough for setting up your development environm
 
 </details>
 
-## API Schema
-
-{% openapi-operation spec="o4-mini" path="/v1/chat/completions" method="post" %}
-[OpenAPI o4-mini](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/o4-mini.json)
-{% endopenapi-operation %}
-
-### Responses Endpoint
-
-This endpoint is currently used _only_ with OpenAI models. Some models support both the `/chat/completions` and `/responses` endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the `/responses` endpoint in the future.
-
-{% openapi-operation spec="responses-all-models" path="/v1/responses" method="post" %}
-[OpenAPI responses-all-models](https://api.aimlapi.com/docs-public-yaml)
-{% endopenapi-operation %}
-
 ## Code Example
 
 {% code overflow="wrap" %}
@@ -103,6 +85,20 @@ print(data)
 
 </details>
 
+## API Schema
+
+{% openapi-operation spec="o4-mini" path="/v1/chat/completions" method="post" %}
+[OpenAPI o4-mini](https://raw.githubusercontent.com/aimlapi/api-docs/refs/heads/main/docs/api-references/text-models-llm/OpenAI/o4-mini.json)
+{% endopenapi-operation %}
+
+### Responses Endpoint
+
+This endpoint is currently used _only_ with OpenAI models. Some models support both the `/chat/completions` and `/responses` endpoints, while others support only one of them. OpenAI has announced plans to expand the capabilities of the `/responses` endpoint in the future.
+
+{% openapi-operation spec="responses-all-models" path="/v1/responses" method="post" %}
+[OpenAPI responses-all-models](https://api.aimlapi.com/docs-public-yaml)
+{% endopenapi-operation %}
+
 ## Code Example #2: Using /responses Endpoint
 
 {% tabs %}