---
title: "FAQ sur l'accès à l'API"
description: "Trouvez rapidement les réponses aux questions fréquentes sur l'URL de base, les modèles, le streaming, les clients, les délais d'attente et la surveillance de la disponibilité."
headingIds: {"Adresse, clés et modèles":"section-1","Requêtes et clients":"section-2","État du service et aide":"section-3"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentation maintenue par [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Sources et corrections](https://1zheai.com/en/editorial/).

Vous avez trouvé une erreur ? [Contactez l'assistance](mailto:support@1zheai.com) en indiquant l'adresse de la page et une description. N'envoyez pas de clés API ni d'identifiants de compte.

</aside>
## Adresse, clés et modèles

<AccordionGroup>
<Accordion title="Faut-il inclure /v1 dans l'URL de base ?">

Pour le SDK OpenAI, renseignez `https://1zheai.com/v1` ; pour le SDK Anthropic et Claude Code, renseignez `https://1zheai.com`. Lorsque vous utilisez directement curl, indiquez le chemin complet de la requête. Certains outils de bureau complètent automatiquement le chemin, voir le [tableau de correspondance des adresses ](/fr/docs/base-url/).

</Accordion>
<Accordion title="Avec un abonnement ChatGPT ou Claude, une clé de ce site est-elle nécessaire ?">

Oui. L'accès sur ce site utilise une clé API créée dans la console de ce site ; l'abonnement des clients grand public et les identifiants API de ce site sont des modes d'accès différents. L'outil doit également prendre en charge un fournisseur ou une URL d'API personnalisés.

</Accordion>
<Accordion title="Le modèle figure dans la liste, pourquoi l'appel échoue-t-il ?">

La liste affiche les modèles visibles avec la clé actuelle, pas le taux de réussite d'inférence en temps réel. Vérifiez également le protocole d'interface, les paramètres optionnels et l'état en amont, voir l'[interface d'interrogation des modèles ](/fr/docs/api-models/).

</Accordion>
<Accordion title="Peut-on reprendre tels quels les noms de modèles d'autres plateformes ?">

Copiez l'ID complet depuis la liste des modèles de ce site. Différents fournisseurs peuvent utiliser des préfixes, des alias et des versions datées différents ; ne devinez pas les renommages. Voir le [guide de migration ](/fr/docs/migration/) pour les étapes de migration.

</Accordion>
</AccordionGroup>

## Requêtes et clients

<AccordionGroup>
<Accordion title="Appel réussi, mais aucun texte obtenu ?">

Vérifiez d'abord le protocole de réponse. Chat Completions lit `choices[].message.content`, Messages parcourt les blocs de texte `content`, Responses parcourt `output` ou utilise le `output_text` du SDK. Les réponses d'appel d'outil peuvent aussi ne contenir aucun texte normal.

</Accordion>
<Accordion title="Pourquoi le contenu du tour précédent n'a-t-il pas été mémorisé ?">

Les conversations multi-tours nécessitent que le client transmette l'historique. Réutiliser la même clé ne crée pas automatiquement une session côté serveur. Les extensions liées à la session de Responses doivent être confirmées séparément ; ne comptez pas dessus par défaut.

</Accordion>
<Accordion title="Le streaming a reçu du texte, est-ce un succès ?">

Il faut aussi confirmer l'événement de fin ou l'état final. Des erreurs en cours de flux, des interruptions de flux et des troncatures de sortie peuvent survenir après avoir déjà reçu une partie du texte. Voir [sortie en streaming ](/fr/docs/streaming/) pour plus de détails.

</Accordion>
<Accordion title="Peut-on réessayer indéfiniment après un délai d'attente dépassé ?">

Déconseillé. Un délai d'attente peut survenir après que la requête a déjà été traitée. Consultez d'abord les journaux d'appel, puis effectuez les tentatives avec un nombre limité, un backoff et un temps d'attente total, en évitant que le SDK et l'application ne fassent chacun une tentative. Voir [délais d'attente et tentatives ](/fr/docs/retries/).

</Accordion>
<Accordion title="Peut-on mettre la clé API directement dans le front-end web ?">

N'intégrez pas la clé dans un script de navigateur ou un dépôt public. Faites détenir les identifiants par votre serveur et appelez l'interface depuis celui-ci ; le navigateur ne se connecte qu'à votre propre backend ; les variables d'environnement dans le code de démonstration sont destinées au serveur ou au terminal local.

</Accordion>
</AccordionGroup>

## État du service et aide

<AccordionGroup>
<Accordion title="Le suivi du temps d'exécution est normal, pourquoi le modèle renvoie-t-il une erreur ?">

La surveillance vérifie l'accessibilité HTTP du site officiel, de la console et de l'entrée API ; elle ne représente pas le taux de réussite d'inférence de chaque modèle. La surveillance est déployée sur le même serveur que l'application ; en cas de panne de la machine entière, la surveillance est également suspendue ; les données historiques s'accumulent à partir de l'activation.

</Accordion>

<Accordion title="Que faut-il préparer pour contacter l'assistance ?">

Fournissez l'heure et le fuseau horaire de l'incident, la version du client, l'ID du modèle, le chemin complet de la requête, le code d'état HTTP, l'ID de requête et les informations d'erreur masquées. Supprimez la clé, l'en-tête d'authentification et le contenu des conversations privées ; vous pouvez organiser les informations selon le [modèle de diagnostic ](/fr/docs/troubleshooting/).

</Accordion>
</AccordionGroup>