Skip to content

Commit 828beca

Browse files
author
Lisa Dutour
committed
feat(next-website): add latest exceptions
1 parent 0f9cca7 commit 828beca

File tree

1,348 files changed

+5490
-5420
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

1,348 files changed

+5490
-5420
lines changed

ai-data/generative-apis/api-cli/understanding-errors.mdx

+4-4
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,13 @@ If the response code is not within the 2xx range, the response will contain an e
2727
Below are usual HTTP error codes:
2828

2929
- 400 - **Bad Request**: The format or content of your payload is incorrect. The body may be too large, or fail to parse, or the content-type is mismatched.
30-
- 401 - **Unauthorized**: The `authorization` header is missing. Find required headers in [this page](/ai-data/generative-apis/api-cli/using-generative-apis/)
31-
- 403 - **Forbidden**: Your API key does not exist or does not have the necessary permissions to access the requested resource. Find required permission sets in [this page](/ai-data/generative-apis/api-cli/using-generative-apis/)
30+
- 401 - **Unauthorized**: The `authorization` header is missing. Find required headers in [this page](/generative-apis/api-cli/using-generative-apis/)
31+
- 403 - **Forbidden**: Your API key does not exist or does not have the necessary permissions to access the requested resource. Find required permission sets in [this page](/generative-apis/api-cli/using-generative-apis/)
3232
- 404 - **Route Not Found**: The requested resource could not be found. Check your request is being made to the correct endpoint.
3333
- 422 - **Model Not Found**: The `model` key is present in the request payload, but the corresponding model is not found.
3434
- 422 - **Missing Model**: The `model` key is missing from the request payload.
35-
- 429 - **Too Many Requests**: You are exceeding your current quota for the requested model, calculated in requests per minute. Find rate limits on [this page](/ai-data/generative-apis/reference-content/rate-limits/)
36-
- 429 - **Too Many Tokens**: You are exceeding your current quota for the requested model, calculated in tokens per minute. Find rate limits on [this page](/ai-data/generative-apis/reference-content/rate-limits/)
35+
- 429 - **Too Many Requests**: You are exceeding your current quota for the requested model, calculated in requests per minute. Find rate limits on [this page](/generative-apis/reference-content/rate-limits/)
36+
- 429 - **Too Many Tokens**: You are exceeding your current quota for the requested model, calculated in tokens per minute. Find rate limits on [this page](/generative-apis/reference-content/rate-limits/)
3737
- 500 - **API error**: An unexpected internal error has occurred within Scaleway's systems. If the issue persists, please [open a support ticket](https://console.scaleway.com/support/tickets/create).
3838

3939
For streaming responses via SSE, 5xx errors may occur after a 200 response has been returned.

ai-data/generative-apis/api-cli/using-chat-api.mdx

+7-7
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ curl --request POST \
4848

4949
## Headers
5050

51-
Find required headers in [this page](/ai-data/generative-apis/api-cli/using-generative-apis/).
51+
Find required headers in [this page](/generative-apis/api-cli/using-generative-apis/).
5252

5353
## Body
5454

@@ -69,12 +69,12 @@ Our chat API is OpenAI compatible. Use OpenAI’s [API reference](https://platfo
6969
- stream
7070
- stream_options
7171
- presence_penalty
72-
- [response_format](/ai-data/generative-apis/how-to/use-structured-outputs)
72+
- [response_format](/generative-apis/how-to/use-structured-outputs)
7373
- logprobs
7474
- stop
7575
- seed
76-
- [tools](/ai-data/generative-apis/how-to/use-function-calling)
77-
- [tool_choice](/ai-data/generative-apis/how-to/use-function-calling)
76+
- [tools](/generative-apis/how-to/use-function-calling)
77+
- [tool_choice](/generative-apis/how-to/use-function-calling)
7878

7979
### Unsupported parameters
8080

@@ -88,6 +88,6 @@ If you have a use case requiring one of these unsupported parameters, please [co
8888

8989
## Going further
9090

91-
1. [Python code examples](/ai-data/generative-apis/how-to/query-language-models/#querying-language-models-via-api) to query text models using Scaleway's Chat API
92-
2. [How to use structured outputs](/ai-data/generative-apis/how-to/use-structured-outputs) with the `response_format` parameter
93-
3. [How to use function calling](/ai-data/generative-apis/how-to/use-function-calling) with `tools` and `tool_choice`
91+
1. [Python code examples](/generative-apis/how-to/query-language-models/#querying-language-models-via-api) to query text models using Scaleway's Chat API
92+
2. [How to use structured outputs](/generative-apis/how-to/use-structured-outputs) with the `response_format` parameter
93+
3. [How to use function calling](/generative-apis/how-to/use-function-calling) with `tools` and `tool_choice`

ai-data/generative-apis/api-cli/using-embeddings-api.mdx

+2-2
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ curl --request POST \
3232

3333
## Headers
3434

35-
Find required headers in [this page](/ai-data/generative-apis/api-cli/using-generative-apis/).
35+
Find required headers in [this page](/generative-apis/api-cli/using-generative-apis/).
3636

3737
## Body
3838

@@ -53,5 +53,5 @@ Our embeddings API is OpenAI compatible. Use OpenAI’s [API reference](https://
5353
If you have a use case requiring one of these unsupported parameters, please [contact us via Slack](https://slack.scaleway.com/) on #ai channel.
5454

5555
<Message type="note">
56-
Check our [Python code examples](/ai-data/generative-apis/how-to/query-embedding-models/#querying-embedding-models-via-api) to query embedding models using Scaleway's Embeddings API.
56+
Check our [Python code examples](/generative-apis/how-to/query-embedding-models/#querying-embedding-models-via-api) to query embedding models using Scaleway's Embeddings API.
5757
</Message>

ai-data/generative-apis/api-cli/using-generative-apis.mdx

+4-4
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ dates:
1313

1414
## Access
1515

16-
- A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/) is needed.
16+
- A valid [API key](/iam/how-to/create-api-keys/) is needed.
1717

1818
## Authentication
1919

@@ -51,11 +51,11 @@ curl --request POST \
5151

5252
## Permissions
5353

54-
Permissions define the actions a user or an application can perform on Scaleway Generative APIs. They are managed using Scaleway’s [Identity and Access Management](/identity-and-access-management/iam/quickstart/) interface.
54+
Permissions define the actions a user or an application can perform on Scaleway Generative APIs. They are managed using Scaleway’s [Identity and Access Management](/iam/quickstart/) interface.
5555

56-
[Owner](/identity-and-access-management/iam/concepts/#owner) status or certain [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allow you to perform actions in the intended Organization.
56+
[Owner](/iam/concepts/#owner) status or certain [IAM permissions](/iam/concepts/#permission) allow you to perform actions in the intended Organization.
5757

58-
Querying AI models hosted by Scaleway Generative APIs will require any of the following [permission sets](/identity-and-access-management/iam/concepts/#permission-set):
58+
Querying AI models hosted by Scaleway Generative APIs will require any of the following [permission sets](/iam/concepts/#permission-set):
5959

6060
- **GenerativeApisModelAccess**
6161
- **GenerativeApisFullAccess**

ai-data/generative-apis/how-to/query-code-models.mdx

+6-6
Original file line numberDiff line numberDiff line change
@@ -13,21 +13,21 @@ dates:
1313

1414
Scaleway's Generative APIs service allows users to interact with powerful code models hosted on the platform.
1515

16-
Code models are inherently [language models](/ai-data/generative-apis/how-to/query-language-models/) specialized in **understanding code**, **generating code** and **fixing code**.
16+
Code models are inherently [language models](/generative-apis/how-to/query-language-models/) specialized in **understanding code**, **generating code** and **fixing code**.
1717

1818
As such, they will be available through the same interfaces as language models:
19-
- The Scaleway [console](https://console.scaleway.com) provides complete [playground](/ai-data/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.
20-
- Via the [Chat API](/ai-data/generative-apis/how-to/query-language-models/#querying-language-models-via-api)
19+
- 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.
20+
- Via the [Chat API](/generative-apis/how-to/query-language-models/#querying-language-models-via-api)
2121

22-
For more information on how to query language models, read [our dedicated documentation](/ai-data/generative-apis/how-to/query-language-models/).
22+
For more information on how to query language models, read [our dedicated documentation](/generative-apis/how-to/query-language-models/).
2323

2424
Code models are also ideal AI assistants when **added to IDEs** (integrated development environments).
2525

2626
<Macro id="requirements" />
2727

2828
- A Scaleway account logged into the [console](https://console.scaleway.com)
29-
- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
30-
- A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/) for API authentication
29+
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
30+
- A valid [API key](/iam/how-to/create-api-keys/) for API authentication
3131
- An IDE such as Visual Studio Code or JetBrains
3232

3333
## Install Continue in your IDE

ai-data/generative-apis/how-to/query-embedding-models.mdx

+4-4
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,8 @@ The embedding service is OpenAI compatible. Refer to OpenAI's [embedding documen
1919
<Macro id="requirements" />
2020

2121
- A Scaleway account logged into the [console](https://console.scaleway.com)
22-
- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
23-
- A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/) for API authentication
22+
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
23+
- A valid [API key](/iam/how-to/create-api-keys/) for API authentication
2424
- Python 3.7+ installed on your system
2525

2626
## Querying embedding models via API
@@ -72,8 +72,8 @@ This code sends input text to the `bge-multilingual-gemma2` embedding model and
7272
The following parameters can be adjusted to influence the output of the embedding model:
7373

7474
- **`input`** (string or array of strings): The text or data you want to convert into vectors.
75-
- **`model`** (string): The specific embedding model to use, find all our [supported models](/ai-data/generative-apis/reference-content/supported-models).
75+
- **`model`** (string): The specific embedding model to use, find all our [supported models](/generative-apis/reference-content/supported-models).
7676

7777
<Message type="warning">
78-
If you encounter an error such as "Forbidden 403" refer to the [API documentation](/ai-data/generative-apis/api-cli/understanding-errors) for troubleshooting tips.
78+
If you encounter an error such as "Forbidden 403" refer to the [API documentation](/generative-apis/api-cli/understanding-errors) for troubleshooting tips.
7979
</Message>

ai-data/generative-apis/how-to/query-language-models.mdx

+6-6
Original file line numberDiff line numberDiff line change
@@ -14,14 +14,14 @@ dates:
1414
Scaleway's Generative APIs service allows users to interact with powerful language models hosted on the platform.
1515

1616
There are several ways to interact with language models:
17-
- The Scaleway [console](https://console.scaleway.com) provides complete [playground](/ai-data/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.
18-
- Via the [Chat API](/ai-data/generative-apis/how-to/query-language-models/#querying-language-models-via-api)
17+
- 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.
18+
- Via the [Chat API](/generative-apis/how-to/query-language-models/#querying-language-models-via-api)
1919

2020
<Macro id="requirements" />
2121

2222
- A Scaleway account logged into the [console](https://console.scaleway.com)
23-
- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
24-
- A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/) for API authentication
23+
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
24+
- A valid [API key](/iam/how-to/create-api-keys/) for API authentication
2525
- Python 3.7+ installed on your system
2626

2727
## Accessing the Playground
@@ -41,7 +41,7 @@ The web playground displays.
4141

4242
## Querying language models via API
4343

44-
The [Chat API](/ai-data/generative-apis/api-cli/using-chat-api/) is an OpenAI-compatible REST API for generating and manipulating conversations.
44+
The [Chat API](/generative-apis/api-cli/using-chat-api/) is an OpenAI-compatible REST API for generating and manipulating conversations.
4545

4646
You can query the models programmatically using your favorite tools or languages.
4747
In the following example, we will use the OpenAI Python client.
@@ -114,7 +114,7 @@ The following parameters will influence the output of the model:
114114
- **`stop`**: A string or list of strings where the model will stop generating further tokens. This is useful for controlling the end of the output.
115115

116116
<Message type="warning">
117-
If you encounter an error such as "Forbidden 403" refer to the [API documentation](/ai-data/generative-apis/api-cli/understanding-errors) for troubleshooting tips.
117+
If you encounter an error such as "Forbidden 403" refer to the [API documentation](/generative-apis/api-cli/understanding-errors) for troubleshooting tips.
118118
</Message>
119119

120120
## Streaming

ai-data/generative-apis/how-to/query-vision-models.mdx

+6-6
Original file line numberDiff line numberDiff line change
@@ -18,14 +18,14 @@ Scaleway's Generative APIs service allows users to interact with powerful vision
1818
</Message>
1919

2020
There are several ways to interact with vision models:
21-
- The Scaleway [console](https://console.scaleway.com) provides a complete [playground](/ai-data/generative-apis/how-to/query-vision-models/#accessing-the-playground), aiming to test models, adapt parameters, and observe how these changes affect the output in real-time.
22-
- Via the [Chat API](/ai-data/generative-apis/how-to/query-vision-models/#querying-vision-models-via-the-api)
21+
- The Scaleway [console](https://console.scaleway.com) provides a complete [playground](/generative-apis/how-to/query-vision-models/#accessing-the-playground), aiming to test models, adapt parameters, and observe how these changes affect the output in real-time.
22+
- Via the [Chat API](/generative-apis/how-to/query-vision-models/#querying-vision-models-via-the-api)
2323

2424
<Macro id="requirements" />
2525

2626
- A Scaleway account logged into the [console](https://console.scaleway.com)
27-
- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
28-
- A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/) for API authentication
27+
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
28+
- A valid [API key](/iam/how-to/create-api-keys/) for API authentication
2929
- Python 3.7+ installed on your system
3030

3131
## Accessing the playground
@@ -45,7 +45,7 @@ The web playground displays.
4545

4646
## Querying vision models via the API
4747

48-
The [Chat API](/ai-data/generative-apis/api-cli/using-chat-api/) is an OpenAI-compatible REST API for generating and manipulating conversations.
48+
The [Chat API](/generative-apis/api-cli/using-chat-api/) is an OpenAI-compatible REST API for generating and manipulating conversations.
4949

5050
You can query the vision models programmatically using your favorite tools or languages.
5151
Vision models take both text and images as inputs.
@@ -173,7 +173,7 @@ The following parameters will influence the output of the model:
173173
- **`stop`**: A string or list of strings where the model will stop generating further tokens. This is useful for controlling the end of the output.
174174

175175
<Message type="warning">
176-
If you encounter an error such as "Forbidden 403", refer to the [API documentation](/ai-data/generative-apis/api-cli/understanding-errors) for troubleshooting tips.
176+
If you encounter an error such as "Forbidden 403", refer to the [API documentation](/generative-apis/api-cli/understanding-errors) for troubleshooting tips.
177177
</Message>
178178

179179
## Streaming

ai-data/generative-apis/how-to/use-function-calling.mdx

+4-4
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,13 @@ Function calling allows a large language model (LLM) to interact with external t
1919

2020
<Macro id="requirements" />
2121

22-
- [Owner](/identity-and-access-management/iam/concepts/#owner) status or [IAM permissions](/identity-and-access-management/iam/concepts/#permission) allowing you to perform actions in the intended Organization
23-
- A valid [API key](/identity-and-access-management/iam/how-to/create-api-keys/) for API authentication
22+
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
23+
- A valid [API key](/iam/how-to/create-api-keys/) for API authentication
2424
- Python 3.7+ installed on your system
2525

2626
## Supported models
2727

28-
All the [chat models](/ai-data/generative-apis/reference-content/supported-models/#chat-models) hosted by Scaleway support function calling.
28+
All the [chat models](/generative-apis/reference-content/supported-models/#chat-models) hosted by Scaleway support function calling.
2929

3030
## Understanding function calling
3131

@@ -323,7 +323,7 @@ For more information about function calling and advanced implementations, refer
323323

324324
- [OpenAI Function Calling Guide](https://platform.openai.com/docs/guides/function-calling)
325325
- [JSON Schema Specification](https://json-schema.org/specification)
326-
- [Chat Completions API Reference](/ai-data/generative-apis/api-cli/using-chat-api/)
326+
- [Chat Completions API Reference](/generative-apis/api-cli/using-chat-api/)
327327

328328
Function calling significantly extends the capabilities of language models by allowing them to interact with external tools and APIs.
329329

0 commit comments

Comments
 (0)