> 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/ressources/faq.md).
# Foire aux questions (FAQ)
Besoin d'aide ? On vous répond !
Pourquoi mon compte n'est pas autorisé ?
Lors de votre connexion au [playground](https://albert.playground.etalab.gouv.fr/) d'Albert API via ProConnect, vous arrivez sur la page suivante vous indiquant que votre accès n'est pas autorisé.
{% hint style="info" icon="circle-info" %}
Si vous souhaitez vous connecter avec un autre compte **cliquez sur *****Logout pour réinitialiser la connexion**.*
{% endhint %}
**4 cas de figures vous permettent d'accéder à Albert API :**
1. **🇫🇷 Je suis une administration de l'État ou un organisme sous sa tutelle**
Par principe, la condition d'accès à Albert API est d'appartenir une administration de l'État ou un organisme sous sa tutelle ([en savoir plus](#comment-savoir-si-je-suis-eligible-a-lacces-a-albert-api)).
Si vous êtes dans ce cas, vous devez impérativement vous connectez avec votre adresse professionnelle. En effet, cette condition est évaluée directement par ProConnect, pas par Albert API.
Si malgré l'utilisation de votre adresse professionnelle votre compte est toujours bloqué, il convient alors de réaliser une demande d'accès aux produits et services mis à disposition par la DINUM pour autoriser votre administration. Pour cela vous rendez-vous sur le [DataPass](https://datapass.api.gouv.fr/formulaires/produits_dinum/demande/nouveau) dédié.
Veillez à fournir toutes les informations qui vous sembleraient utiles à porter à notre connaissance pour déterminer votre lien avec l'État.
2. **🏢 Je suis une entreprise privée souhaitant intégrer Albert API**
Vous êtes une entreprise privée et vous souhaitez proposer Albert API comme API d'inférence de votre service pour vos clients administration publiques.
⚠️ Pour être éligible, vos clients doivent être des administrations de l'État ou des organismes sous sa tutelle ([en savoir plus](#comment-savoir-si-je-suis-eligible-a-lacces-a-albert-api)).
Dans ce cas, nous vous mettons à disposez un accès "bac à sable" limité afin que vous puissiez intégrer au mieux Albert API dans votre service. Pour en faire la demande, merci de nous écrire à l'adresse suivante [albert.api@numerique.gouv.fr](mailto:albert.api@numerique.gouv.fr?subject=Demande%20entreprise%20d%27acc%C3%A8s%20%C3%A0%20Albert%20API).
3. **👤 Je suis une administration territoriale relevant d'une co-tutelle de l'État**
Par principe, les administrations territoriales ne sont pas éligible à l'accès à Albert API. En effet, seules les administrations de l'État ou les organismes sous sa tutelle peuvent y prétendre.
Toutefois, certaines administrations territoriales disposent d'une co-tutelle de l'État ([en savoir plus](#comment-savoir-si-je-releve-dune-administration-de-letat-ou-dun-organisme-sous-sa-tutelle)). Dans ce cas, vous devez impérativement vous connectez avec votre adresse professionnelle. En effet, cette condition est évaluée directement par ProConnect, pas par Albert API.
Si malgré l'utilisation de votre adresse professionnelle votre compte est toujours bloqué, il convient alors de réaliser une demande d'accès aux produits et services mis à disposition par la DINUM pour autoriser votre administration. Pour cela vous rendez-vous sur le [DataPass](https://datapass.api.gouv.fr/formulaires/produits_dinum/demande/nouveau) dédié.
Veillez à fournir toutes les informations qui vous sembleraient utiles à porter à notre connaissance pour déterminer votre lien avec l'État.
4. **🤝 Je suis association chargée d'une mission de service publique**
Par principe, les associations ne sont pas éligible à l'accès à Albert API. En effet, seules les administrations de l'État ou les organismes sous sa tutelle peuvent y prétendre.
Toutefois, certaines associations chargée d'une mission de service publique disposent d'une co-tutelle de l'État ([en savoir plus](#comment-savoir-si-je-releve-dune-administration-de-letat-ou-dun-organisme-sous-sa-tutelle)). Dans ce cas, vous devez impérativement vous connectez avec votre adresse professionnelle. En effet, cette condition est évaluée directement par ProConnect, pas par Albert API.
Si malgré l'utilisation de votre adresse professionnelle votre compte est toujours bloqué, il convient alors de réaliser une demande d'accès aux produits et services mis à disposition par la DINUM pour autoriser votre administration. Pour cela vous rendez-vous sur le [DataPass](https://datapass.api.gouv.fr/formulaires/produits_dinum/demande/nouveau) dédié.
Veillez à fournir toutes les informations qui vous sembleraient utiles à porter à notre connaissance pour déterminer votre lien avec l'État.
{% hint style="info" icon="lightbulb" %}
Nous vous recommandons d'utiliser une adresse mail de service pour gérer vos accès en production d'Albert API.
{% endhint %}
**Vous ne vous reconnaissez pas dans un de ces cas ?**
Malheureusement vous n'êtes pas éligible à Albert API. Si vous pensez qu'il s'agit d'une erreur vous pouvez nous écrire à l'adresse suivante [albert.api@numerique.gouv.fr](mailto:albert.api@numerique.gouv.fr?subject=Demande%20non%20%C3%A9ligible%20d%27acc%C3%A8s%20%C3%A0%20Albert%20API%20).
Comment savoir si je relève d'une administration de l'État ou d'un organisme placé sous sa tutelle ?
La DINUM met à disposition ses services, dont fait partie Albert API, aux administrations de l’État et aux organismes placés sous sa tutelle.
Pour ce deuxième cas, la tutelle de l'État n'a pas l'obligation d'être exclusive. En effet, une co-tutelle suffit pour être éligible à Albert API. Cela concerne par exemple certaines administrations territoriales ou associations chargées d'une mission d'intérêt général.
Ce lien avec l'État est déterminé dans les documents qui définissent vos activités (loi, décret, arrêté, convention constitutive, statuts, etc.). **En cas de difficultés rapprochez vous de votre service juridique.**
Tous les organismes répondant à ce critère ne sont pas systématiquement référencé par ProConnect. Pour corriger cela, la DINUM met à votre disposition un [DataPass](https://datapass.api.gouv.fr/formulaires/produits_dinum/demande/nouveau) afin de réaliser **une demande d'accès aux produits et services mis à disposition par la DINUM.**
Veillez à fournir toutes les informations qui vous sembleraient utiles à porter à notre connaissance pour déterminer votre lien avec l'État.
Pourquoi mon appel API est bloqué par la politique CORS ?
Albert API ne renvoie pas l'en-tête `Access-Control-Allow-Origin` dans ses réponses car l'API n'est pas destinée à être appelée depuis un navigateur.
Nous n'activons volontairement pas CORS sur cette API. L'API est destinée à être consommée par des applications serveur, où la clef d'authentification peut être conservée de manière sécurisée. Autoriser les appels depuis un navigateur encouragerait l'exposition de jetons d'API dans du code JavaScript, ce qui constitue une mauvaise pratique de sécurité. Les applications web doivent appeler cette API via leur propre backend, qui est responsable de protéger les identifiants d'accès.
Pourquoi l'API renvoi une erreur 503 « Model is too busy » ?
Lorsque le modèle moteur est saturé, c'est-à-dire qu'il reçoit trop de requête, les endpoints concernés peuvent répondre une erreur **503** **« Model is too busy »**.
Cette situation est temporaire. Pour prévenir ce problème en production nous vous recommandons de mettre en place une balance automatique de vos requête (fallback) vers un autre modèle. Pour vous aidez, Albert API met à disposition un endpoint `GET /health/models` pour surveiller l'état de chaque modèle (voir [API reference - Health](/albert-api/api-reference/liste-des-endpoint/health.md#get-health-models)).
Est-ce que je peux avoir une clef d'API sans expiration ?
Non, il est impossible d'obtenir une clef d'API sans expiration pour des raisons de sécurité. Toutes les clefs d'API ont une date d'expiration de maximum 1 an à compter de la date de création. Vous pouvez configurer une clef avec une date d'expiration inférieure à 1 an lors de la création.
Pourquoi le playground m'affiche une erreur "removeChild" ?
Si vous rencontrez l'erreur si dessous en vous connectant au playground d'Albert API, cette erreur est due à un bug dans le code JavaScript de votre navigateur.
Elle se produit lorsque le navigateur cherche à traduire la page web. Pour corriger cette erreur, vous devez désactiver les extensions de traduction qui sont actives dans votre navigateur.
Si cela ne suffit pas, vous pouvez contacter le support en vous rendant sur la page [Support](/albert-api/ressources/support.md).
Qu'est ce qu'un token ?
Un token est une unité de mesure de la consommation des LLM. Un token correspond à un mot ou une partie de mot.
Exemple :
* "Albert" → 1 token
* "centraliser" → 2 tokens ("centr" et "aliser")
{% hint style="info" %}
La ponctuation est comptabilisée comme un token !
{% endhint %}
Le *tokenizer*, c'est-à-dire l'algorithme permettant de transformer le texte en tokens, est généralement celui du modèle utilisé. Sur Albert API, pour que toutes les requêtes soient comptabilisées dans les mêmes conditions, nous utilisons un tokenizer opensource, [*Tiktoken o200k\_base*](https://github.com/openai/tiktoken).
Vous pouvez tester le tokenizer sur des textes sur [ce simulateur](https://tiktokenizer.vercel.app/?model=o200k_base).
---
# 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/ressources/faq.md?ask=&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.
