Using the Chat API

Reviewed on September 22, 2025

Scaleway Generative APIs are designed as a drop-in replacement for the OpenAI APIs. If you have an LLM-driven application that uses one of OpenAI's client libraries, you can easily configure it to point to Scaleway's Chat API, and get your existing applications running using open-weight instruct models hosted at Scaleway.

Note

You can also try the Responses API for LLM-driven tasks. Released in 2025, it is designed to combine the simplicity of Chat Completions with the ability to do more agentic tasks and reasoning. Find out more about the Responses API.

Create chat completion

Creates a model response for the given chat conversation.

Request sample:

curl --request POST \
     --url https://api.scaleway.ai/v1/chat/completions \
     --header 'Authorization: Bearer ${SCW_SECRET_KEY}' \
     --header 'Content-Type: application/json' \
     --data '{
     "model": "llama-3.1-8b-instruct",
     "messages": [
      {
        "role": "system",
        "content": "<string>"
      },
      {
        "role": "user",
        "content": "<string>"
      }
     ],
     "max_tokens": integer,
     "temperature": float,
     "top_p": float,
     "presence_penalty": float,
     "stop": "<string>",
     "stream": boolean,
     }'