How to import a custom model into a dedicated Generative APIs deployment

Reviewed on April 15, 2026

Scaleway provides a selection of common models for deployment from the Scaleway console. If you need a specific model, you can import it directly from Hugging Face or a Scaleway Object Storage bucket.

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into the console.
• Owner status or IAM permissions to perform actions in your Organization.

1. Click Generative APIs in the AI section of the side menu in the Scaleway console to access the dashboard.
2. Select the Custom models tab.
3. Click Import a model to launch the model import wizard.
4. Choose an upload source:
   • Hugging Face: Pull the model from Hugging Face.
   • Object Storage: This feature is coming soon.
5. Enter the name of the Hugging Face repository to pull the model from.
   Note

   Ensure you have access to gated models if applicable. Refer to the Hugging Face documentation for details.

6. Enter your Hugging Face access token, which must have READ access to the repository.
   Note

   Learn how to generate a Hugging Face access token.

7. Choose a name for your model. The name must be unique within your Organization and Project and cannot be changed later.
8. Click Verify import to check your Hugging Face credentials and ensure model compatibility.
   Tip

   For detailed information about supported models, visit our Supported models catalog.

9. Review the summary of your import, which includes:
   • Context size by node type
   • Quantization options
   • Estimated cost Once checked, click Begin import to finalize the process.
   Note

   Importing a model may take some time, depending on its size. Once the import is complete, the model will appear in the model library, and you will be able to use it for deployment.

Your imported model will now appear in the model library and you can deploy it on Generative APIs.