> For the complete documentation index, see [llms.txt](https://guides.ia.numerique.gouv.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.ia.numerique.gouv.fr/albert-api/modeles/available-models.md).

# Modèles disponibles

Albert API offre l’accès à une large gamme de modèles fondation open source d’IA générative. Nous mettons à jour régulièrement les modèles disponibles pour vous permettre d’utiliser les modèles qui font l’état de l’art.

{% hint style="info" %}
Chaque modèle est associé à un type de modèle. Pour en savoir plus sur les types de modèles, voir [Types de modèles](/albert-api/modeles/model-types.md).
{% endhint %}

Les recommandations d'usage ci-dessous proviennent de l'expérience des utilisateurs et ne sont pas garanties. Nous vous recommandons de tester différents modèles et leurs paramètres pour trouver ceux qui s'adapteront le mieux à vos besoins.

Vos retours nous sont précieux pour améliorer les modèles et les recommandations d'usage. N'hésitez pas à nous les partager sur notre canal Tchap ou par mail (voir la page [Contact](https://ia.numerique.gouv.fr/outils-ia/albert-api/albert-api-contact/)).

<details>

<summary>bge-m3</summary>

Model d'embeddings de référence pour la vectorisation de texte.

<a href="https://huggingface.co/BAAI/bge-m3" class="button secondary">Model card</a>

|                                     |                                        |
| ----------------------------------- | -------------------------------------- |
| **Nombre de paramètres**            | 568M                                   |
| **Type**                            | `text-embeddings-inference`            |
| **Aliases**                         | `BAAI/bge-m3`, `openweight-embeddings` |
| **Licence**                         | MIT                                    |
| **Fenêtre de contexte**             | 8192                                   |
| **Dimension maximale des vecteurs** | 1024                                   |
| **Maximum de texte par batch**      | 64                                     |

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM  | RPD     | TPM      | TPD      |
| ------------------ | ---- | ------- | -------- | -------- |
| Expérimentation    | 500  | 50 000  | illimité | illimité |
| Production limitée | 2000 | 200 000 | illimité | illimité |

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Text vectorisation</strong></td><td>/v1/embeddings</td><td><a href="/albert-api/guides/embeddings.md">Embeddings</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-81b14c9906eb5b7c4462622ae5c87d2f8852ff23%2Farrow-up-1-9.svg?alt=media">arrow-up-1-9.svg</a></td></tr></tbody></table>

</details>

<details>

<summary>bge-reranker-v2-m3</summary>

Modèle de reranking multilingue basé sur `bge-m3`. Il est le modèle de référence pour le reranking sur Albert API.

<a href="https://huggingface.co/BAAI/bge-reranker-v2-m3" class="button secondary">Model card</a>

|                                |                                                |
| ------------------------------ | ---------------------------------------------- |
| **Nombre de paramètres**       | 568M                                           |
| **Type**                       | `text-classification`                          |
| **Licence**                    | MIT                                            |
| **Aliases**                    | `BAAI/bge-reranker-v2-m3`, `openweight-rerank` |
| **Fenêtre de contexte**        | 8192                                           |
| **Maximum de texte par batch** | 64                                             |

{% hint style="success" icon="lightbulb" %}
La limite architecturale est de 8192 tokens, toutefois le modèle a été finetuné pour être utilisé avec des textes de longueur maximale de 1024 tokens. Nous recommandons de ne pas dépasser cette longueur lors de la construction des chunks pour le reranking.
{% endhint %}

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM  | RPD     | TPM      | TPD      |
| ------------------ | ---- | ------- | -------- | -------- |
| Expérimentation    | 500  | 50 000  | illimité | illimité |
| Production limitée | 2000 | 200 000 | illimité | illimité |

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Reranking</strong></td><td>/v1/reranking</td><td><a href="/albert-api/guides/reranking.md">Reranking</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-5e8b41bd061eced4bea7245db48692fbb7c057ed%2Franking-star.svg?alt=media">ranking-star.svg</a></td></tr></tbody></table>

</details>

<details>

<summary>deepseek-v4-flash <img src="https://img.shields.io/badge/mod%C3%A8le_en_exp%C3%A9rimentation-green" alt="modèle en expérimentation"></summary>

MoE spécialisé pour les tâches de code.

{% hint style="warning" %}
Ce modèle est en phase d'expérimentation du 26 juillet 2026 au 31 octobre 2026. Candidat au remplacement du modèle `openweight-code` à l'issue de cette période.

Ce modèle extra-européen peut présenter certaines formes de censure des réponses. Nous recommandons de l'utiliser uniquement pour les cas d'usage de génération de code et non comme un modèle conversationnel généraliste.

Cette phase d'expérimentation a notamment pour objectif d'évaluer l'impact de ces limitations afin de déterminer si elles sont compatibles avec une intégration pérenne dans Albert API. Vos retours sur ce sujet seront particulièrement précieux.
{% endhint %}

<a href="https://huggingface.co/deepseek-ai/DeepSeek-V4-Flash-0731" class="button secondary">Model card</a> <a href="https://albert.playground.etalab.gouv.fr" class="button primary">Essayer dans Playground</a>

|                                 |                                      |
| ------------------------------- | ------------------------------------ |
| **Nombre de paramètres**        | 284B                                 |
| **Nombre de paramètres actifs** | 13B                                  |
| **Licence**                     | MIT                                  |
| **Type**                        | `text-generation`                    |
| **Aliases**                     | `deepseek-ai/DeepSeek-V4-Flash-0731` |
| **Fenêtre de contexte**         | <p>131072</p><p>131072</p>           |
| **Température recommandée**     | 1.0                                  |

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM | RPD      | TPM     | TPD      |
| ------------------ | --- | -------- | ------- | -------- |
| Expérimentation    | 50  | illimité | 246 000 | illimité |
| Production limitée | 50  | illimité | 246 000 | illimité |

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Code</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/code.md">Coder avec Albert API</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-6fc47c006df8d57356f182fd20dc7ea88a0218eb%2Fterminal.svg?alt=media">terminal.svg</a></td></tr><tr><td><strong>Reasoning</strong></td><td>/v1/chat/completions</td><td><a href="https://github.com/betagouv/doc.albert-api/tree/main/guides/reasoning.md">https://github.com/betagouv/doc.albert-api/tree/main/guides/reasoning.md</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-aafd92ec83b34abdcbda5d3a6dd2697de06ce363%2Fbrain.svg?alt=media">brain.svg</a></td></tr><tr><td><strong>Function calling</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/function-calling.md">Function calling &amp; outils</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-f29cbc6060b51ddf8b14c79274064d297b51b503%2Fscrewdriver-wrench.svg?alt=media">screwdriver-wrench.svg</a></td></tr></tbody></table>

{% hint style="info" icon="screwdriver-wrench" %}
**Comportement du function calling**

Le paramètre `tool_choice` doit être explicitement défini à `auto` dans la requête pour que les appels d'outils fonctionnent avec ce modèle. Sans cela, le modèle n'émet pas de `tool_calls`, même si des `tools` sont fournis.\
\
Sans le streaming, modèle renvoie un tool call avec un content non vide. En streaming, les arguments sont fragmentés sur plusieurs chunks SSE, et le finish\_reason: "tool\_calls" arrive dans un chunk distinct qui ne contient plus de tool\_calls.
{% endhint %}

</details>

<details>

<summary>gemma-4-31b-it <img src="https://img.shields.io/badge/mod%C3%A8le_en_exp%C3%A9rimentation-green" alt="modèle en expérimentation"></summary>

Modèle de chat pour des tâches d'une complexité modérée et d'analyse d'images.

{% hint style="warning" %}
Ce modèle est en phase d'expérimentation du 31 août 2026 au 1er décembre 2026. Candidat au remplacement du modèle `openweight-medium` à l'issue de cette période. A l'issue de cette phase d'expérimentation nous évaluerons a l'aide de vos retours si le modèle est viable pour une intégration pérenne dans Albert API.
{% endhint %}

<a href="https://huggingface.co/google/gemma-4-31B-it" class="button secondary">Model card</a> <a href="https://albert.playground.etalab.gouv.fr" class="button primary">Essayer dans Playground</a>

|                                 |                         |
| ------------------------------- | ----------------------- |
| **Nombre de paramètres**        | 30.7B                   |
| **Nombre de paramètres actifs** | 30.7B                   |
| **Licence**                     | Apache 2.0              |
| **Type**                        | `text-generation`       |
| **Aliases**                     | `google/gemma-4-31B-it` |
| **Fenêtre de contexte**         | 262144                  |
| **Température recommandée**     | 1.0                     |

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM | RPD    | TPM     | TPD       |
| ------------------ | --- | ------ | ------- | --------- |
| Expérimentation    | 50  | 1000   | 128 000 | 2 460 000 |
| Production limitée | 100 | 50 000 | 246 000 | illimité  |

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Chat</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/code.md">Coder avec Albert API</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-3c131e6a391c0e543f1a997e8d168a64840b62d3%2Fmessage.svg?alt=media">message.svg</a></td></tr><tr><td><strong>Reasoning</strong></td><td>/v1/chat/completions</td><td><a href="https://github.com/betagouv/doc.albert-api/tree/main/guides/reasoning.md">https://github.com/betagouv/doc.albert-api/tree/main/guides/reasoning.md</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-aafd92ec83b34abdcbda5d3a6dd2697de06ce363%2Fbrain.svg?alt=media">brain.svg</a></td></tr><tr><td><strong>Function calling</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/function-calling.md">Function calling &amp; outils</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-f29cbc6060b51ddf8b14c79274064d297b51b503%2Fscrewdriver-wrench.svg?alt=media">screwdriver-wrench.svg</a></td></tr><tr><td><strong>Analyse d'image</strong></td><td>/v1/chat/completions</td><td></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-6b79e285b0dc48d2628f90ba0dd7ef88755bbcaa%2Feye.svg?alt=media">eye.svg</a></td></tr></tbody></table>

{% hint style="info" icon="screwdriver-wrench" %}
**Comportement du function calling**

Sans le streaming, le modèle renvoie un tool call avec un content vide. En streaming, les arguments sont fragmentés sur plusieurs chunks SSE, et le finish\_reason: "tool\_calls" arrive dans un chunk distinct qui ne contient plus de tool\_calls.
{% endhint %}

{% hint style="info" icon="brain" %}
**Comportement du reasoning**

Gemma 4 est un modèle pouvant *raisonner* (`Thinking`). Pour l'activer, il faut fournir cet argument dans le body du payload : `"chat_template_kwargs": {"enable_thinking": true}`.
{% endhint %}

</details>

<details>

<summary>gpt-oss-120b</summary>

MoE généraliste de grande taille pour des tâches de complexes.

<a href="https://huggingface.co/openai/gpt-oss-120b" class="button secondary">Model card</a> <a href="https://albert.playground.etalab.gouv.fr" class="button primary">Essayer dans Playground</a>

|                                 |                                           |
| ------------------------------- | ----------------------------------------- |
| **Nombre de paramètres**        | 117B                                      |
| **Nombre de paramètres actifs** | 5.1B                                      |
| **Type**                        | `text-generation`                         |
| **Licence**                     | Apache 2.0                                |
| **Aliases**                     | `openai/gpt-oss-120b`, `openweight-large` |
| **Fenêtre de contexte**         | 131072                                    |

{% hint style="success" icon="lightbulb" %}
Les tokens de raisonnement consomment le budget `max_tokens` : prévoyez une marge confortable même pour des réponses courtes (> 1024 tokens).
{% endhint %}

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM | RPD  | TPM     | TPD       |
| ------------------ | --- | ---- | ------- | --------- |
| Expérimentation    | 10  | 1000 | 128 000 | 1 280 000 |
| Production limitée | 50  | 5000 | 246 000 | illimité  |

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Chat</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/chat-completions.md">Chat completions</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-3c131e6a391c0e543f1a997e8d168a64840b62d3%2Fmessage.svg?alt=media">message.svg</a></td></tr><tr><td><strong>Reasoning</strong></td><td>/v1/chat/completions</td><td><a href="https://github.com/betagouv/doc.albert-api/tree/main/guides/reasoning.md">https://github.com/betagouv/doc.albert-api/tree/main/guides/reasoning.md</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-aafd92ec83b34abdcbda5d3a6dd2697de06ce363%2Fbrain.svg?alt=media">brain.svg</a></td></tr><tr><td><strong>Function calling</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/function-calling.md">Function calling &amp; outils</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-f29cbc6060b51ddf8b14c79274064d297b51b503%2Fscrewdriver-wrench.svg?alt=media">screwdriver-wrench.svg</a></td></tr></tbody></table>

{% hint style="info" icon="screwdriver-wrench" %}
**Comportement du function calling**

Sans le streaming, modèle renvoie un tool call avec un content vide. En streaming, les arguments sont fragmentés sur plusieurs chunks SSE, et le finish\_reason: "tool\_calls" arrive dans un chunk distinct qui ne contient plus de tool\_calls.
{% endhint %}

</details>

<details>

<summary>lightonocr-2-1b</summary>

Modèle multimodal spécialisé pour l'OCR. Il est le modèle de référence pour l'OCR sur Albert API.

<a href="https://huggingface.co/lightonai/LightOnOCR-2-1B" class="button secondary">Model card</a> <a href="https://albert.playground.etalab.gouv.fr" class="button primary">Essayer dans Playground</a>

|                          |                                              |
| ------------------------ | -------------------------------------------- |
| **Nombre de paramètres** | 1B                                           |
| **Licence**              | Apache 2.0                                   |
| **Type**                 | `text-generation`                            |
| **Aliases**              | `lighton/LightOn-OCR-2-1B`, `openweight-ocr` |
| **Fenêtre de contexte**  | 16384                                        |

{% hint style="success" icon="lightbulb" %}
Nous observons certaines latences lorsque certains patterns de pixels sont présents dans l'image (un QR code par exemple). Si vous observez des latences élevées, essayez de supprimer ces patterns avant d'envoyer l'image au modèle.
{% endhint %}

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM | RPD    | TPM     | TPD       |
| ------------------ | --- | ------ | ------- | --------- |
| Expérimentation    | 50  | 1000   | 128 000 | 2 460 000 |
| Production limitée | 100 | 50 000 | 246 000 | illimité  |

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>OCR (chat)</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/ocr.md">OCR</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-3e59a4aa3fcbc420779d2959be8976c1bc8b52e3%2Fimages.svg?alt=media">images.svg</a></td></tr></tbody></table>

</details>

<details>

<summary>ministral-3-8b-instruct-2512</summary>

Modèle multimodal généraliste de petite taille, idéal pour des tâches simples comme de la classification ou de correction de texte.

<a href="https://huggingface.co/mistralai/Ministral-3-8B-Instruct-2512" class="button secondary">Model card</a> <a href="https://albert.playground.etalab.gouv.fr" class="button primary">Essayer dans Playground</a>

|                             |                                                              |
| --------------------------- | ------------------------------------------------------------ |
| **Nombre de paramètres**    | 8.9B                                                         |
| **Type**                    | `text-generation`                                            |
| **Licence**                 | Apache 2.0                                                   |
| **Aliases**                 | `mistralai/Ministral-3-8B-Instruct-2512`, `openweight-small` |
| **Format d'entrées**        | `text`, `image`                                              |
| **Fenêtre de contexte**     | 262144                                                       |
| **Température recommandée** | 0.1                                                          |

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM | RPD    | TPM     | TPD       |
| ------------------ | --- | ------ | ------- | --------- |
| Expérimentation    | 50  | 1000   | 128 000 | 2 460 000 |
| Production limitée | 100 | 50 000 | 246 000 | illimité  |

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Chat</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/chat-completions.md">Chat completions</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-3c131e6a391c0e543f1a997e8d168a64840b62d3%2Fmessage.svg?alt=media">message.svg</a></td></tr><tr><td><strong>Analyse d'image</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/chat-completions.md">Chat completions</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-6b79e285b0dc48d2628f90ba0dd7ef88755bbcaa%2Feye.svg?alt=media">eye.svg</a></td></tr><tr><td><strong>Function calling</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/function-calling.md">Function calling &amp; outils</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-f29cbc6060b51ddf8b14c79274064d297b51b503%2Fscrewdriver-wrench.svg?alt=media">screwdriver-wrench.svg</a></td></tr></tbody></table>

{% hint style="info" icon="screwdriver-wrench" %}
**Comportement du function calling**

Sans le streaming, modèle renvoie un tool call avec un content vide. En streaming, les arguments sont fragmentés sur plusieurs chunks SSE, et le finish\_reason: "tool\_calls" arrive dans un chunk distinct qui ne contient plus de tool\_calls.
{% endhint %}

</details>

<details>

<summary>mistral-medium-3-5 <img src="https://img.shields.io/badge/mod%C3%A8le_partenaire-red" alt="modèle partenaire"></summary>

Modèle dense multimodal pour l'instruction, le raisonnement, le code et l'analyse d'images. L'identifiant `mistral-medium-2508` reste accepté comme alias.

<a href="https://huggingface.co/mistralai/Mistral-Medium-3.5-128B" class="button secondary">Model card</a>

|                          |                                                                                    |
| ------------------------ | ---------------------------------------------------------------------------------- |
| **Nombre de paramètres** | 128B                                                                               |
| **Type**                 | `image-text-to-text`                                                               |
| **Licence**              | Modified MIT                                                                       |
| **Aliases**              | `mistral-medium-2508`, `mistralai/Mistral-Medium-3.5-128`, `mistral-medium-latest` |
| **Format d'entrées**     | `text`, `image`                                                                    |
| **Fenêtre de contexte**  | 262144                                                                             |

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

{% hint style="warning" %}
Ce modèle accessible uniquement aux ministères partenaires qui en font la demande. Vous pouvez utiliser le modèle `gpt-oss-120b` comme alternative à ce modèle.
{% endhint %}

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Chat</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/chat-completions.md">Chat completions</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-3c131e6a391c0e543f1a997e8d168a64840b62d3%2Fmessage.svg?alt=media">message.svg</a></td></tr><tr><td><strong>Analyse d'image</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/chat-completions.md">Chat completions</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-6b79e285b0dc48d2628f90ba0dd7ef88755bbcaa%2Feye.svg?alt=media">eye.svg</a></td></tr><tr><td><strong>Reasoning</strong></td><td>/v1/chat/completions</td><td><a href="https://github.com/betagouv/doc.albert-api/tree/main/guides/reasoning.md">https://github.com/betagouv/doc.albert-api/tree/main/guides/reasoning.md</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-aafd92ec83b34abdcbda5d3a6dd2697de06ce363%2Fbrain.svg?alt=media">brain.svg</a></td></tr><tr><td><strong>Tool calling</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/function-calling.md">Function calling &amp; outils</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-f29cbc6060b51ddf8b14c79274064d297b51b503%2Fscrewdriver-wrench.svg?alt=media">screwdriver-wrench.svg</a></td></tr></tbody></table>

</details>

<details>

<summary>mistral-ocr-2512 <img src="https://img.shields.io/badge/mod%C3%A8le_partenaire-red" alt="modèle partenaire"></summary>

Modèle d'OCR compatible avec la pile Document AI de Mistral (`/v1/ocr`) permettant d’extraire du texte et des images entremêlés.

<a href="https://mistral.ai/news/mistral-ocr-3/" class="button secondary">Model card</a> <a href="https://albert.playground.etalab.gouv.fr" class="button primary">Essayer dans Playground</a>

|                          |                    |
| ------------------------ | ------------------ |
| **Nombre de paramètres** | 3B                 |
| **Type**                 | `image-to-text`    |
| **Licence**              | `propriétaire`     |
| **Aliases**              | `mistral-ocr-2512` |
| **Fenêtre de contexte**  | 16384              |

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

{% hint style="warning" %}
Ce modèle accessible uniquement aux ministères partenaires qui en font la demande. Vous pouvez utiliser le modèle `lightonocr-2-1b` comme alternative à ce modèle.
{% endhint %}

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Mistral Document AI</strong></td><td>/v1/ocr</td><td><a href="https://github.com/betagouv/doc.albert-api/tree/main/guides/mistral-document-ai.md">https://github.com/betagouv/doc.albert-api/tree/main/guides/mistral-document-ai.md</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-131597f7ace14908e58f1414aed134919cf1def0%2Ffile-image.svg?alt=media">file-image.svg</a></td></tr></tbody></table>

</details>

<details>

<summary>mistral-small-3-2-24b-instruct-2506</summary>

Modèle de chat pour des tâches d'une complexité modérée et d'analyse d'images.

<a href="https://huggingface.co/mistralai/Mistral-Small-3.2-24B-Instruct-2506" class="button secondary">Model card</a> <a href="https://albert.playground.etalab.gouv.fr" class="button primary">Essayer dans Playground</a>

|                             |                                                                      |
| --------------------------- | -------------------------------------------------------------------- |
| **Nombre de paramètres**    | 24B                                                                  |
| **Type**                    | `text-generation`                                                    |
| **Licence**                 | Apache 2.0                                                           |
| **Aliases**                 | `mistralai/Mistral-Small-3.2-24B-Instruct-2506`, `openweight-medium` |
| **Format d'entrées**        | `text`, `image`                                                      |
| **Fenêtre de contexte**     | 131072                                                               |
| **Température recommandée** | 0.15                                                                 |

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM | RPD    | TPM     | TPD       |
| ------------------ | --- | ------ | ------- | --------- |
| Expérimentation    | 50  | 1000   | 128 000 | 2 460 000 |
| Production limitée | 100 | 50 000 | 246 000 | illimité  |

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Chat</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/chat-completions.md">Chat completions</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-3c131e6a391c0e543f1a997e8d168a64840b62d3%2Fmessage.svg?alt=media">message.svg</a></td></tr><tr><td><strong>Analyse d'image</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/chat-completions.md">Chat completions</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-6b79e285b0dc48d2628f90ba0dd7ef88755bbcaa%2Feye.svg?alt=media">eye.svg</a></td></tr><tr><td><strong>Function calling</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/function-calling.md">Function calling &amp; outils</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-f29cbc6060b51ddf8b14c79274064d297b51b503%2Fscrewdriver-wrench.svg?alt=media">screwdriver-wrench.svg</a></td></tr></tbody></table>

{% hint style="info" icon="screwdriver-wrench" %}
**Comportement du function calling**

Sans le streaming, modèle renvoie un tool call avec un content vide. En streaming, les arguments sont fragmentés sur plusieurs chunks SSE, et le finish\_reason: "tool\_calls" arrive dans un chunk distinct qui ne contient plus de tool\_calls.
{% endhint %}

</details>

<details>

<summary>qwen3-coder-30b-a3b-instruct</summary>

<a href="https://huggingface.co/Qwen/Qwen3-Coder-30B-A3B-Instruct" class="button secondary">Model card</a> <a href="https://albert.playground.etalab.gouv.fr" class="button primary">Essayer dans Playground</a>

|                                 |                                                        |
| ------------------------------- | ------------------------------------------------------ |
| **Nombre de paramètres**        | 30.5B                                                  |
| **Nombre de paramètres actifs** | 3.3B                                                   |
| **Type**                        | `text-generation`                                      |
| **Licence**                     | Apache 2.0                                             |
| **Aliases**                     | `Qwen/Qwen3-Coder-30B-A3B-Instruct`, `openweight-code` |
| **Fenêtre de contexte**         | 262144                                                 |

MoE orienté code / agentic coding (function calling).

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM | RPD    | TPM     | TPD       |
| ------------------ | --- | ------ | ------- | --------- |
| Expérimentation    | 50  | 1000   | 128 000 | 2 460 000 |
| Production limitée | 100 | 50 000 | 246 000 | illimité  |

### Capacités

{% hint style="info" icon="screwdriver-wrench" %}
**Comportement du function calling**

Sans le streaming, modèle renvoie un tool call avec un content non vide. En streaming, quand le tool call est valide, les arguments sont fragmentés sur plusieurs chunks SSE, et le finish\_reason: "tool\_calls" arrive dans un chunk distinct qui ne contient plus de tool\_calls.
{% endhint %}

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Code</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/code.md">Coder avec Albert API</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-6fc47c006df8d57356f182fd20dc7ea88a0218eb%2Fterminal.svg?alt=media">terminal.svg</a></td></tr><tr><td><strong>Function calling</strong></td><td>/v1/chat/completions</td><td><a href="/albert-api/guides/function-calling.md">Function calling &amp; outils</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-f29cbc6060b51ddf8b14c79274064d297b51b503%2Fscrewdriver-wrench.svg?alt=media">screwdriver-wrench.svg</a></td></tr></tbody></table>

</details>

<details>

<summary>qwen3-vl-embedding-8b <img src="https://img.shields.io/badge/mod%C3%A8le_en_exp%C3%A9rimentation-green" alt="modèle en expérimentation"></summary>

Embeddings multimodaux (texte, images, captures d’écran, vidéos).

{% hint style="warning" %}
Ce modèle est en phase d'expérimentation du 26 juillet 2026 au 1er octobre 2026. A l'issue de cette phase d'expérimentation nous évaluerons a l'aide de vos retours si le modèle est viable pour une intégration pérenne dans Albert API.
{% endhint %}

<a href="https://huggingface.co/Qwen/Qwen3-VL-Embedding-8B" class="button secondary">Model card</a>

|                                     |                              |
| ----------------------------------- | ---------------------------- |
| **Nombre de paramètres**            | 8B                           |
| **Type**                            | `text-embeddings-inference`  |
| **Licence**                         | Apache 2.0                   |
| **Aliases**                         | `Qwen/Qwen3-VL-Embedding-8B` |
| **Fenêtre de contexte**             | 32768                        |
| **Dimension maximale des vecteurs** | 4096\*                       |

\*La dimension des vecteurs n'est pas modifiable avec ce modèle.

{% hint style="warning" %}
Ne mélangez pas les vecteurs générés par ce modèle avec un autre modèle d'embeddings : ils ne sont pas comparables.
{% endhint %}

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM | RPD    | TPM      | TPD      |
| ------------------ | --- | ------ | -------- | -------- |
| Expérimentation    | 50  | 1000   | illimité | illimité |
| Production limitée | 100 | 50 000 | illimité | illimité |

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Text vectorisation</strong></td><td>/v1/embeddings</td><td><a href="/albert-api/guides/embeddings.md">Embeddings</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-81b14c9906eb5b7c4462622ae5c87d2f8852ff23%2Farrow-up-1-9.svg?alt=media">arrow-up-1-9.svg</a></td></tr></tbody></table>

</details>

<details>

<summary>whisper-large-v3</summary>

<a href="https://huggingface.co/openai/whisper-large-v3" class="button secondary">Model card</a> <a href="https://transcripts.numerique.gouv.fr/" class="button primary">Essayer dans Transcripts</a>

|                          |                                               |
| ------------------------ | --------------------------------------------- |
| **Nombre de paramètres** | 1.55B                                         |
| **Type**                 | `automatic-speech-recognition`                |
| **Licence**              | Apache 2.0                                    |
| **Aliases**              | `openai/whisper-large-v3`, `openweight-audio` |
| **Fenêtre de contexte**  | Fichier audio jusqu'à 20 MB                   |

**Limites d'usage** ([en savoir plus](/albert-api/compte-and-usage/quotas.md))

| Tier               | RPM | RPD  | TPM      | TPD      |
| ------------------ | --- | ---- | -------- | -------- |
| Expérimentation    | 50  | 1000 | illimité | illimité |
| Production limitée | 100 | 5000 | illimité | illimité |

### Capacités

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Transcription</strong></td><td>/v1/audio/transcriptions</td><td><a href="https://github.com/betagouv/doc.albert-api/tree/main/guides/audio-transcriptions.md">https://github.com/betagouv/doc.albert-api/tree/main/guides/audio-transcriptions.md</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-fd076e7d329dd6fe8a5b426572ad2015c702171c%2Fmicrophone.svg?alt=media">microphone.svg</a></td></tr><tr><td><strong>Diarization</strong></td><td>/v1/audio/transcriptions</td><td><a href="https://github.com/betagouv/doc.albert-api/tree/main/guides/audio-transcriptions.md">https://github.com/betagouv/doc.albert-api/tree/main/guides/audio-transcriptions.md</a></td><td><a href="https://250800819-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3Kt6ArO8RlWHs4cxZZIu%2Fuploads%2Fgit-blob-700695d32a3a21c5c1680ba9f182ae7d3f434c79%2Fcomments.svg?alt=media">comments.svg</a></td></tr></tbody></table>

</details>

## Calendrier des migrations

<table><thead><tr><th>Modèle</th><th width="290.83984375">Supprimé le</th><th>Remplacer par</th></tr></thead><tbody><tr><td><a href="#qwen3-coder-30b-a3b-instruct"><code>qwen3-coder-30b-a3b-instruct</code></a></td><td>31 octobre 2026</td><td><a href="#deepseek-v4-flash"><code>deepseek-v4-flash</code></a></td></tr><tr><td><a href="#mistral-small-3-2-24b-instruct-2506"><code>mistral-small-3-2-24b-instruct-2506</code></a></td><td>1er décembre 2026</td><td><a href="#gemma-4-31b-it"><code>gemma-4-31b-it</code></a></td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://guides.ia.numerique.gouv.fr/albert-api/modeles/available-models.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.