fix(genai): responses api

Author: RoRoJ

pages/generative-apis/faq.mdx

@@ -40,7 +40,7 @@ No, you cannot increase maximum output tokens above [limits for each models](/ge
 These limits are in place to protect you against:
 - Long generation which may be ended by an HTTP timeout. Limits are designed to ensure a model will send its HTTP response in less than 5 minutes.
 - Uncontrolled billing, as several models are known to be able to enter infinite generation loops (specific prompts can make the model generate the same sentence over and over, without stopping at all).
-If you require higher maximum output tokens, you can use [Managed Inference](https://console.scaleway.com/inference/deployments) where these limts do not apply (as your bill will be limited by the size of your deployment).
+If you require higher maximum output tokens, you can use [Managed Inference](https://console.scaleway.com/inference/deployments) where these limits do not apply (as your bill will be limited by the size of your deployment).
 
 ### Can I use OpenAI libraries and APIs with Scaleway's Generative APIs?
 Yes, Scaleway's Generative APIs are designed to be compatible with OpenAI libraries and SDKs, including the OpenAI Python client library and LangChain SDKs. This allows for seamless integration with existing workflows.

pages/generative-apis/how-to/query-language-models.mdx

@@ -13,7 +13,7 @@ Scaleway's Generative APIs service allows users to interact with powerful langua
 
 There are several ways to interact with language models:
 - The Scaleway [console](https://console.scaleway.com) provides complete [playground](/generative-apis/how-to/query-language-models/#accessing-the-playground), aiming to test models, adapt parameters, and observe how these changes affect the output in real-time.
-- Via the [Chat API](/generative-apis/how-to/query-language-models/#querying-language-models-via-api)
+- Via the [Chat Completions API](https://www.scaleway.com/en/developers/api/generative-apis/#path-chat-completions-create-a-chat-completion) or the [Responses API](https://www.scaleway.com/en/developers/api/generative-apis/#path-responses-beta-create-a-response)
 
 <Requirements />
 
@@ -39,7 +39,22 @@ The web playground displays.
 
 ## Querying language models via API
 
-The [Chat API](/generative-apis/api-cli/using-chat-api/) is an OpenAI-compatible REST API for generating and manipulating conversations.
+Both the [Chat Completions API](https://www.scaleway.com/en/developers/api/generative-apis/#path-chat-completions-create-a-chat-completion) and the [Responses API](https://www.scaleway.com/en/developers/api/generative-apis/#path-responses-beta-create-a-response) are an OpenAI-compatible REST APIs for generating and manipulating conversations.
+
+### Chat Completions API or Responses API?
+
+The table below compares the Chat Completions API to the Responses API. TODO CONTINUE HERE
+
+| Aspect                  | Responses API                                   | Chat Completions API                    |
+|-------------------------|------------------------------------------------|-----------------------------------------|
+| **Description           | Unified API for model responses (successor to Chat + Assistants). Offers tool-calling by built-in tools (e.g. web or file search) while the model generates a responses, though currently only `function` tools are supported by Scaleway. | Older API for chat-style completions. Offers only `function` tool-calling. |
+| **Status**              |  Beta | GA  |
+| **Endpoint**            | `/v1/{project_id}/responses`                                | `/v1/{project_id}/chat/completions`                  |
+| **Use cases**            | Agentic apps, tool-augmented workflows, multi-step tasks, future-proof apps | Simple chatbots, Q&A, summarization, stateless interactions |
+| **Features**             | - Plain chat completions<br>- Tool calling (Code Interpreter, image gen, file search, web search)<br>- MCP tool integration<br>- Background mode<br>- Reasoning summaries | - Plain chat completions only<br>- Function calling (basic tool use)<br>- No MCP, no background mode, no reasoning summaries |
+
+| **Long-term support**    | Future standard API (will replace Chat & Assistants) | Maintained for now, EOL expected mid-2026 |
+| **Complexity**           | More powerful but requires newer SDK methods (`client.responses.create`) | Simpler, lighter (`client.chat.completions.create`) |
 
 You can query the models programmatically using your favorite tools or languages.
 In the following example, we will use the OpenAI Python client.

pages/generative-apis/index.mdx

@@ -44,6 +44,14 @@ description: Dive into Scaleway Generative APIs with our quickstart guides, how-
     />
 </Grid>
 
+<ClickableBanner
+    productLogo="cli"
+    title="Generative APIs Developer Reference"
+    description="Developer reference documentation for Scaleway Generative APIs."
+    url="https://www.scaleway.com/en/developers/api/generative-apis/"
+    label="Go to Generative APIs"
+/>
+
 ## Changelog
 
 <ChangelogList

pages/generative-apis/quickstart.mdx

@@ -14,10 +14,6 @@ No need to configure hardware or deploy your own models.
 
 Hosted in European data centers and priced competitively per million tokens used, these APIs enable efficient and scalable integration of AI capabilities into your applications.
 
-<Message type="important">
-  This service is free while in beta. [Specific terms and conditions](https://www.scaleway.com/en/contracts/) apply.
-</Message>
-
 <Requirements />
 
   - A Scaleway account logged into the [console](https://console.scaleway.com)