# 1折AI · Documentation complète
# Documentation 1ZheAI
Source: https://1zheai.com/fr/docs/
Markdown: https://1zheai.com/fr/docs/index.md
---
title: "Documentation 1ZheAI"
description: "Points d'entrée pour l'API de modèle, les comptes prêts à l'emploi et la recharge d'abonnement, conditions d'achat, commandes et règles de service après-vente."
headingIds: {"Intégration de l’API de modèle":"section-1","Que souhaitez-vous faire":"section-2","Consultation et assistance":"section-3","Questions les plus fréquentes avant utilisation":"section-4","Aide-mémoire développeur":"section-5"}
---
Commencez par votre besoin : connecter une API de modèles, acheter un compte IA ou activer un abonnement sur un compte existant.
Confirmez la plateforme, le palier d'abonnement, le contenu livré et les précautions pour la première connexion.Vérifiez les conditions du compte, les informations requises et la procédure d'activation.Confirmez la région, la durée de validité, la méthode d'échange et les comptes concernés.Consultez les règles d'annulation, d'anomalie de livraison, de bannissement et de remboursement.
## Intégration de l’API de modèle
1折AI fournit les API Claude et OpenAI / GPT, prenant en charge Anthropic Messages, OpenAI Responses et Chat Completions. Les points d'accès courants incluent : l'API native Anthropic `/v1/messages`, ainsi que l'API compatible OpenAI `/v1/chat/completions`. Votre code et vos outils ne nécessitent généralement que deux modifications : l'URL de base et la clé API (API key).
```text
Anthropic Base URL https://1zheai.com
OpenAI Base URL https://1zheai.com/v1
API Key sk-...（在控制台创建）
```
Les entrées et sorties Claude sont facturées selon la remise de chaque modèle ; la lecture et l'écriture du cache sont facturées au prix officiel, sans remise. Les prix et unités de facturation de GPT, MiMo et des modèles de génération d'images sont consultables dans [Modèles et tarifs](https://1zheai.com/en/pricing/).
Claude, GPT, MiMo et les modèles de génération d'images sont en ligne ; la liste complète est consultable dans [Modèles pris en charge](/fr/docs/models/).
## Que souhaitez-vous faire
Claude Code, Codex CLI, Cursor, Cline, Cherry Studio et CC Switch. Consultez d'abord la portée de la prise en charge, puis configurez selon les étapes.Commencez avec l'Anthropic SDK, l'OpenAI SDK ou curl, puis poursuivez avec la sortie en flux (streaming).Documentation lisible par machine, liste des pages et description d'intégration IA copiable.Inscrivez-vous, créez une clé API et effectuez votre première requête.
## Consultation et assistance
Recherchez les points d'accès, protocoles, exemples et portée de compatibilité.Consultez les frais, l'historique des appels et les pistes de dépannage.
## Questions les plus fréquentes avant utilisation
Vérifiez les champs de réponse et l'utilisation ; ces vérifications ne peuvent pas prouver à elles seules l'origine du modèle.
Comment activer le cache, comment voir les succès de cache, et l'économie obtenue après un succès.
Que signifient respectivement 401, 404, 429 et 5xx.
Moyens de paiement, remboursement sous 7 jours, règles de facturation.
## Aide-mémoire développeur
| Votre tâche | À consulter directement |
| --- | --- |
| Écrire du code pour la première fois | [Exemple complet exécutable](/fr/docs/code-examples/) |
| Migrer depuis une autre plateforme | [Guide de migration](/fr/docs/migration/) |
| Interroger les modèles et protocoles | [Recherche de modèles](/fr/docs/api-models/) · [Référence de l'interface](/fr/docs/api-reference/) |
| Gérer les délais d'attente et la limitation de débit | [Délais d'attente et nouvelles tentatives](/fr/docs/retries/) |
| Rechercher des questions courantes | [FAQ d'intégration](/fr/docs/faq/) |
---
# Démarrage rapide
Source: https://1zheai.com/fr/docs/quickstart/
Markdown: https://1zheai.com/fr/docs/quickstart.md
---
title: "Démarrage rapide"
description: "Créez une clé API 1zheai, appelez Claude / GPT via curl ou un SDK, puis connectez-vous à vos clients habituels."
headingIds: {"Vous pouvez aussi commencer par GPT":"section-1","Étape suivante":"section-2"}
---
Objectif : obtenir une clé API (API key) en 5 minutes et effectuer votre première requête Claude ou GPT.
Ouvrez [1zheai.com/register](https://1zheai.com/register?lng=fr) pour vous inscrire. Les appels débitent votre solde à l'usage, il faut donc d'abord recharger. Le solde est en dollars (USD), les moyens de paiement pris en charge sont WeChat, Alipay, Stripe (carte bancaire) et USDT ; les modes précis et les limites de montant sont ceux indiqués sur la page de commande du portefeuille. Dans les 7 jours suivant la recharge, vous pouvez demander le remboursement du principal non utilisé via le même canal de paiement ; la partie déjà consommée et les frais de traitement des paiements ne sont pas remboursés. Règles détaillées dans [Recharges, remboursements et factures](/fr/docs/billing/).
Entrez dans la [console](https://1zheai.com/console?lng=fr), cliquez sur « Clés API » dans le menu de gauche, puis sur « Créer une clé API » en haut à droite, saisissez un nom et enregistrez. La clé API commence par `sk-` ; dans la liste, cliquez sur l'icône de copie pour la copier et la conserver. Détails dans [Obtenir et gérer les clés API](/fr/docs/api-keys/).
Placez la clé API dans une variable d'environnement, puis appelez l'interface native Anthropic avec curl :
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "用一句话解释什么是 HTTP"}]
}'
```
```powershell title="Windows PowerShell"
$env:ONEZHE_API_KEY = "sk-你的Key"
$body = @{
model = "claude-sonnet-5-5"
max_tokens = 128
messages = @(@{ role = "user"; content = "用一句话解释什么是 HTTP" })
} | ConvertTo-Json -Depth 5
Invoke-RestMethod -Uri "https://1zheai.com/v1/messages" -Method Post `
-Headers @{ "x-api-key" = $env:ONEZHE_API_KEY; "anthropic-version" = "2023-06-01" } `
-ContentType "application/json; charset=utf-8" `
-Body ([System.Text.Encoding]::UTF8.GetBytes($body))
```
`ONEZHE_API_KEY` n'est qu'un nom d'exemple ; vous pouvez utiliser n'importe quel nom.
En cas de succès, la réponse est HTTP 200, avec une structure identique à celle de l'officiel. Deux points à vérifier : `model` correspond-il au modèle demandé, et le nombre de tokens dans `usage`. Voici une réponse réellement testée le 2026-10-15 :
```json
{
"model": "claude-sonnet-5-5",
"id": "msg_011Cg3G8HQmyTrnqSBX6o6Pw",
"type": "message",
"role": "assistant",
"content": [
{
"type": "text",
"text": "HTTP(超文本传输协议)是一种基于请求-响应模式的应用层协议,用于在客户端(如浏览器)和服务器之间传输网页、图片、API 数据等内容。"
}
],
"container": null,
"stop_reason": "end_turn",
"stop_sequence": null,
"stop_details": null,
"usage": {
"input_tokens": 530,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"cache_creation": {
"ephemeral_5m_input_tokens": 0,
"ephemeral_1h_input_tokens": 0
},
"output_tokens": 69,
"output_tokens_details": {"thinking_tokens": 0},
"service_tier": "standard",
"inference_geo": "global"
},
"input_transformations": [],
"diagnostics": null,
"context_management": {"applied_edits": []}
}
```
`input_tokens` dépasse la question elle-même de plusieurs centaines : c'est l'invite système que ces clients (curl, SDK, outils tiers) joignent à chaque requête, facturée comme entrée ; Claude Code ne l'joint pas, voir [Facturation de l'invite système](/fr/docs/pricing-explained/#section-3).
Rendez-vous ensuite dans « Journaux d'appels » à gauche de la console pour voir cet appel : heure, clé API utilisée (colonne « Jeton »), modèle, tokens d'entrée / sortie, lecture/écriture du cache et coût.
## Vous pouvez aussi commencer par GPT
Si vous utilisez l'SDK OpenAI ou prévoyez d'intégrer Codex, choisissez directement le protocole GPT. Définissez d'abord `ONEZHE_API_KEY` ci-dessus dans le même terminal, puis exécutez :
```bash
curl --fail-with-body https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","messages":[{"role":"user","content":"用一句话解释 HTTP。"}]}'
```
Il s'agit d'un exemple pour shell macOS / Linux ; sous Windows, exécutez directement [l'exemple Python / Node.js multiplateforme](/fr/docs/code-examples/). Le texte se trouve dans `choices[0].message.content` ; si le modèle ne figure pas dans votre liste, [interrogez d'abord les modèles disponibles](/fr/docs/api-models/). Codex nécessite Responses ; intégrez-le selon [le tutoriel de configuration Codex](/fr/docs/quickstart-codex/).
## Étape suivante
Intégrez-le à vos outils habituels :
Deux variables d'environnement suffisent.
À utiliser si vous ne voulez pas modifier manuellement les fichiers de configuration.
Syntaxe et restrictions d'une URL de base personnalisée.
Vous avez déjà du code OpenAI : modifiez seulement base_url.
Si la requête échoue, consultez d'abord [les codes d'erreur et le dépannage](/fr/docs/troubleshooting/). Pour vérifier les champs renvoyés et l'utilisation, voir [Vérifier le modèle et l'utilisation](/fr/docs/verify-model/).
---
# Obtenir et gérer les clés API
Source: https://1zheai.com/fr/docs/api-keys/
Markdown: https://1zheai.com/fr/docs/api-keys.md
---
title: "Obtenir et gérer les clés API"
description: "Créer des clés API commençant par sk- dans la console 1折AI, ainsi que les stocker, les faire tourner et limiter les dégâts en cas de fuite."
headingIds: {"Créer une clé API":"section-1","Une clé API par outil":"section-2","Où les stocker":"section-3","Que faire en cas de fuite":"section-4","Questions fréquentes":"section-5"}
---
Une clé API (API key) correspond à une autorisation d'appel, et débite le solde de votre compte. Cette page explique comment en créer, où les stocker, et quoi faire en cas de problème.
## Créer une clé API
Ouvrez [1zheai.com/console](https://1zheai.com/console?lng=fr).
Dans le menu de gauche, cliquez sur « Clés API », puis sur « Créer une clé API » en haut à droite. Saisissez un nom qui indique l'usage, par exemple `claude-code-macbook`, `ci-staging` ; les autres champs peuvent rester inchangés, puis cliquez sur « Enregistrer les modifications ».
Champs configurables dans le formulaire :
| Champ du formulaire | Par défaut | Description |
|---|---|---|
| Nom | Vide | Sert à distinguer les clés API dans les journaux d'appels |
| Date d'expiration | Jamais | Optionnel : 1 heure, 1 jour, 1 mois, ou une date et une heure précises |
| Quantité | 1 | Permet d'en créer plusieurs à la fois ; un suffixe aléatoire est ajouté automatiquement au nom |
| Bascule « Quota illimité » | Activée | Lorsqu'elle est désactivée, le champ « Quota (USD) » apparaît ; cette clé API ne peut pas dépenser plus que ce montant en dollars |
| Restriction de modèles (dans « Paramètres avancés ») | Vide, ce qui signifie que tous les modèles sont utilisables | Une fois des modèles sélectionnés, cette clé API ne peut appeler que ces modèles |
| Liste blanche d'IP (dans « Paramètres avancés ») | Vide, ce qui signifie aucune restriction | N'autorise que les IP ou plages CIDR listées à appeler |
Les clés API commencent par `sk-`. Après les avoir copiées, placez-les dans un gestionnaire de mots de passe ou des variables d'environnement ; ne les collez pas dans des conversations, des captures d'écran ou des dépôts de code.
## Une clé API par outil
Il est recommandé de créer une clé API distincte pour chaque outil et chaque machine. Trois avantages :
- Les journaux d'appels sont distingués par clé API ; on voit d'un coup d'œil quel outil a dépensé combien.
- Si une clé API fuite, il suffit de supprimer celle-ci ; les autres outils ne sont pas affectés.
- Dans une équipe, chacun est responsable de sa clé API ; supprimez la clé correspondante lors d'un départ ou d'un changement de machine.
## Où les stocker
```bash title="Shell 配置（macOS / Linux）"
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows（当前用户，持久）"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效
```
```bash title=".env（项目本地）"
# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key
```
Le fichier `.claude/settings.json` au niveau projet de Claude Code est généralement commité dans le dépôt, et la documentation officielle de Claude Code déconseille explicitement d'y écrire des identifiants. Placez la clé API dans le fichier `~/.claude/settings.json` au niveau utilisateur, ou dans le fichier `.claude/settings.local.json` du projet qui n'est pas commité.
## Que faire en cas de fuite
1. Retrouvez-la dans la liste des « Clés API », cliquez sur l'icône « Désactiver » de la colonne « Actions », ou choisissez « Supprimer » dans le menu «⋯ ». Une fois désactivée, elle prend effet immédiatement ; toute tentative d'appel avec elle renverra 401 `Invalid token`.
2. Créez une nouvelle clé API et remplacez l'ancienne là où elle était utilisée.
3. Ouvrez les journaux d'appels (menu de la console « Journaux d'appels »), cliquez sur « Développer », filtrez en saisissant le nom de cette clé API dans « Nom du jeton », et vérifiez si des appels récents n'ont pas été initiés par vous.
## Questions fréquentes
Oui, une clé API n'est pas liée à un outil. Cependant, après un usage mixte, les journaux ne permettent plus de savoir qui a dépensé quoi ; il est donc toujours recommandé d'en créer une par outil.
Dans la plupart des cas, oui. Causes courantes : espaces ou sauts de ligne lors de la copie, clé API supprimée, saisie dans un champ erroné de l'outil. Pour un diagnostic étape par étape, voir[Codes d'erreur et dépannage](/fr/docs/troubleshooting/).
Par défaut, jamais. Lors de la création ou de la modification, vous pouvez définir une date dans « Date d'expiration » ; après expiration, tout appel renverra 401 `Invalid token`, identique à la réponse renvoyée lorsque la clé API est mal saisie. La colonne « Expiration » de la liste affiche la date d'expiration de chaque clé API.
---
# Modèles pris en charge
Source: https://1zheai.com/fr/docs/models/
Markdown: https://1zheai.com/fr/docs/models.md
---
title: "Modèles pris en charge"
description: "Consultez la disponibilité, les identifiants de modèles, les interfaces et les tarifs des modèles Claude, GPT, MiMo et de génération d'images."
headingIds: {"Liste des modèles":"section-1","Les deux interfaces peuvent être appelées":"section-2","Modèles OpenAI / GPT":"section-3","Modèles MiMo":"section-4","Interroger la dernière liste via l’interface":"section-5","Comment choisir":"section-6","Questions fréquentes":"section-7","Modèles d’images et requêtes d’interface":"section-8"}
---
Les modèles Claude, GPT, MiMo et de génération d'images sont en ligne. Ci-dessous sont listés les identifiants de modèles Claude et GPT ; la disponibilité complète fait foi selon le catalogue de modèles et la réponse de l'interface.
Consultez les [modèles et tarifs publics](https://1zheai.com/en/pricing/) pour voir les tarifs ; les utilisateurs connectés peuvent se rendre dans la [console · modèles](https://1zheai.com/model-catalog?lng=fr) pour consulter les modèles et voir les méthodes d'intégration.
## Liste des modèles
Le `model` dans la requête doit correspondre exactement à l'ID du tableau ci-dessous, y compris le suffixe de date.
| ID de modèle | Série | Description |
|---|---|---|
| `claude-fable-5-1` | Fable 5.1 | |
| `claude-fable-5` | Fable 5 | |
| `claude-opus-5-5` | Opus 5.5 | |
| `claude-opus-5` | Opus 5 | |
| `claude-opus-4-8` | Opus 4.8 | |
| `claude-opus-4-7` | Opus 4.7 | |
| `claude-opus-4-6` | Opus 4.6 | |
| `claude-opus-4-5-20251101` | Opus 4.5 | ID de version fixe avec date |
| `claude-sonnet-5-5` | Sonnet 5.5 | |
| `claude-sonnet-5` | Sonnet 5 | |
| `claude-sonnet-4-6` | Sonnet 4.6 | |
| `claude-sonnet-4-5-20250929` | Sonnet 4.5 | ID de version fixe avec date |
| `claude-haiku-5-5` | Haiku 5.5 | |
| `claude-haiku-4-5-20251001` | Haiku 4.5 | ID de version fixe avec date |
Le tarif unitaire de chaque modèle (entrée, sortie, lecture de cache, écriture de cache) figure sur la [page des tarifs](https://1zheai.com/en/pricing/). Les capacités, la longueur de contexte et les notes de publication de chaque modèle font foi selon la [documentation officielle des modèles d'Anthropic](https://platform.claude.com/docs/en/about-claude/models/overview).
## Les deux interfaces peuvent être appelées
Les modèles du tableau ci-dessus peuvent tous être appelés via l'interface native Anthropic `/v1/messages` et l'interface compatible OpenAI `/v1/chat/completions`, avec la même syntaxe d'identifiant de modèle. Lorsque vous avez besoin de paramètres propres à Claude tels que le cache, le thinking ou les appels d'outils, utilisez l'interface native, voir [URL de base et authentification](/fr/docs/base-url/).
## Modèles OpenAI / GPT
- `gpt-5.6-luna`
- `gpt-5.6-sol`
- `gpt-5.6-terra`
- `gpt-6-astra`
GPT peut être utilisé avec le [SDK OpenAI](/fr/docs/quickstart-openai-sdk/) et le [CLI Codex](/fr/docs/quickstart-codex/). Les interfaces et modes de facturation varient selon les modèles ; consultez le [catalogue de modèles de la console](https://1zheai.com/model-catalog?lng=fr) pour les détails.
## Modèles MiMo
Les identifiants, interfaces prises en charge et unités de facturation des modèles texte et voix MiMo figurent sur [modèles et tarifs](https://1zheai.com/en/pricing/). Le texte est facturé par token, la voix selon l'unité de facturation du modèle correspondant ; n'appliquez pas les règles de cache et de remise de Claude.
## Interroger la dernière liste via l’interface
Les modèles peuvent être ajoutés ou retirés selon les publications officielles ; la réponse de l'interface fait foi :
```bash title="用你的 Key 查"
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer sk-你的Key"
```
```bash title="公开价格接口（不需要 Key）"
curl -s https://1zheai.com/api/pricing | jq -r '.data[].model_name'
```
## Comment choisir
Si vous ne savez pas quoi choisir, voici un point de départ :
| Scénario | Recommandation |
|---|---|
| Écriture de code quotidienne, usage principal de Claude Code | `claude-sonnet-5-5` |
| Refactors complexes, problèmes difficiles à diagnostiquer | `claude-opus-5-5` |
| Sous-tâches, résumés, classification et autres tâches légères | `claude-haiku-5-5` |
Pour savoir comment mapper les trois niveaux opus / sonnet / haiku à des modèles spécifiques dans Claude Code, voir [intégration de Claude Code](/fr/docs/quickstart-claude-code/).
## Questions fréquentes
Vérifiez d'abord l'orthographe de l'ID et le suffixe de date, puis utilisez le `/v1/models` ci-dessus pour confirmer que votre clé API (API key) voit ce modèle. Les noms de modèles personnalisés d'autres fournisseurs (par exemple avec préfixe ou suffixe ajouté) ne fonctionnent pas ici.
Lorsque le modèle n'existe pas ou n'est pas disponible actuellement, la passerelle renvoie HTTP 404. Dans la réponse native Anthropic, le `error.type` est `not_found_error` ; dans la réponse compatible OpenAI, le `error.code` est `model_not_found`.
Vérifiez d'abord l'ID et la liste des modèles disponibles pour la clé, ne réessayez pas en boucle le même ID erroné. Un code 503 n'est renvoyé que si le modèle existe mais qu'aucun service amont sain n'est disponible temporairement, voir [codes d'erreur et dépannage](/fr/docs/troubleshooting/).
Dans des conditions normales, le `model` de la réponse correspond à l'ID demandé. S'il ne correspond pas, envoyez l'heure de la requête et la réponse à support@1zheai.com ; vous pouvez aussi effectuer les vérifications décrites dans [vérifier les modèles et l'utilisation](/fr/docs/verify-model/).
## Modèles d’images et requêtes d’interface
Le catalogue public répertorie `gpt-image-1.5` et `chatgpt-image-latest` au 2026-10-16. Voir [intégration de la génération d'images](/fr/docs/api-images/) pour les détails ; les permissions et paramètres réels dépendent de votre clé et du catalogue de modèles.
Pour les exemples complets de l'API des modèles, les deux formats de réponse et la méthode de dépannage lorsque la liste est vide, voir [interroger l'API des modèles disponibles](/fr/docs/api-models/).
---
# Migrer depuis d'autres services vers 1折AI
Source: https://1zheai.com/fr/docs/migration/
Markdown: https://1zheai.com/fr/docs/migration.md
---
title: "Migrer depuis d'autres services vers 1折AI"
description: "Migrez adresse par adresse, clé par clé, modèle par modèle, protocole par protocole et fonction par fonction, en conservant la configuration d'origine réversible."
headingIds: {"Vérifier les quatre configurations ensemble":"section-1","Vérifier dans l’ordre":"section-2","Portée des variables d’environnement":"section-3","Revenir en arrière en cas d’échec de bascule":"section-4"}
---
Avant la migration, enregistrez la configuration d'origine. Vérifiez d'abord dans un terminal ou un environnement de développement séparé, et ne modifiez vos outils habituels ou vos services en production qu'après avoir confirmé le succès.
## Vérifier les quatre configurations ensemble
| Configuration | Syntaxe pour 1折AI | Oubli fréquent |
| --- | --- | --- |
| OpenAI Base URL | `https://1zheai.com/v1` | Écrire en trop `/chat/completions`, ou omettre `/v1` |
| Anthropic Base URL | `https://1zheai.com` | L'SDK ajoute à nouveau une fois `/v1` |
| Clé API | Clé créée dans la console de ce site | Réutiliser la clé de l'ancien fournisseur |
| ID de modèle | ID complet renvoyé par `/v1/models` de ce site | Réutiliser un nom avec le préfixe `vendor/` ou un suffixe personnalisé |
Les requêtes HTTP d'origine nécessitent le chemin complet du point de terminaison ; les SDK et les outils de bureau exigent généralement uniquement la Base URL. Consultez le [tutoriel de l'outil correspondant](/fr/docs/integrations/).
## Vérifier dans l’ordre
Appelez une fois via l'[interface d'interrogation des modèles](/fr/docs/api-models/). En cas d'échec, corrigez d'abord l'adresse, les identifiants ou les conditions d'accès ; n'ajustez pas plusieurs paramètres métier en même temps.
Choisissez [Chat Completions](/fr/docs/api-chat-completions/), [Responses](/fr/docs/api-responses/) ou [Messages](/fr/docs/api-messages/). Conservez le protocole requis par votre client d'origine et retirez d'abord les paramètres optionnels.
Vérifiez successivement le streaming, l'historique multi-tours, l'appel d'outils et les autres capacités requises. N'ajoutez qu'un élément à la fois et conservez les réponses d'erreur comparables. Le succès du texte simple ne prouve pas que les fichiers, la recherche et les modèles auxiliaires de l'Agent sont tous compatibles.
Confirmez l'heure de la requête et le modèle dans les [journaux d'appel](/fr/docs/usage-logs/). Redémarrez les terminaux, IDE ou services d'arrière-plan nécessitant le rechargement de la configuration pour éviter qu'ils utilisent encore les anciennes variables d'environnement.
## Portée des variables d’environnement
Le `export` dans le terminal n'affecte que le shell actuel et les processus enfants lancés par la suite. Les applications de bureau, les conteneurs, les tâches planifiées et les services système peuvent utiliser un autre environnement ; configurez les identifiants là où le programme s'exécute réellement.
Un champ portant le même nom dans un fichier de configuration peut également écraser la variable d'environnement. Des outils comme Claude Code et Codex renvoient chacun vers leur propre tutoriel ; n'empilez pas toutes les variables de fournisseurs dans la configuration globale du shell en même temps.
## Revenir en arrière en cas d’échec de bascule
Rétablissez la configuration du fournisseur, de l'adresse et du modèle enregistrée précédemment, puis redémarrez le client. Si vous migrez un service de production, vérifiez d'abord sur un petit nombre de requêtes avant d'élargir la portée ; conservez le mécanisme de bascule de configuration au niveau de l'application pour faciliter la restauration du service.
Si vous n'êtes pas certain qu'une fonctionnalité est ouverte, vérifiez dans le catalogue des modèles ou contactez le support. Ne supposez pas que ce site propose le même service qu'une autre plateforme offrant Embeddings, Batch ou un modèle d'image propriétaire quelconque.
---
# FAQ sur l'accès à l'API
Source: https://1zheai.com/fr/docs/faq/
Markdown: https://1zheai.com/fr/docs/faq.md
---
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"}
---
## Adresse, clés et modèles
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/).
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.
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/).
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.
## Requêtes et clients
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.
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.
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.
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/).
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.
## État du service et aide
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.
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/).
---
# Guide d'achat de la boutique
Source: https://1zheai.com/fr/docs/store-guide/
Markdown: https://1zheai.com/fr/docs/store-guide.md
---
title: "Guide d'achat de la boutique"
description: "Comprenez les différences entre les comptes prêts à l'emploi, la recharge d'abonnement et les cartes-cadeaux, commandez en respectant les conditions du produit et suivez la livraison."
headingIds: {"Vérifications avant commande":"section-1","Commande et livraison":"section-2","À savoir avant d’acheter":"section-3","Inviter des amis à acheter":"section-4"}
---
Choisissez un compte IA, un service d’abonnement ou une carte cadeau dans la boutique. Consultez la fiche produit avant de passer commande.
| Ce dont vous avez besoin | Service à choisir | Où consulter |
| --- | --- | --- |
| Appeler un modèle dans du code ou un outil | API de modèle | [Démarrage rapide de l'API](/fr/docs/quickstart/) |
| Acheter un compte tiers existant | Compte prêt à l'emploi | [Achat et utilisation des comptes prêts à l'emploi](/fr/docs/account-guide/) |
| Activer un abonnement sur votre propre compte tiers | Recharge d'abonnement | [Conditions et processus de recharge](/fr/docs/subscription-guide/) |
| Obtenir un code d'échange ou un lien d'échange | Carte-cadeau | [Conditions d'échange et d'utilisation](/fr/docs/gift-card-guide/) |
Les clés API de ce site ne permettent pas de se connecter à ChatGPT, Claude ou Grok ; l'achat d'un abonnement sur une plateforme tierce n'équivaut pas non plus au rechargement du solde API de ce site.
## Vérifications avant commande
Vérifiez le nom du produit, les spécifications, la région, la durée d'abonnement, le stock actuel, le mode de livraison et les conditions d'achat. Les spécifications non affichées ou non achetables dans le catalogue ne sont pas encore ouvertes, ne payez pas en suivant le processus de la page de démonstration ou d'un autre marchand.
Le fait qu'un produit prenne en charge le renouvellement, le changement d'e-mail, l'utilisation multi-personnes ou un client spécifique doit être déterminé par la description du produit sélectionné. S'il n'est pas clairement indiqué, contactez d'abord le support pour confirmer ; ces fonctionnalités ne sont pas incluses par défaut.
## Commande et livraison
1. Sélectionnez le produit et les spécifications dans la [boutique en ligne](https://1zheai.com/en/store/).
2. Après connexion, vérifiez le prix de règlement, la quantité et les conditions d'achat. Les produits de recharge nécessitent également de remplir les informations requises dans le formulaire.
3. Lisez les règles de risque et de service après-vente, cochez activement la confirmation avant de passer commande ; la commande est payée avec le solde du portefeuille de ce site.
4. Consultez le statut, le contenu livré ou les informations à compléter dans [mes commandes](https://1zheai.com/store-orders?lng=fr). Le rechargement réussi du solde ne signifie pas que le produit a été acheté ou que la recharge est terminée.
Les produits à livraison automatique en stock, les produits à livraison manuelle et les recharges activées après commande ont des modes de traitement différents. Aucune promesse unifiée de livraison instantanée ou de délai de complétion fixe n'est faite ; faites foi à la page de règlement et à l'affichage de la commande.
## À savoir avant d’acheter
Après une livraison normale d'un compte prêt à l'emploi ou une recharge réussie, si le compte est banni par la plateforme tierce, aucun remboursement n'est accordé en raison du bannissement. Nous pouvons aider à faire appel, mais nous ne garantissons pas le résultat de la levée du bannissement. En cas de non-livraison conforme, de recharge non réussie ou de situations où ce site doit légalement assumer la responsabilité, les règles de service après-vente correspondantes s'appliquent.
[Règles de transaction et de service après-vente](/fr/docs/store-rules/) · [Dépannage des problèmes de commande](/fr/docs/store-orders/)
## Inviter des amis à acheter
Les produits de la boutique peuvent participer au programme de commission selon les spécifications. La portée de participation, l'attribution et les conditions de règlement sont détaillées dans [récompenses d'invitation et commissions de la boutique](/fr/docs/affiliate-guide/).
---
# Achat et utilisation de comptes prêts à l'emploi
Source: https://1zheai.com/fr/docs/account-guide/
Markdown: https://1zheai.com/fr/docs/account-guide.md
---
title: "Achat et utilisation de comptes prêts à l'emploi"
description: "Caractéristiques, contenu de la livraison, première connexion et risques de bannissement à confirmer avant l'achat de comptes ChatGPT, Claude et Grok prêts à l'emploi."
headingIds: {"À confirmer avant l’achat":"section-1","Après réception du compte":"section-2","Utilisation quotidienne et renouvellement":"section-3","Bannissements et service après-vente":"section-4"}
---
Un compte prêt à l'emploi fournit un compte de plateforme tiers tel que décrit dans la fiche produit sélectionnée. L'inclusion d'un abonnement, le niveau d'abonnement et la durée restante sont tous déterminés par ce produit et la commande ; ne jugez pas uniquement en fonction du nom de la plateforme.
## À confirmer avant l’achat
- Si un abonnement est inclus, ainsi que le niveau précis (par exemple Pro, Max) et la durée ; les caractéristiques non affichées ne sont pas disponibles à la vente.
- La région, la méthode de connexion et le contenu de la livraison ; si l'accès à l'e-mail, la réception de codes de vérification ou la possibilité de changer d'e-mail sont fournis.
- S'il s'agit d'une livraison unique ou s'il existe des dispositions de renouvellement distinctes ; ne supposez pas que le renouvellement automatique, le transfert d'e-mails ou les rappels de renouvellement sont inclus.
- Si l'utilisation en équipe, le partage ou le transfert sont autorisés, ainsi que les propres conditions d'utilisation et restrictions régionales de la plateforme tiers.
## Après réception du compte
1. Dans [Mes commandes ](https://1zheai.com/store-orders?lng=fr), vérifiez le produit, les caractéristiques et les informations de livraison, et conservez précieusement le numéro de commande.
2. Suivez les instructions de connexion de ce produit pour accéder à la plateforme correspondante, et vérifiez si le compte peut se connecter, son niveau d'abonnement et sa période de validité.
3. Modifiez le mot de passe, récupérez les informations ou activez la vérification de sécurité de la manière autorisée par le produit ; pour les éléments qui ne peuvent pas être modifiés, contactez d'abord le support pour confirmer.
4. Si les informations livrées sont invalides, si les caractéristiques ne correspondent pas ou si la connexion échoue, conservez des captures d'écran avec informations masquées et les messages d'erreur, et expliquez la situation via le canal de support du site officiel. Ne partagez publiquement aucun mot de passe de compte, code de vérification ni code de récupération.
## Utilisation quotidienne et renouvellement
Respectez les conditions d'utilisation de la plateforme. Le compte peut être soumis à des restrictions régionales, de volume d'utilisation, d'identification ou de contrôle des risques ; l'achat n'inclut aucune garantie de contournement des restrictions, de gestion de l'identification en votre nom, ni de non-bannissement à vie. L'identification doit être effectuée par l'utilisateur réel tel que requis par la plateforme ; n'envoyez pas de documents d'identité ni de codes de vérification au service client, sauf s'il existe un autre processus légitime explicite et nécessaire.
Lorsqu'un renouvellement est nécessaire, confirmez d'abord la méthode prise en charge par le produit actuel ; n'appliquez pas directement des recharges destinées à votre propre compte sur un compte prêt à l'emploi, et n'empilez pas vous-même des abonnements incompatibles.
## Bannissements et service après-vente
Après qu'un compte prêt à l'emploi a été livré normalement ou qu'une recharge a réussi, si le compte est banni par la plateforme tiers, aucun remboursement n'est émis en raison du bannissement. Nous pouvons assister dans le cadre d'un appel, mais nous ne promettons pas de résultat de débannissement. Le non-respect de la livraison convenue, une recharge infructueuse, ou les situations pour lesquelles ce site devrait assumer une responsabilité en vertu de la loi sont traitées selon les règles de service après-vente correspondantes.
[Règles détaillées de transaction ](/fr/docs/store-rules/) · [Résolution des problèmes de commande ](/fr/docs/store-orders/)
---
# Conditions et processus de recharge d'abonnement
Source: https://1zheai.com/fr/docs/subscription-guide/
Markdown: https://1zheai.com/fr/docs/subscription-guide.md
---
title: "Conditions et processus de recharge d'abonnement"
description: "Vérifiez l'éligibilité, les informations requises, les conseils de sécurité et le traitement des commandes avant la recharge avec votre propre compte."
headingIds: {"Vérifiez d’abord les conditions du compte":"section-1","Processus de commande":"section-2","Sécurité des informations":"section-3","En cours de traitement, échec et remboursement":"section-4"}
---
La recharge d'abonnement consiste à activer l'adhésion choisie sur votre compte de plateforme tiers existant ; aucun nouveau compte n'est fourni. Les produits disponibles, les plateformes et les niveaux pris en charge sont déterminés par ce qui est actuellement affiché dans la [boutique](https://1zheai.com/en/store/). Cet article n'indique pas que toutes les plateformes ou toutes les spécifications sont ouvertes.
## Vérifiez d’abord les conditions du compte
Consultez les exigences du produit choisi concernant la région, le type de compte, l'état d'abonnement actuel, les arriérés, les antécédents de remboursement et les restrictions de renouvellement. Les conditions peuvent varier selon les canaux ; il n'est pas exigé que tous les comptes soient Free, ni garanti que l'empilement, la mise à niveau ou la prolongation d'un abonnement existant soit possible.
Si vous avez déjà un abonnement, des arriérés, des restrictions de la plateforme ou si vous n'êtes pas sûr de l'éligibilité de votre compte, contactez d'abord le support. Ne passez pas de commandes répétées pour tester, et n'utilisez pas les instructions d'un autre fournisseur à la place des avis de produit de ce site.
## Processus de commande
1. Choisissez la spécification précise et confirmez le prix, la durée, le compte applicable et la méthode d'activation.
2. Remplissez dans le formulaire de paiement de ce site les informations requises pour cette spécification, par exemple l'identifiant du compte ou l'Organization ID ; les champs varient selon le produit.
3. Vérifiez le compte cible et les informations, lisez les avertissements de risque, puis soumettez la commande.
4. Consultez la progression du traitement dans [Mes commandes](https://1zheai.com/store-orders?lng=fr). Mettez à jour les informations uniquement si la commande d'origine indique qu'une correction est possible ; ne rachetez pas.
5. Une fois la commande affichée comme terminée, connectez-vous à la plateforme tiers pour vérifier le niveau d'adhésion et la date d'expiration ; si l'affichage n'est toujours pas mis à jour, actualisez ou reconnectez-vous puis revérifiez ; en cas de divergence persistante, contactez le support.
## Sécurité des informations
Certaines spécifications peuvent nécessiter des informations de session de connexion telles que Session JSON. Ces informations peuvent permettre l'accès à votre compte et sont aussi sensibles qu'un mot de passe. Soumettez-les uniquement via le formulaire dédié de la commande correspondante sur ce site, et ne les envoyez pas par chat en ligne, e-mail, captures d'écran publiques ou sites tiers de vérification de comptes. Soumettez-les uniquement après avoir compris la portée de l'autorisation et accepté les exigences du produit ; si vous ne pouvez pas accepter, n'achetez pas cette spécification.
N'envoyez pas de mot de passe, de code de vérification, de clé API ou de session de connexion complète dans un message de support ordinaire. Après le traitement, vérifiez et gérez les appareils et sessions de connexion selon la méthode fournie par la plateforme tiers.
## En cours de traitement, échec et remboursement
Le traitement commence après paiement ; une fois la phase de traitement entamée, l'annulation directe n'est plus possible. Un délai dépassé ou un message d'échec ne signifie ni remboursement, ni que l'activation n'a pas eu lieu. Conservez la commande d'origine, attendez la mise à jour du statut ou contactez le support pour vérifier, afin d'éviter des débits ou activations en double. Le résultat et la destination du remboursement sont déterminés par la commande et le relevé du portefeuille de ce site ; aucun remboursement par le chemin d'origine n'est garanti.
Après la livraison normale d'un compte prêt à l'emploi ou une recharge réussie, si le compte est banni par la plateforme tiers, aucun remboursement n'est accordé en raison du bannissement. Nous pouvons aider à faire appel, mais aucun résultat de levée du bannissement n'est garanti. En cas de non-livraison conforme, de recharge infructueuse ou de situations où ce site est légalement responsable, les règles de service après-vente correspondantes s'appliquent.
[Règles de transaction et de service après-vente](/fr/docs/store-rules/) · [Dépannage des problèmes de commande](/fr/docs/store-orders/)
---
# Utiliser une carte-cadeau
Source: https://1zheai.com/fr/docs/gift-card-guide/
Markdown: https://1zheai.com/fr/docs/gift-card-guide.md
---
title: "Utiliser une carte-cadeau"
description: "Vérifiez la région, la validité, les comptes éligibles et les modalités de livraison avant d’acheter ou d’utiliser une carte-cadeau."
headingIds: {"Confirmer avant l’achat":"section-1","Comment utiliser après réception":"section-2","Annulation et après-vente":"section-3"}
---
Les cartes-cadeaux sont livrées sous forme de code ou de lien d’activation ; une recharge d’abonnement peut être activée directement dans le cadre de la commande. Ce sont deux modes de livraison distincts : une recharge ne consiste pas nécessairement à recevoir un code à utiliser sur un autre site.
## Confirmer avant l’achat
Vérifiez la plateforme, la région, la devise ou la valeur nominale, le niveau d’abonnement, la validité et les conditions du compte indiqués sur le produit. Consultez sa description pour savoir si la carte est compatible avec un abonnement existant ou mobile, si plusieurs cartes peuvent se cumuler et si elle peut être offerte. Les conditions ou délais annoncés par un autre vendeur ne constituent pas un engagement de ce site.
Si aucune carte-cadeau n’est proposée dans la boutique, l’achat n’est pas ouvert. En cas de changement des règles de la plateforme ou de la disponibilité, consultez les informations actuelles du produit.
## Comment utiliser après réception
1. Consultez le contenu livré dans [Mes commandes](https://1zheai.com/store-orders?lng=fr). Ne publiez ni le code ni une capture d’écran qui le contient.
2. Connectez-vous au bon compte, puis utilisez le lien ou la page d’activation indiqués dans la description du produit. Méfiez-vous des sites inconnus qui demandent un paiement supplémentaire ou votre mot de passe.
3. Vérifiez à nouveau la région et l’état du compte avant d’activer la carte, puis contrôlez les avantages effectivement ajoutés.
4. Si le code est déjà utilisé, invalide, incompatible avec la région ou si les avantages ne sont pas crédités, conservez le numéro de commande, le message d’erreur et des captures d’écran expurgées des données sensibles, puis contactez l’assistance. Ne rachetez pas une carte pour tenter de résoudre le problème.
## Annulation et après-vente
Une commande dont le traitement n’a pas commencé peut faire l’objet d’une demande d’annulation depuis la commande. Une fois le code livré, aucun remboursement direct n’est proposé : contactez l’assistance pour faire vérifier le problème. Une livraison non conforme ou invalide, ainsi que les situations engageant légalement la responsabilité de ce site, restent traitées selon les règles d’après-vente applicables. Les risques de suspension, les restrictions d’utilisation et les conditions de remboursement propres à la carte-cadeau sont précisés dans la notice du produit. Les règles de remboursement du solde API ne s’appliquent pas.
[Règles de transaction et d’après-vente](/fr/docs/store-rules/) · [Résolution des problèmes de commande](/fr/docs/store-orders/)
---
# Statut des commandes et dépannage
Source: https://1zheai.com/fr/docs/store-orders/
Markdown: https://1zheai.com/fr/docs/store-orders.md
---
title: "Statut des commandes et dépannage"
description: "Recherchez le contenu livré, l'avancement du traitement, les corrections de données et les enregistrements de remboursement pour éviter les commandes en double."
headingIds: {"Explication des statuts":"section-1","Questions fréquentes":"section-2","Débit effectué, mais aucun compte ou abonnement reçu":"section-3","Données saisies incorrectement":"section-4","La commande affiche « terminé », mais la plateforme n’a pas encore l’abonnement":"section-5","Compte banni ou vérification d’identité requise":"section-6","Où sont les remboursements ?":"section-7","Quelles informations fournir au support ?":"section-8"}
---
Dans[Mes commandes](https://1zheai.com/store-orders?lng=fr), sélectionnez la commande correspondante. Les enregistrements d'achat, le contenu livré et l'avancement du traitement sont déterminés par cette commande ; les enregistrements de recharge de solde ne sont pas des commandes de produits.
## Explication des statuts
| Statut | Ce que cela signifie | Prochaine étape |
| --- | --- | --- |
| En attente de livraison | La commande a été créée, la livraison n'est pas encore terminée | Consultez le mode de livraison et les instructions de la commande ; si une entrée d'annulation est disponible, vous pouvez demander l'annulation |
| En cours de traitement | Traitement manuel en cours ou activation via un canal partenaire | Conservez la commande d'origine, ne rachetez pas ; complétez ou corrigez les données selon les indications |
| Livré | Le contenu livré ou le résultat d'activation a été fourni | Pour un compte prêt à l'emploi, vérifiez la connexion et les spécifications ; pour la recharge par procuration, vérifiez l'abonnement ; pour les cartes cadeaux, échangez selon les instructions |
| Annulé | La commande d'origine a été terminée | Vérifiez le motif d'annulation et le relevé du portefeuille ; le remboursement éventuel est déterminé par l'enregistrement réel |
L'avancement détaillé d'une recharge par procuration peut indiquer l'attente de la fourniture, l'attente de l'activation, la nécessité de corriger les données ou un remboursement en cours. Ces étapes diffèrent du statut de finalisation ; ne jugez pas le résultat de l'activation ou du remboursement sur la base d'une seule erreur.
## Questions fréquentes
### Débit effectué, mais aucun compte ou abonnement reçu
Ouvrez d'abord les détails de la commande pour vérifier le statut et le contenu livré. Le traitement manuel et la recharge par procuration ne sont pas nécessairement instantanés ; si le délai indiqué dans la description du produit est dépassé, si le statut ne se met pas à jour pendant longtemps ou s'affiche de manière anormale, contactez le support, ne payez pas à nouveau.
### Données saisies incorrectement
Mettez à jour uniquement lorsque la commande d'origine affiche une entrée de correction, vérifiez le compte cible avant de soumettre. S'il n'y a pas d'entrée ou si la commande est déjà livrée, contactez d'abord le support, nous ne promettons pas le transfert d'un abonnement déjà activé.
### La commande affiche « terminé », mais la plateforme n’a pas encore l’abonnement
Vérifiez que vous êtes connecté au compte cible soumis, actualisez ou reconnectez-vous et consultez les paramètres d'abonnement. Si la discrepancy persiste, conservez une capture d'écran avec les données masquées et le numéro de commande, contactez le support, ne rachetez pas vous-même une nouvelle commande.
### Compte banni ou vérification d’identité requise
Faites appel ou passez la vérification via les canaux officiels de la plateforme tierce. Après une livraison normale ou une recharge par procuration réussie, aucun remboursement n'est accordé en raison d'un bannissement ; nous pouvons vous aider dans la procédure d'appel, mais nous ne garantissons pas la levée du bannissement. Les anomalies telles que la non-livraison conformément aux termes sont traitées séparément selon[règles de service après-vente](/fr/docs/store-rules/).
### Où sont les remboursements ?
Consultez le motif d'annulation de la commande et le relevé du portefeuille. Le retour du solde du portefeuille diffère d'un remboursement sur le mode de paiement d'origine ; un remboursement affiché « en cours de traitement » n'est pas encore terminé, ne soumettez pas à nouveau la même demande.
### Quelles informations fournir au support ?
Numéro de commande, produit et spécifications, heure et fuseau horaire de l'incident, statut de la commande, message d'erreur avec données masquées. N'envoyez pas de mots de passe, de codes de vérification, de Session JSON complète, de codes d'échange ni de clés API.
---
# Règles de transaction et de service après-vente de la boutique
Source: https://1zheai.com/fr/docs/store-rules/
Markdown: https://1zheai.com/fr/docs/store-rules.md
---
title: "Règles de transaction et de service après-vente de la boutique"
description: "Distingue l'annulation, les anomalies de livraison, les échecs d'activation et le bannissement de compte selon la phase de la commande ; le solde de l'API modèle est traité séparément selon les règles de recharge."
headingIds: {"Informations avant la commande":"section-1","Annulation et remboursement traités selon la phase de la commande":"section-2","Le risque de bannissement doit être compris séparément":"section-3","Différence avec le remboursement du solde API":"section-4","Quand un service après-vente est nécessaire":"section-5"}
---
## Informations avant la commande
Le prix, les spécifications, la quantité, la région, la durée, la méthode de livraison et les avis de risque sont affichés dans le produit ou le processus de paiement. Veuillez tout lire avant de confirmer ; en cas de conditions non claires, contactez d'abord le support. La commande conserve le produit et les avis de risque confirmés au moment de la commande ; les mises à jour ultérieures des pages ne réécrivent pas l'enregistrement de confirmation des commandes historiques.
Ce site est votre point d'entrée pour acheter des produits et demander un service après-vente. Lorsqu'un partenaire fournisseur est impliqué, ce site traite et vérifie selon la commande ; ne payez pas un fournisseur inconnu séparément et n'ayez pas besoin de vous enregistrer vous-même pour un compte de distribution.
## Annulation et remboursement traités selon la phase de la commande
| Situation | Comment traiter |
| --- | --- |
| En attente de livraison et la commande propose une entrée d'annulation | Vous pouvez demander l'annulation depuis la commande d'origine ; après succès, vérifiez le flux de remboursement du portefeuille |
| En cours de traitement ou résultat d'activation en attente de confirmation | Impossible d'annuler directement ; conservez la commande d'origine en attendant la vérification, ne rachetez pas à plusieurs reprises |
| Impossible de se connecter, livraison invalide ou spécifications non conformes | Fournissez le numéro de commande et une preuve avec données masquées ; le support vérifiera la livraison |
| Échec de la recharge par un tiers ou informations erronées | Corrigez selon les instructions de la commande d'origine ou contactez le support ; un message d'échec ne signifie pas que le remboursement a été effectué |
| Compte fini livré normalement ou recharge par un tiers réussie, puis banni par une plateforme tierce | Pas de remboursement en raison du bannissement ; assistance possible pour faire appel, sans promesse de levée du bannissement |
| Carte cadeau livrée | Pas de remboursement direct ; les anomalies telles qu'une livraison invalide restent contactables pour vérification avec le support |
## Le risque de bannissement doit être compris séparément
Après la livraison normale d'un compte prêt à l’emploi ou une recharge par un tiers réussie, si le compte est banni par une plateforme tierce, aucun remboursement n'est accordé en raison du bannissement. Nous pouvons assister pour faire appel, mais ne promettons pas le résultat de la levée du bannissement. En cas de non-livraison conforme, recharge par un tiers non réussie, ou situations où la responsabilité incombe légalement à ce site, les règles de service après-vente correspondantes s'appliquent.
Les plateformes tierces peuvent ajuster leurs conditions, restreindre l'accès ou exiger une vérification d'identité ; ce site ne peut pas garantir l'absence de contrôle des risques, l'absence de bannissement ou le passage obligatoire d'un appel. Ne confondez pas un bannissement après livraison normale avec une non-livraison conforme ou un échec d'activation. Les explications ci-dessus n'excluent pas les responsabilités légales incombant à ce site.
## Différence avec le remboursement du solde API
Le remboursement du principal non utilisé de l'API modèle est traité selon[Recharge, remboursement et facture](/fr/docs/billing/). Pour savoir si un produit de la boutique peut être annulé et comment être remboursé, cela dépend de la phase de la commande et des règles du produit correspondant ; la règle des 7 jours du solde API ne s'applique pas directement. L'annulation de commande renvoyée au portefeuille et le remboursement du recharge du portefeuille par la voie d'origine sont deux opérations différentes.
## Quand un service après-vente est nécessaire
Depuis[Mes commandes](https://1zheai.com/store-orders?lng=fr) conservez le numéro de commande, fournissez les spécifications du produit, l'heure de survenance, l'état de la commande, l'état affiché par la plateforme tierce et une capture d'écran d'erreur avec données masquées. Contactez via les canaux de support publiés sur le site officiel ou la console ; ne fournissez pas de mot de passe, de code de vérification, de session complète, de code d'échange ou d'image originale de document. Pour localiser un problème spécifique, voir[Dépannage des problèmes de commande](/fr/docs/store-orders/).
---
# Récompenses d'invitation et commissions du magasin
Source: https://1zheai.com/fr/docs/affiliate-guide/
Markdown: https://1zheai.com/fr/docs/affiliate-guide.md
---
title: "Récompenses d'invitation et commissions du magasin"
description: "Découvrez l'attribution des invitations, les produits participants, les conditions de règlement et l'état des commissions du magasin."
headingIds: {"Comment participer":"section-1","Quelles commandes génèrent une commission":"section-2","Quand le règlement a lieu":"section-3","Où consulter":"section-4"}
---
Les commandes de produits participants peuvent donner droit à une récompense de parrainage. L’administrateur définit la participation de chaque produit de comptes, d’activation d’abonnement ou de cartes cadeaux ; tous les produits ne génèrent pas automatiquement de commission.
## Comment participer
Copiez votre propre lien d'inscription depuis l'entrée d'invitation dans le [portefeuille](https://1zheai.com/wallet?lng=fr). Une fois qu'un ami a terminé son inscription via ce lien, la relation d'invitation enregistrée par le système est conservée. Lorsque l'ami passe une commande, l'attribution de la commission est déterminée en conséquence ; elle n'est pas modifiée par la suite si l'ami clique sur le lien d'une autre personne, et aucun identifiant d'invitant n'est soumis via le formulaire de commande.
Pour les amis ayant déjà établi une relation d'invitation, les achats de produits participants à la commission après l'activation de la fonction sont également traités selon les nouvelles règles de commande. Les commandes historiques passées avant l'activation de la fonction ne recevront pas de commissions rétroactives du magasin. Vos propres achats ne comptent pas comme votre propre commission d'invitation.
## Quelles commandes génèrent une commission
L'administrateur configure une commission fixe pour chaque produit par spécification de produit ; saisir 0 signifie que le produit ne participe pas. Les spécifications dont la commission réelle n'a pas encore été configurée ne délivreront aucune récompense. Au moment de la commande, l'invitant, le produit, la quantité et le montant de la commission à ce moment-là sont enregistrés ; les ajustements ultérieurs du prix du produit ou de la commission ne réécrivent pas les enregistrements des commandes déjà passées.
Les commissions du magasin et les récompenses d'inscription sont deux types d'enregistrements distincts. Le fait qu'un ami recharge son portefeuille n'équivaut pas à l'achat d'un produit et ne génère pas automatiquement une commission du magasin sur cette base. L'émission des récompenses d'inscription suit les paramètres de récompense d'invitation existants de l'administrateur.
## Quand le règlement a lieu
| Statut de la commande | Traitement de la commission |
| --- | --- |
| En attente de livraison, en cours de traitement ou résultat d'activation en attente de confirmation | Seule la commission estimée est enregistrée ; elle ne peut pas être transférée au solde |
| Compte prêt à l'emploi ou carte-cadeau livré avec succès, recharge terminée | Réglée par le système et créditée au solde des récompenses |
| Commande annulée et remboursée | La commission estimée est annulée ; aucune récompense n'est émise |
| Soumission en double d'une commande ou notification de complétion en double | La même commande n'est réglée qu'une seule fois |
Une erreur ou un délai d'attente de commande ne signifie pas que la commande a été livrée ; il est impossible de déterminer si une commission a été générée sur la base d'un seul résultat de traitement. Les bannissements survenant après la livraison normale d'un compte ou une recharge réussie sont traités selon les[règles de service après-vente du magasin ](/fr/docs/store-rules/).
Si le compte recevant la récompense est désactivé ou a atteint la limite de montant du système, la commission reste dans un état de règlement en attente et sera réessayée une fois les conditions rétablies ; cela n'affecte pas la livraison de la commande de l'acheteur. Lorsque les fonctionnalités de paiement et de récompense du système sont suspendues, le règlement est également suspendu.
## Où consulter
La section « Commissions récentes du magasin » dans le portefeuille affiche le produit, la spécification, la quantité, le montant et le statut des commandes participants récentes :
- **En attente de règlement** : montant estimé, pas encore crédité aux récompenses disponibles.
- **Crédité** : déjà crédité au solde des récompenses ; ne l'ajoutez pas à nouveau lors du calcul des récompenses disponibles.
- **Annulée** : cette commission ne sera plus émise.
Les récompenses disponibles utilisent l'entrée existante de transfert vers le solde et les exigences minimales de transfert, et peuvent être utilisées pour la consommation de l'API de modèle. Les récompenses ne constituent pas un quota de retrait en espèces et n'équivalent pas aux fonds disponibles rechargeés du magasin ; le magasin valide toujours selon ses propres règles d'éligibilité des fonds.
Les invitants ne peuvent consulter que les enregistrements de commission qui leur sont attribués. Les enregistrements n'affichent pas l'identité de l'acheteur, le numéro de commande, le mot de passe du compte ni le code d'échange. Lorsqu'une vérification de commission est nécessaire, fournissez le numéro d'enregistrement de commission, le produit et l'heure de survenance via les canaux de support publiés sur le site officiel ; ne demandez pas les identifiants de connexion de l'acheteur.
---
# Tutoriel d'intégration des outils pour Claude et GPT
Source: https://1zheai.com/fr/docs/integrations/
Markdown: https://1zheai.com/fr/docs/integrations.md
---
title: "Tutoriel d'intégration des outils pour Claude et GPT"
description: "Tutoriels de configuration API et périmètre de prise en charge pour Claude Code, Codex CLI, OpenCode, OpenClaw, WorkBuddy, Hermes Agent, Cursor, Cline, Cherry Studio et CC Switch."
headingIds: {"Outils de programmation":"section-1","Assistants de bureau":"section-2","Autres clients et méthodes d’importation":"section-3","Plateformes Agent":"section-4","Gestion de la configuration":"section-5","Autres outils prenant en charge une API personnalisée":"section-6","Comment confirmer que la configuration est réussie":"section-7"}
---
Accédez au tutoriel correspondant à l'outil que vous utilisez. Les états ci-dessous sont compilés à partir de la documentation d'intégration existante et ne signifient pas que toutes les versions des outils ont été validées de bout en bout. Après la mise à jour d'un outil, veuillez refaire la vérification d'appel indiquée sur la page.
## Outils de programmation
Intégration native Anthropic. Variables d'environnement, fichiers de configuration et questions fréquentes.Appel des modèles OpenAI / GPT via l'interface Responses.Distingue les configurations v1 et v2, fournisseur OpenAI compatible personnalisé.Intégration compatible OpenAI. Consultez d'abord le périmètre d'application des clés personnalisées et les différences d'interface.Privilégie le mode Anthropic, propose également une configuration OpenAI Compatible.
## Assistants de bureau
Ajout d'un fournisseur personnalisé dans le client de chat.Ajout d'une adresse personnalisée via les paramètres du modèle, en veillant à l'URL complète et au commutateur de protocole.
## Autres clients et méthodes d’importation
Importation via lien ou JSON du presse-papiers, avec configuration de secours manuelle prise en charge.QR code fournisseur pour Android, contenu de la clé masqué par défaut.Champs de fournisseur personnalisés et configuration des modèles.Point de terminaison YAML administrateur et clés individuelles par utilisateur.Configuration Anthropic de l'extension VS Code.
Les protocoles en un clic ne servent qu'aux opérations déjà prises en charge publiquement par le client. Le protocole d'ouverture de conversation de ChatWise n'équivaut pas à l'importation d'une clé ; LibreChat nécessite une configuration administrateur. Ne traitez pas tous les outils comme s'il s'agissait du même lien d'importation.
## Plateformes Agent
Configuration d'un fournisseur Anthropic personnalisé et du modèle Agent par défaut.Configuration de Chat Completions via l'assistant de modèle ou un provider nommé.Les tutoriels OpenCode, OpenClaw, WorkBuddy et Hermes Agent ont été vérifiés par rapport à la configuration officielle, mais la validation de bout en bout sur ce site n'est pas encore terminée. Veuillez vérifier la version réelle selon le tutoriel et valider l'appel.
## Gestion de la configuration
Gère la configuration des fournisseurs de Claude Code afin de réduire les bascules manuelles.
## Autres outils prenant en charge une API personnalisée
Vérifiez d'abord si l'outil permet de définir l'adresse API, la clé et l'ID du modèle, puis choisissez la configuration en fonction du protocole :
| Protocoles pris en charge par l'outil | Interface de ce site | Étape suivante |
| --- | --- | --- |
| Anthropic Messages | `/v1/messages` | Vérifiez si le client ajoute automatiquement `/v1`, voir [explication de l'adresse](/fr/docs/base-url/) |
| OpenAI Chat Completions | `/v1/chat/completions` | En général, renseignez `https://1zheai.com/v1` dans Base URL ; sauf pour les champs de point de terminaison complet |
| OpenAI Responses | `/v1/responses` | Renseignez `https://1zheai.com/v1` dans Base URL, voir [Codex CLI](/fr/docs/quickstart-codex/) |
| Connexion uniquement avec un compte officiel | N'utilisez pas la clé API de ce site | Vérifiez si l'outil dispose d'un paramètre de fournisseur personnalisé distinct |
## Comment confirmer que la configuration est réussie
1. Sélectionnez le protocole et le Base URL selon le tutoriel ; pour savoir si chaque outil a besoin de `/v1`, voir le [tableau de correspondance des adresses](/fr/docs/base-url/).
2. Choisissez un modèle actuellement disponible parmi les [modèles pris en charge](/fr/docs/models/).
3. Effectuez une requête courte et vérifiez que l'outil renvoie correctement.
4. Vérifiez l'appel correspondant dans les [journaux d'appel](/fr/docs/usage-logs/) ; ne jugez pas uniquement à partir du contenu de la réponse par quel fournisseur la requête est passée.
En cas de problème, consultez d'abord les [codes d'erreur et le dépannage](/fr/docs/troubleshooting/). Si vous écrivez votre propre programme, accédez au [guide de développement](/fr/docs/guides/).
---
# Intégration de Claude Code
Source: https://1zheai.com/fr/docs/quickstart-claude-code/
Markdown: https://1zheai.com/fr/docs/quickstart-claude-code.md
---
title: "Intégration de Claude Code"
description: "Connecter Claude Code à 1折AI : avec ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN (variables d'environnement ou settings.json), avec la syntaxe Windows, le mapping des modèles, l'extension VS Code et les erreurs courantes."
headingIds: {"Chemin le plus court":"section-1","Étapes complètes":"section-2","Pourquoi utiliser ANTHROPIC_AUTH_TOKEN":"section-3","Mapping des modèles":"section-4","Extension VS Code":"section-5","Paramètres facultatifs":"section-6","Questions fréquentes":"section-7"}
---
Claude Code n'a besoin que de deux variables : `ANTHROPIC_BASE_URL` pointe vers nous, `ANTHROPIC_AUTH_TOKEN` contient votre clé API (API key). Aucune connexion à un compte Anthropic n'est nécessaire.
## Chemin le plus court
Si Claude Code est déjà installé et que vous avez une clé API, ajoutez les deux lignes suivantes dans `~/.claude/settings.json`, puis exécutez `claude` :
```json title="~/.claude/settings.json"
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
```
Si le fichier existe déjà, fusionnez ces deux éléments dans votre `env` existant, sans écraser les autres configurations.
## Étapes complètes
Si déjà installé, vous pouvez passer cette étape. Les commandes suivantes proviennent de la [documentation officielle d'installation de Claude Code](https://code.claude.com/docs/en/setup) :
```bash title="macOS / Linux"
curl -fsSL https://claude.ai/install.sh | bash
```
```powershell title="Windows PowerShell"
irm https://claude.ai/install.ps1 | iex
```
```bash title="Homebrew"
brew install --cask claude-code
```
```bash title="npm（需要 Node.js 22+）"
npm install -g @anthropic-ai/claude-code
```
N'ajoutez pas `sudo` lors de l'installation via npm.
Créez une clé API dans la [console](https://1zheai.com/console?lng=fr), idéalement dédiée à Claude Code sur cette machine. Voir [Obtenir et gérer les clés API](/fr/docs/api-keys/).
Emplacement de settings.json : macOS / Linux : `~/.claude/settings.json`, Windows : `%USERPROFILE%\.claude\settings.json`.
```json title="settings.json（推荐）"
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
```
```bash title="macOS / Linux 环境变量"
# 写进 ~/.zshrc 或 ~/.bashrc，然后重开终端
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_AUTH_TOKEN="sk-你的Key"
```
```powershell title="Windows PowerShell"
# 持久写入当前用户，重开终端后生效
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://1zheai.com", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的Key", "User")
# 只在当前窗口生效
$env:ANTHROPIC_BASE_URL = "https://1zheai.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Key"
```
```bat title="Windows CMD"
setx ANTHROPIC_BASE_URL "https://1zheai.com"
setx ANTHROPIC_AUTH_TOKEN "sk-你的Key"
```
`ANTHROPIC_BASE_URL` doit contenir l'adresse de base, sans ajouter `/v1` ; Claude Code assemblera lui-même `/v1/messages`.
Dans le répertoire du projet, exécutez `claude`, puis saisissez `/status`. Vérifiez deux lignes :
- la ligne de l'URL de base affiche `https://1zheai.com`
- la ligne des identifiants indique que la source est `ANTHROPIC_AUTH_TOKEN`
Posez ensuite une question, puis consultez les [journaux d'appels](/fr/docs/usage-logs/) pour vérifier s'il y a un nouvel enregistrement. S'il y en a un, la connexion est établie.
Si vous ne souhaitez pas entrer dans l'interface interactive, vous pouvez également tester en mode non interactif (testé le 2026-10-15, retour `ok`) :
```bash
claude -p "say ok" --model claude-sonnet-4-6
```
## Pourquoi utiliser ANTHROPIC_AUTH_TOKEN
Claude Code dispose de deux variables pouvant contenir la clé API, avec les différences suivantes ([explication officielle](https://code.claude.com/docs/en/authentication)) :
| Variable | Méthode d'envoi | Comportement |
|---|---|---|
| `ANTHROPIC_AUTH_TOKEN` | `Authorization: Bearer <值>` | Prend effet immédiatement après le réglage, sans demande de confirmation |
| `ANTHROPIC_API_KEY` | `x-api-key: <值>` | En mode interactif, une fenêtre demande la première fois si vous souhaitez utiliser cette clé API |
Les deux sont prises en charge ; nous recommandons `ANTHROPIC_AUTH_TOKEN`. **N'en configurez qu'une seule des deux** : si un ancien `ANTHROPIC_API_KEY` officiel subsiste dans le système, supprimez-le pour éviter un mélange entraînant une erreur 401.
Deux règles faciles à négliger :
- Lorsque le `env` de `settings.json` et un export dans le terminal définissent la même variable, **settings.json prime**. Si la modification de la variable du terminal n'a pas pris effet, vérifiez d'abord settings.json.
- N'écrivez pas la clé API dans le `.claude/settings.json` du projet, ce fichier étant généralement soumis au dépôt. Pour différencier par projet, utilisez le `.claude/settings.local.json` non soumis.
## Mapping des modèles
Dans Claude Code, `opus`, `sonnet`, `haiku` et `fable` sont des alias ; vous pouvez préciser via des variables d'environnement les modèles concrets auxquels ils correspondent. Le niveau Haiku est également utilisé par Claude Code pour exécuter certaines petites tâches d'arrière-plan.
| Variable | Rôle | Valeur d'exemple |
|---|---|---|
| `ANTHROPIC_MODEL` | Modèle utilisé au démarrage | `claude-sonnet-5-5` |
| `ANTHROPIC_DEFAULT_OPUS_MODEL` | Modèle auquel pointe l'alias `opus` | `claude-opus-5-5` |
| `ANTHROPIC_DEFAULT_SONNET_MODEL` | Modèle auquel pointe l'alias `sonnet` | `claude-sonnet-5-5` |
| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Modèle pour l'alias `haiku` et les tâches d'arrière-plan | `claude-haiku-5-5` |
| `ANTHROPIC_DEFAULT_FABLE_MODEL` | Modèle auquel pointe l'alias `fable` | `claude-fable-5-1` |
```json title="~/.claude/settings.json（带模型映射）"
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
"ANTHROPIC_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
}
}
```
L'ID du modèle doit figurer parmi les [modèles pris en charge](/fr/docs/models/). Pendant l'exécution, vous pouvez aussi basculer temporairement avec `/model claude-opus-5-5`.
## Extension VS Code
L'extension VS Code de Claude Code vérifie les identifiants avant le démarrage ; l'officiel recommande de placer les variables dans les paramètres utilisateur de VS Code eux-mêmes (palette de commandes → Preferences: Open User Settings (JSON)) :
```json title="VS Code settings.json"
{
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://1zheai.com" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-你的Key" }
]
}
```
Si vous n'écrivez que dans `~/.claude/settings.json`, la vérification de connexion propre à l'extension risque de ne pas les lire.
## Paramètres facultatifs
| Variable | Rôle |
|---|---|
| `API_TIMEOUT_MS` | Délai d'attente des requêtes, 600000 par défaut (10 minutes) ; à augmenter si les tâches longues dépassent souvent le délai |
| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` | Désactive les mises à jour automatiques, la télémétrie, la remontée d'erreurs et autres flux non essentiels. Attention : la valeur `0` ou `false` compte aussi comme activé ; pour désactiver, il faut supprimer cette variable |
| `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` | À utiliser face aux erreurs 400 du type "Extra inputs are not permitted" |
| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` | Fait récupérer la liste `/model` des modèles disponibles depuis `/v1/models` |
`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` a été testé et fonctionne (Claude Code 2.1.296, 2026-10-15) : après le démarrage, le journal de debug contient `[gatewayDiscovery] cached 14 models`, et les 14 modèles correspondent aux [modèles pris en charge](/fr/docs/models/).
Ne configurez pas `DISABLE_PROMPT_CACHING` : cela désactive le cache et la facture augmentera nettement, voir [Prompt Caching](/fr/docs/prompt-caching/).
## Questions fréquentes
Claude Code n'a pas lu la clé API. Vérifiez l'orthographe du nom de la variable ; si vous utilisez des variables d'environnement, assurez-vous de lancer dans un terminal nouvellement ouvert ; si vous utilisez settings.json, vérifiez le format JSON (une virgule en trop invalide l'ensemble).
La clé API a été copiée de façon incomplète, ou `ANTHROPIC_API_KEY` et `ANTHROPIC_AUTH_TOKEN` coexistent avec l'une des valeurs obsolètes. Ne gardez qu'une seule des deux. Pour plus de détails, voir [codes d'erreur et dépannage](/fr/docs/troubleshooting/).
`ANTHROPIC_BASE_URL` contient en trop `/v1`. Remplacez par `https://1zheai.com`.
C'est Claude Code qui exécute de petites tâches d'arrière-plan avec le niveau Haiku. Pour changer de modèle, définissez `ANTHROPIC_DEFAULT_HAIKU_MODEL`.
Supprimez (ou commentez) les deux variables ci-dessus pour revenir à la connexion officielle. Si vous basculez souvent, utilisez [CC Switch](/fr/docs/quickstart-cc-switch/) : un clic suffit.
Aucune association n'est créée. Lors de l'intégration à 1折AI, Claude Code utilise notre clé API et ne se connecte pas à votre compte Anthropic.
---
# Intégration de Codex CLI
Source: https://1zheai.com/fr/docs/quickstart-codex/
Markdown: https://1zheai.com/fr/docs/quickstart-codex.md
---
title: "Intégration de Codex CLI"
description: "Méthode de configuration pour l'intégration d'OpenAI Codex CLI à 1折AI (model_providers de ~/.codex/config.toml), appel des modèles GPT via l'interface Responses."
headingIds: {"Fichier de configuration":"section-1","Installer Codex":"section-2","Questions fréquentes":"section-3"}
---
Les modèles OpenAI / GPT sont en ligne. Codex CLI utilise l'interface OpenAI Responses (`/v1/responses`) et se connecte via la clé API de ce site. Les modèles disponibles et les prix sont consultables dans le [catalogue des modèles](https://1zheai.com/model-catalog?lng=fr).
Commençons par expliquer clairement la configuration d'un fournisseur personnalisé pour Codex ; le format provient de la [documentation officielle de configuration de Codex](https://developers.openai.com/codex/config-reference).
## Fichier de configuration
La configuration de Codex se trouve dans `~/.codex/config.toml`. Les fournisseurs personnalisés ne peuvent être définis que dans ce fichier au niveau utilisateur ; les paramètres `.codex/config.toml` définissant `model_provider` dans un projet seront ignorés.
```toml title="~/.codex/config.toml"
model_provider = "onezhe"
model = "gpt-6-astra"
[model_providers.onezhe]
name = "1折AI"
base_url = "https://1zheai.com/v1"
env_key = "ONEZHE_API_KEY"
wire_api = "responses"
```
L'exemple utilise `gpt-6-astra` ; vous pouvez le remplacer par un autre identifiant de modèle GPT pris en charge par votre clé.
Signification de quelques champs :
| Champ | Description |
|---|---|
| `model_provider` | Quel fournisseur utiliser, correspondant à l'id de `[model_providers.]` ci-dessous. `openai`, `ollama` et `lmstudio` sont des noms réservés et ne peuvent pas être utilisés |
| `base_url` | doit inclure `/v1` |
| `env_key` | Codex lit la clé API (API key) depuis cette variable d'environnement ; le nom doit correspondre exactement à celui que vous exportez |
| `wire_api` | La documentation officielle indique que seul `responses` est pris en charge actuellement ; c'est aussi la valeur par défaut si omis |
Ensuite, placez la clé API dans une variable d'environnement :
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows PowerShell"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
```
## Installer Codex
Les commandes suivantes proviennent de la documentation officielle de Codex :
```bash title="npm"
npm install -g @openai/codex
```
```bash title="Homebrew"
brew install --cask codex
```
```bash title="macOS / Linux 脚本"
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
```powershell title="Windows"
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
```
## Questions fréquentes
Le nom de variable écrit dans `env_key` ne correspond pas à celui que vous exportez réellement, ou vous avez ouvert le terminal avant de définir la variable d'environnement. Vérifiez les noms des deux côtés, rouvrez le terminal et réessayez.
Non. Dans la documentation officielle de configuration de Codex, `wire_api` n'accepte que `responses`. Les services qui ne proposent que l'interface Chat Completions ont besoin d'un outil de conversion de protocole supplémentaire pour se connecter à Codex.
Consultez le [catalogue des modèles](https://1zheai.com/model-catalog?lng=fr) pour voir les modèles actuels, puis renseignez l'identifiant du modèle dans `model`. Après avoir lancé Codex, envoyez une requête brève et vérifiez le modèle et l'état dans le [journal des appels](/fr/docs/usage-logs/).
---
# Intégration de l'API Claude avec OpenCode
Source: https://1zheai.com/fr/docs/quickstart-opencode/
Markdown: https://1zheai.com/fr/docs/quickstart-opencode.md
---
title: "Intégration de l'API Claude avec OpenCode"
description: "Tutoriel de configuration de l'adresse, de la clé et des modèles de l'API Claude de relais 1折AI dans OpenCode, incluant le choix du protocole, des exemples de configuration, des étapes de vérification et des erreurs courantes."
headingIds: {"Configuration d’OpenCode v1":"section-1","Configuration d’OpenCode v2":"section-2","Vérification de l’intégration et dépannage":"section-3","Coûts et autres méthodes d’intégration":"section-4"}
---
Utilisez la fonctionnalité de fournisseur personnalisé d'OpenCode pour vous connecter à 1折AI. D'abord, [créez une clé API](/fr/docs/api-keys/) et vérifiez les [modèles actuellement disponibles](/fr/docs/models/) ; les ID de modèles ci-dessous sont des exemples, veuillez les ajuster en fonction des autorisations de votre clé.
Date de vérification de la configuration officielle : 2026-10-15. La configuration suivante est basée sur la documentation officielle ; la vérification de bout en bout sur ce site n'est pas encore terminée ; veuillez d'abord effectuer une courte vérification par questions-réponses et un appel d'outil avant de l'utiliser pour de longues tâches. Les modèles OpenAI / GPT sont en ligne, la liste des modèles et les prix sont disponibles dans la [description des modèles](/fr/docs/models/).
## Configuration d’OpenCode v1
Selon les [Providers officiels v1](https://opencode.ai/docs/providers/) : exécutez `/connect`, sélectionnez Other, entrez l'ID du fournisseur `onezhe`, et renseignez la clé API de ce site. Fusionnez dans le projet `opencode.json` :
```json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"onezhe": {
"npm": "@ai-sdk/openai-compatible",
"name": "1折AI",
"options": { "baseURL": "https://1zheai.com/v1" },
"models": {
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
}
}
}
}
```
Ensuite, `/models` sélectionnez le modèle de ce fournisseur. `/connect` ne sauvegarde que les identifiants, il ne remplace pas la configuration du fournisseur. Sélectionnez ici explicitement le SDK de Chat Completions ; ne le remplacez pas par erreur par `@ai-sdk/openai` utilisé pour Responses. L'officiel permet également de référencer des variables d'environnement via `options.apiKey: "{env:ONEZHE_API_KEY}"`.
## Configuration d’OpenCode v2
Selon les [Providers officiels v2](https://opencode.ai/v2/docs/providers), utilisez les champs natifs v2, ne les mélangez pas avec le v1 ci-dessus. Fusionnez dans le projet `opencode.jsonc` :
```json
{
"$schema": "https://opencode.ai/config.json",
"providers": {
"onezhe": {
"name": "1折AI",
"env": ["ONEZHE_API_KEY"],
"package": "@opencode/ai/providers/openai-compatible",
"settings": { "baseURL": "https://1zheai.com/v1" },
"models": {
"claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
}
}
}
}
```
Fournissez `ONEZHE_API_KEY` dans l'environnement du processus lançant OpenCode, puis `/models` sélectionnez `onezhe/claude-sonnet-4-6`. Les principales différences de v2 sont `providers`, `package`, `settings`, et non `provider`, `npm`, `options` comme en v1. Veuillez d'abord confirmer la version majeure utilisée avec `opencode --version`.
Si vous souhaitez utiliser Anthropic natif, le v1 officiel permet de remplacer `provider.anthropic.options.baseURL`, l'exemple inclut `/v1` ; le v2 liste `@opencode/ai/providers/anthropic-compatible`. Ce tutoriel suit une configuration compatible OpenAI explicite ; ne changez pas de protocole en fonction du nom du modèle et ne promettez pas que la mise en cache et les appels d'outils sont déjà vérifiés.
## Vérification de l’intégration et dépannage
1. Enregistrez et rechargez la configuration, vérifiez que le fournisseur `onezhe` ou le modèle personnalisé que vous avez ajouté est actuellement sélectionné.
2. Envoyez une question courte, vérifiez qu'une réponse est retournée ; puis essayez une petite tâche réversible, vérifiez séparément l'appel d'outil et la conversation multi-tours.
3. Ouvrez les [journaux d'appels](/fr/docs/usage-logs/), vérifiez l'heure de la requête, le modèle, le statut et l'utilisation. Une réponse textuelle réussie ne signifie pas que toutes les capacités des agents sont compatibles.
4. En cas de 404, vérifiez que l'adresse et le protocole de cet article sont assortis ; en cas de 401, vérifiez l'origine de la clé et si le processus a lu les variables d'environnement ; en cas de 429, consultez les informations de limitation de débit avant de réessayer. Pour plus de cas, voir les [codes d'erreur et le dépannage](/fr/docs/troubleshooting/).
Les clés ne sont sauvegardées que dans l'environnement local ou le stockage d'identifiants de l'outil ; ne les soumettez pas à un dépôt de code, ne les capturez pas en capture d'écran et ne les publiez pas dans des journaux. Les services d'arrière-plan peuvent ne pas hériter des variables d'environnement du terminal ; les modèles auxiliaires, la recherche et d'autres outils peuvent également avoir des paramètres de fournisseur indépendants, à vérifier séparément.
## Coûts et autres méthodes d’intégration
Consultez les [prix en temps réel de l'API Claude](https://1zheai.com/en/pricing/) et les [règles de facturation](/fr/docs/pricing-explained/). Pour d'autres clients, retournez au [catalogue d'intégration des outils](/fr/docs/integrations/) ; pour écrire votre propre programme, utilisez le [SDK et le guide de développement](/fr/docs/guides/).
---
# Intégration avec Cursor
Source: https://1zheai.com/fr/docs/quickstart-cursor/
Markdown: https://1zheai.com/fr/docs/quickstart-cursor.md
---
title: "Intégration avec Cursor"
description: "Appeler les modèles Claude de 1折AI dans Cursor avec une clé API OpenAI personnalisée et une URL de base, ainsi que les fonctionnalités qui n'utilisent pas la clé API personnalisée."
headingIds: {"Configuration":"section-1","Problèmes connus":"section-2","Questions fréquentes":"section-3"}
---
Cursor permet de renseigner sa propre clé API (API key) dans les paramètres ; les modèles de chat envoient les requêtes avec cette clé API. Voici la procédure d'intégration avec 1折AI, ainsi que plusieurs restrictions à connaître avant de commencer.
Prenez d'abord connaissance de ces trois points avant de vous lancer :
- Selon la documentation officielle de Cursor, **la clé API personnalisée ne s'applique qu'aux modèles de chat ; l'auto-complétion Tab utilise toujours les modèles propres à Cursor**.
- Les requêtes passent d'abord par les serveurs de Cursor avant d'être envoyées à l'adresse que vous avez renseignée ; l'URL de base doit donc être accessible sur Internet public (`https://1zheai.com/v1` convient, un proxy local `localhost` ne convient pas).
- L'interrupteur « Override OpenAI Base URL » n'apparaît pas dans la documentation officielle de Cursor ; la description de l'interface ci-dessous provient du forum Cursor et de tutoriels communautaires, et peut changer après une refonte de Cursor.
## Configuration
Cursor → **Cursor Settings** → **Models**, localisez la section Keys.
```text
OpenAI API Key sk-你的Key（1折AI 的 Key）
Override OpenAI Base URL https://1zheai.com/v1
```
L'URL de base doit inclure `/v1`.
Dans la liste des modèles, cliquez sur **Add model**, saisissez l'identifiant du modèle, par exemple `claude-sonnet-5-5`, puis activez son interrupteur. Les identifiants de modèles sont listés dans les [modèles pris en charge](/fr/docs/models/).
Sélectionnez le modèle que vous venez d'ajouter dans le panneau Chat et envoyez un message. Une fois la réponse correcte, vérifiez cet appel dans les [journaux d'appel](/fr/docs/usage-logs/) de la console.
## Problèmes connus
Des retours sur le forum Cursor indiquent qu'après avoir défini Override OpenAI Base URL, les modèles dont le nom commence par `claude-` peuvent être considérés par Cursor comme des modèles Anthropic, pris en charge par la clé API Anthropic, ou provoquer directement une erreur. Lors du choix de Claude, l'identifiant du modèle commence par `claude-` ; si vous rencontrez ce problème, videz d'abord la clé API Anthropic renseignée dans Cursor, puis réessayez.
Références : [publication du forum 144899](https://forum.cursor.com/t/anthropic-models-break-when-override-openai-baseurl-is-set/144899), [publication du forum 146998](https://forum.cursor.com/t/override-anthropic-base-url-automatically-switches-on-when-using-anthropic-byok/146998).
## Questions fréquentes
Non. Selon la documentation officielle de Cursor, l'auto-complétion Tab utilise toujours les modèles fournis par Cursor et ne passe pas par votre clé API.
Vérifiez d'abord que l'URL de base inclut `/v1`. La communauté signale que le bouton Verify ne passe pas nécessairement pour des noms de modèles non OpenAI ; vous pouvez directement envoyer un message dans le Chat pour tester, en vous basant sur l'enregistrement dans les journaux d'appel.
Les tutoriels communautaires indiquent généralement que seul le Chat utilise la clé API personnalisée ; des fonctionnalités comme Agent, Apply, Inline Edit peuvent encore passer par le backend propre à Cursor. Faites foi de ce que vous voyez réellement dans les journaux d'appel.
Si votre objectif principal est d'écrire du code avec Claude, [Claude Code](/fr/docs/quickstart-claude-code/) (ligne de commande ou extension VS Code) et [Cline](/fr/docs/quickstart-cline/) offrent une prise en charge plus complète des adresses personnalisées.
---
# Intégration de Cline
Source: https://1zheai.com/fr/docs/quickstart-cline/
Markdown: https://1zheai.com/fr/docs/quickstart-cline.md
---
title: "Intégration de Cline"
description: "Intégrer 1折AI dans l'extension Cline de VS Code : via Base URL personnalisé Anthropic, ou via OpenAI Compatible."
headingIds: {"Méthode 1 : Anthropic (recommandée)":"section-1","Méthode 2 : OpenAI Compatible":"section-2","Questions fréquentes":"section-3"}
---
Cline est une extension d'Agent de programmation dans VS Code. Les deux méthodes permettent d'intégrer 1折AI ; la méthode Anthropic est recommandée, les capacités natives de Claude (y compris le cache) étant plus complètes.
## Méthode 1 : Anthropic (recommandée)
Ouvrez les paramètres de Cline, sélectionnez **Anthropic** dans **API Provider**.
- **Anthropic API Key** (saisissez la clé API) : `sk-你的Key`
- Cochez **Use custom base URL**, saisissez `https://1zheai.com` (n'ajoutez pas `/v1`)
Dans la liste déroulante des modèles, sélectionnez un modèle pris en charge par 1折AI [modèles pris en charge](/fr/docs/models/), par exemple `claude-sonnet-5-5`.
## Méthode 2 : OpenAI Compatible
Sélectionnez **OpenAI Compatible** dans **API Provider**.
| Champ | Valeur |
|---|---|
| Base URL | `https://1zheai.com/v1` |
| API Key | `sk-你的Key` |
| Model ID | `claude-sonnet-5-5` |
Cliquez sur **Verify** pour confirmer la connexion, puis envoyez une petite tâche dans Cline.
Dans Model Configuration, vous pouvez renseigner la fenêtre de contexte et la longueur de sortie maximale ; saisissez les valeurs correspondantes au modèle en vous référant à la [documentation officielle des modèles Anthropic](https://platform.claude.com/docs/en/about-claude/models/overview).
## Questions fréquentes
La méthode Anthropic utilise le `/v1/messages` natif, offrant les capacités les plus complètes (cache, thinking, etc.) ; la méthode OpenAI Compatible utilise le `/v1/chat/completions`, avantageuse pour sa polyvalence. Lors de l'utilisation de modèles Claude, privilégiez la méthode Anthropic.
L'adresse de la méthode Anthropic ne doit pas inclure `/v1` ; l'adresse de la méthode OpenAI Compatible doit inclure `/v1`. Les deux sont exactement opposés.
---
# Intégration dans Cherry Studio
Source: https://1zheai.com/fr/docs/quickstart-cherry-studio/
Markdown: https://1zheai.com/fr/docs/quickstart-cherry-studio.md
---
title: "Intégration dans Cherry Studio"
description: "Ajoutez 1折AI comme fournisseur personnalisé dans Cherry Studio, choisissez le point de terminaison Anthropic ou OpenAI, puis renseignez l'adresse racine, la clé API et les modèles."
headingIds: {"Import en un clic":"section-1","Configuration":"section-2","Choisir entre les points de terminaison Anthropic et OpenAI":"section-3","Questions fréquentes":"section-4"}
---
Cherry Studio est un client de conversation IA pour ordinateur de bureau qui permet d'ajouter 1折AI comme fournisseur personnalisé.
## Import en un clic
Dans la console, sous **Clé API → Outils d'utilisation → Cherry Studio**, sélectionnez le protocole Anthropic ou OpenAI, puis cliquez sur **Ouvrir Cherry Studio**. Après avoir confirmé l'import dans l'application, récupérez les modèles, activez le fournisseur et effectuez un test. Si une configuration du même nom existe déjà, vérifiez l'avertissement de remplacement. Le lien d'import contient la clé complète ; ne le transmettez pas.
Le navigateur ne peut pas confirmer si l'application est installée. Si elle ne s'ouvre pas, installez d'abord le client et lancez-le une fois, ou utilisez les étapes manuelles ci-dessous. Le format du protocole a été vérifié par rapport à l'implémentation officielle ; l'inférence réelle doit encore être validée selon la version et les modèles effectivement utilisés.
## Configuration
Paramètres (icône engrenage) → **Services de modèles** → **+ Ajouter un fournisseur** en bas de la liste.
| Champ | Valeur à renseigner |
|---|---|
| Nom du fournisseur | `1折AI` |
| Clé API | `sk-你的Key` |
| Point de terminaison | Choisissez **Anthropic** (recommandé) ou **OpenAI** |
| Adresse API | `https://1zheai.com` |
Renseignez uniquement l'adresse racine dans le champ Adresse API ; Cherry Studio ajoutera automatiquement `/v1/...` selon le protocole choisi. Ne collez pas des chemins complets tels que `/v1/messages` ou `/v1/chat/completions`, et n'ajoutez pas `#` à la fin (une fin par `#` indique que le chemin ne sera plus ajouté automatiquement).
Cliquez sur **Récupérer la liste des modèles**, puis ajoutez les modèles à utiliser depuis la liste retournée ; ou cliquez sur **+** pour saisir manuellement l'identifiant de modèle, par exemple `claude-sonnet-5-5`. Seuls les modèles ajoutés à la liste apparaîtront dans la sélection de modèles de la conversation.
Activez l'interrupteur d'activation en haut à droite de la page du fournisseur, revenez à l'interface de conversation, sélectionnez un modèle sous 1折AI et envoyez un message.
## Choisir entre les points de terminaison Anthropic et OpenAI
| Point de terminaison | Adapté à |
|---|---|
| Anthropic | Utiliser les capacités natives de Claude telles que l'extended thinking ; pour les restrictions de protocole de l'Agent, référez-vous à la version actuelle |
| OpenAI | Être habitué au format OpenAI, ou gérer de manière unifiée avec d'autres services compatibles OpenAI |
Les deux points de terminaison utilisent la même clé API (API key) et le même ensemble d'identifiants de modèles.
## Questions fréquentes
Vérifiez d'abord si la clé API contient des espaces superflus ; puis confirmez que l'adresse API est `https://1zheai.com`, sans chemin supplémentaire. Si la récupération échoue, cela n'empêche pas l'utilisation ; la saisie manuelle de l'identifiant de modèle fonctionne également.
L'adresse API a été saisie sous forme de chemin complet, ou `#` a été ajouté à la fin. Revenez à l'adresse racine `https://1zheai.com`.
---
# Intégration de Dify
Source: https://1zheai.com/fr/docs/quickstart-dify/
Markdown: https://1zheai.com/fr/docs/quickstart-dify.md
---
title: "Intégration de Dify"
description: "Configurez 1折AI à l'aide du plugin officiel OpenAI-API-compatible de Dify : configuration du modèle, test de conversation et dépannage du premier appel."
headingIds: {"Préparation":"section-1","Ajouter un modèle":"section-2","Commencer dès la première conversation":"section-3","Importer un Chatflow d’exemple":"section-4","Questions fréquentes":"section-5","Obtenir de l’aide pour l’intégration":"section-6","Portée de la vérification":"section-7","English / Русский":"section-8"}
---
Les utilisateurs de Dify peuvent configurer l'interface compatible OpenAI de 1折AI via le plugin officiel de modèle **OpenAI-API-compatible**. Vérifiez d'abord un modèle de texte, puis utilisez-le dans un flux de travail ; n'installez pas de plugin tiers provenant d'une source non vérifiée.
## Préparation
- Un espace de travail Dify permettant d'installer des plugins de modèle.
- Votre propre clé API 1折AI, ainsi que les ID de modèles que cette clé est autorisée à appeler. Consultez-les dans la[console](https://1zheai.com/console?lng=fr).
- Un solde disponible suffisant sur votre compte. La requête de validation lors de l'enregistrement du modèle et les tests d'application peuvent entraîner des frais API normaux.
N'envoyez jamais la clé complète au support client, ne l'inscrivez pas dans la documentation d'un flux de travail, ne la capturez pas dans une capture d'écran ni ne la publiez dans un dépôt public. Enregistrez-la uniquement dans le champ de clé API Key de Dify ; si vous utilisez un Dify hébergé par un tiers, cette instance détiendra votre clé et transmettra les requêtes.
## Ajouter un modèle
1. Dans le marché de plugins Dify, trouvez **OpenAI-API-compatible** et vérifiez que l'éditeur est **langgenius**.
2. Ouvrez les paramètres de l'espace de travail, allez dans les fournisseurs de modèles, trouvez ce plugin et ajoutez un modèle LLM.
3. Remplissez selon le tableau ci-dessous, puis enregistrez. Les intitulés de l'interface peuvent varier selon la version de Dify.
| Champ | Mode de remplissage |
| --- | --- |
| Model Name / Nom du modèle | Copiez l'ID de modèle complet depuis la console 1折AI ; ne le remplacez pas par le nom d'affichage |
| API Key | Votre propre clé 1折AI |
| API Base URL | `https://1zheai.com/v1` |
| Completion mode / Type de conversation | `Chat` |
| Nom du modèle dans l'API endpoint | Laissez vide en général ; si défini, il doit correspondre exactement à l'ID de modèle réel |
| Model context size | Renseignez selon la capacité réelle du modèle choisi ; ne recopiez pas la longueur de contexte d'un autre modèle |
Ici, il faut `/v1` ; n'inscrivez pas l'adresse complète `/v1/chat/completions` et ne la dupliquez pas en `/v1/v1`. N'appliquez pas les instructions d'autres clients qui ne renseignent que l'adresse racine.
## Commencer dès la première conversation
Créez une application de chat vide, sélectionnez le modèle que vous venez d'enregistrer, puis saisissez « Présente en une phrase ce que tu sais faire » en chinois. Une fois le texte complet renvoyé, vérifiez ensuite la sortie en flux.
Dans les journaux d'appels de la console 1折AI, vérifiez l'heure de la requête correspondante, le modèle et le résultat. Ne vous basez pas uniquement sur le « Enregistré avec succès » de Dify pour conclure que l'application est connectée. Après le premier succès, configurez les appels d'outils, les entrées visuelles ou la recherche dans la base de connaissances ; ces capacités dépendent du modèle et de l'interface précis et ne doivent pas être considérées comme toutes disponibles au seul motif que la conversation en texte a réussi.
## Importer un Chatflow d’exemple
[Téléchargez le modèle de Chatflow sans clé](/fr/docs/downloads/1zheai-dify-chatflow.yml), puis dans Dify Studio, choisissez **Create → Import DSL file** pour l'importer. Le modèle est `User Input → LLM → Answer`, version DSL 0.7.0, et utilise le plugin compatible officiel 0.0.68.
Ajoutez d'abord vos propres identifiants selon les étapes ci-dessus. Après l'import, ouvrez le nœud LLM et vérifiez que votre fournisseur et votre modèle sont sélectionnés, et non les modèles d'essai de Dify. L'ID de modèle d'exemple est `claude-haiku-4-5-20251001` ; si ce modèle n'est pas disponible sur votre compte, remplacez-le par un modèle auquel vous avez accès et vérifiez les paramètres de capacités. Le modèle ne contient pas de clé API et ne fournit aucun quota d'appels gratuit.
## Questions fréquentes
| Symptôme | À vérifier en premier |
| --- | --- |
| 503 / No available accounts | L'amont actuel est peut-être limité ou sans capacité disponible. Consultez d'abord l'état du service et les journaux d'appels, réessayez plus tard avec une limite raisonnable ou contactez le support ; ne réessayez pas en continu à haute fréquence et ne régénérez pas la clé à répétition |
| 401 / Clé invalide | Y a-t-il des espaces en trop, la clé a-t-elle été révoquée, et une clé d'une autre plateforme a-t-elle été utilisée par erreur ? |
| 404 | L'Base URL est-il exactement `https://1zheai.com/v1` ; l'ID de modèle existe-t-il ? |
| Modèle sans permission ou quota insuffisant | Les restrictions de modèle de la clé actuelle, le solde disponible du compte et le modèle choisi |
| Enregistrement réussi, mais l'application ne peut pas appeler | L'application a-t-elle sélectionné le bon fournisseur et le bon modèle ; le serveur de l'espace de travail peut-il accéder à l'API ? |
| Réponses normales, flux anormal | Vérifiez le support SSE du proxy, la version du plugin et le paramètre d'usage en flux ; conservez l'erreur masquée pour le dépannage |
| Échec des appels d'outils ou de la vision | Vérifiez d'abord que le modèle choisi prend réellement en charge cette capacité ; n'activez pas de force en modifiant seulement le commutateur du plugin |
Les requêtes d'un Dify auto-hébergé proviennent de son serveur ; le fait que votre navigateur puisse ouvrir le site officiel ne signifie pas que le serveur Dify peut se connecter à l'API.
## Obtenir de l’aide pour l’intégration
Fournissez via le service client en ligne du site officiel la version de Dify, la version du plugin, l'ID de modèle, l'heure de l'erreur, l'ID de requête et l'erreur masquée. N'envoyez pas la clé complète, les données clients ni les invites privées des flux de travail.
## Portée de la vérification
Le 2026-10-19, avec le plugin officiel 0.0.68, la conversation texte Haiku et l'appel en flux ont été réalisés dans Dify Cloud et correspondent aux journaux de la passerelle. Le DSL sans clé exporté a été importé dans le même espace de travail en tant que nouvelle application. Après l'import, un test ultérieur a rencontré un 503 dû à une limite amont ; cette passe n'est donc pas comptée comme réussie après import.
Il s'agit d'un test interne avec une plage de temps précise, pas d'une garantie de disponibilité continue. L'import dans un espace de travail neuf, les anciennes versions de Dify, les appels d'outils, la vision et la recherche dans la base de connaissances n'ont pas encore été vérifiés ; effectuez votre premier test avec votre propre clé dans les limites de votre quota.
[Code source du plugin officiel](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible) · [Marché de plugins Dify](https://marketplace.dify.ai/)
## English / Русский
**English:** Install the official OpenAI-API-compatible plugin by langgenius. Set API Base URL to `https://1zheai.com/v1`, use your own API key and an exact model ID available to your account, and select Chat mode. Test a simple conversation before adding tools or vision. Text and streaming calls were verified in Dify Cloud on 2026-10-19. DSL import into a new app in the same workspace succeeded; its subsequent run encountered an upstream-capacity 503. Fresh-workspace import and advanced capabilities remain unverified. Never share your key with support.
**Русский:** Установите официальный плагин OpenAI-API-compatible от langgenius. Укажите API Base URL `https://1zheai.com/v1`, собственный API-ключ и точный ID модели, доступной вашему аккаунту; выберите режим Chat. Сначала проверьте простой диалог, затем потоковый вывод. Текстовые и потоковые вызовы проверены в Dify Cloud 19 октября 2026 года. Импорт DSL в новое приложение того же рабочего пространства прошёл, но повторный вызов вернул 503 из-за недоступной мощности upstream. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.
---
# Connecter WorkBuddy à l'API Claude
Source: https://1zheai.com/fr/docs/quickstart-workbuddy/
Markdown: https://1zheai.com/fr/docs/quickstart-workbuddy.md
---
title: "Connecter WorkBuddy à l'API Claude"
description: "Un tutoriel sur la configuration de l'adresse, de la clé et du modèle du relais API Claude 1折AI dans WorkBuddy, incluant la sélection du protocole, des exemples de configuration, des étapes de vérification et des erreurs courantes."
headingIds: {"Vérifier la connexion et résoudre les problèmes":"section-1","Coûts et autres méthodes de connexion":"section-2"}
---
Utilisez la fonctionnalité de fournisseur personnalisé de WorkBuddy pour vous connecter à 1折AI. D'abord, [créez une clé API](/fr/docs/api-keys/), et confirmez les [modèles actuellement disponibles](/fr/docs/models/) ; les identifiants de modèles ci-dessous sont des exemples, ajustez-les donc en fonction des autorisations de votre clé.
Date de vérification officielle de la configuration : 2026-10-15. La configuration suivante est compilée à partir de la documentation officielle ; la vérification de bout en bout sur ce site n'a pas encore été terminée. Veuillez d'abord effectuer une brève vérification de questions-réponses et d'appels d'outils avant de l'utiliser pour de longues tâches. Les modèles OpenAI / GPT sont désormais actifs ; consultez [la description des modèles](/fr/docs/models/) pour la liste des modèles et les tarifs.
Basée sur [la configuration officielle des modèles](https://www.workbuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model) : Paramètres → Modèles → Ajouter un modèle → Personnalisé. Renseignez la clé de ce site et le modèle `claude-sonnet-4-6`.
Utilisez la configuration d'URL de requête complète : activez « Protocole personnalisé » dans la configuration avancée, entrez `https://1zheai.com/v1/chat/completions` comme URL, et après l'enregistrement, sélectionnez ce modèle dans le sélecteur de modèle de conversation. La documentation officielle indique que l'activation de ce commutateur utilisera directement l'URL saisie, sans validation de chemin ni complétion automatique ; lorsqu'il est désactivé, il complétera selon le standard `/chat/completions`. Par conséquent, l'URL complète et le commutateur doivent être décrits ensemble.
Ici, « Protocole personnalisé » ne signifie pas que les requêtes OpenAI peuvent être automatiquement converties en requêtes Anthropic. Vous ne pouvez pas entrer `/v1/messages` puis prétendre que le protocole natif Claude est connecté. Préférez l'interface utilisateur ; ne fournissez pas de formats manuels non vérifiés comme `models.json`. La page officielle affiche simultanément le chemin de configuration local actuel et les anciennes notes de migration `~/.codebuddy/models.json` ; évitez d'écrire l'ancien chemin comme chemin actuel universel sur la base de cela. Les marqueurs de capacité d'outil sur l'interface ne peuvent pas non plus remplacer la vérification de bout en bout sur ce site.
## Vérifier la connexion et résoudre les problèmes
1. Enregistrez et rechargez la configuration, et confirmez que l'élément actuellement sélectionné est le fournisseur `onezhe` ou le modèle personnalisé que vous avez ajouté.
2. Envoyez une question courte pour confirmer qu'une réponse peut être retournée ; puis essayez une petite tâche réversible pour vérifier séparément les appels d'outils et la conversation multi-tours.
3. Ouvrez le [journal des appels](/fr/docs/usage-logs/) et vérifiez l'heure de la requête, le modèle, le statut et l'utilisation. Une seule réponse textuelle réussie ne signifie pas que toutes les capacités Agent sont compatibles.
4. Si vous rencontrez une erreur 404, vérifiez si l'adresse et le protocole de cet article correspondent ; si vous rencontrez une erreur 401, vérifiez la source de la clé et si le processus a lu les variables d'environnement ; si vous rencontrez une erreur 429, vérifiez les informations de limitation de débit avant de réessayer. Consultez [les codes d'erreur et le dépannage](/fr/docs/troubleshooting/) pour plus de situations.
Les clés ne doivent être stockées que dans l'environnement local ou le magasin d'identifiants de l'outil ; ne les commitez pas dans des dépôts de code, des captures d'écran ou des journaux publics. Les services d'arrière-plan peuvent ne pas hériter des variables d'environnement du terminal ; les modèles auxiliaires, la recherche et d'autres outils peuvent également avoir des paramètres de fournisseur indépendants qui doivent être vérifiés séparément.
## Coûts et autres méthodes de connexion
Consultez [les tarifs en temps réel de l'API Claude](https://1zheai.com/en/pricing/) et [les règles de facturation](/fr/docs/pricing-explained/). Si vous avez besoin d'autres clients, revenez au [répertoire de connexion des outils](/fr/docs/integrations/) ; si vous écrivez votre propre programme, utilisez [le SDK et le guide de développement](/fr/docs/guides/).
---
# Importation et configuration en un clic de Chatbox
Source: https://1zheai.com/fr/docs/quickstart-chatbox/
Markdown: https://1zheai.com/fr/docs/quickstart-chatbox.md
---
title: "Importation et configuration en un clic de Chatbox"
description: "Importez Chatbox via la page des clés API et vérifiez l'API Host, le chemin, le modèle et la clé."
headingIds: {"Importation en un clic":"section-1","Presse-papiers et configuration manuelle":"section-2","Dépannage":"section-3"}
---
À partir de Chatbox 1.15.1, les fournisseurs JSON et `chatbox://provider/import` sont pris en charge. La version de bureau doit d'abord être installée et lancée une fois. Pour la version web ou les systèmes sans protocole d'enregistrement, utilisez l'importation via le presse-papiers.
## Importation en un clic
1. Ouvrez **Clés API** dans la console, trouvez la clé à utiliser, puis allez dans **Outils d'utilisation → Chatbox**.
2. Sélectionnez le modèle de chat disponible avec cette clé, puis cliquez sur **Ouvrir Chatbox** et autorisez le navigateur à ouvrir l'application.
3. Confirmez l'importation dans Chatbox et vérifiez l'adresse du fournisseur et le modèle. Si une configuration du même nom existe déjà, vérifiez d'abord la portée de l'écrasement.
4. Envoyez un court message et vérifiez le modèle et l'heure de la requête dans le journal d'appels de ce site.
## Presse-papiers et configuration manuelle
Si l'application n'a pas été lancée, copiez le **Chatbox JSON** dans le même panneau, puis dans la gestion des fournisseurs des paramètres de Chatbox, choisissez l'importation depuis le presse-papiers. Avant de partager avec d'autres, vous devez supprimer `settings.apiKey`.
| Champ | Valeur |
| --- | --- |
| Type | OpenAI API compatible |
| API Host | `https://1zheai.com` |
| API Path | `/v1/chat/completions` |
| API Key | Clé actuelle |
| Model ID | Modèle de chat disponible avec la clé actuelle |
Le Host et le Path se remplissent séparément ; n'ajoutez pas `/v1` aux deux champs en même temps. S'il n'y a pas de modèle, obtenez d'abord la liste des modèles ou ajoutez-en un manuellement ; les capacités telles que les images, les embeddings et les appels d'outils doivent être vérifiées séparément — ne considérez pas n'importe quel modèle comme un modèle de chat.
## Dépannage
- L'application ne s'ouvre pas : vérifiez qu'elle est installée et a été lancée, débloquez ce protocole dans le navigateur, ou utilisez l'importation via le presse-papiers.
- 401 après l'importation : vérifiez que la clé est valide et ne contient pas d'espaces.
- 404 : confirmez que le chemin final est `/v1/chat/completions` et n'est pas concaténé en double.
- Modèle inexistant : utilisez l'ID exact de la liste des modèles ; ne devinez pas à partir du surnom affiché.
Officiel : [protocole d'importation de configuration](https://docs.chatboxai.app/guides/providers/import-config), [code source du client](https://github.com/chatboxai/chatbox/blob/main/src/renderer/utils/provider-config.ts).
protocole vérifié par rapport aux documents officiels le 2026-10-19. Ce site a implémenté la génération de configuration et les tests de régression front-end ; la validation d'inférence réelle sur tous les clients, systèmes et modèles n'est pas terminée. Veuillez revérifier après la mise à jour du client. L'accès personnalisé ne constitue ni une coopération officielle ni une recommandation intégrée.
Plus : [Clés API](/fr/docs/api-keys/), [liste des modèles](/fr/docs/models/), [journal d'appels](/fr/docs/usage-logs/), [explication des adresses](/fr/docs/base-url/).
---
# RikkaHub : import par scan de code QR
Source: https://1zheai.com/fr/docs/quickstart-rikkahub/
Markdown: https://1zheai.com/fr/docs/quickstart-rikkahub.md
---
title: "RikkaHub : import par scan de code QR"
description: "Importez un fournisseur compatible OpenAI dans RikkaHub sur Android via le scan d'un code QR, configurez les modèles et résolvez les problèmes."
headingIds: {"Configuration par scan":"section-1","Alternative manuelle":"section-2","Dépannage":"section-3"}
---
RikkaHub est un client IA pour Android. Ce site utilise son format de partage `ai-provider:v1:` pour générer un code QR local, sans passer par un site de codes QR tiers.
## Configuration par scan
1. Dans la console : **Clé API → Outils → RikkaHub**.
2. Dans un environnement privé, cliquez sur **Afficher le code QR d'importation**. Le code QR équivaut à la clé complète ; ne partagez aucune capture d'écran.
3. Dans RikkaHub : **Paramètres → Paramètres du fournisseur → Importer**, choisissez le scan. Si les deux extrémités se trouvent sur le même téléphone, utilisez la fonction d'importation depuis une image du client, puis supprimez la capture d'écran contenant la clé après l'importation.
4. Après l'importation, récupérez la liste des modèles, sélectionnez un modèle de chat, envoyez un message court, puis vérifiez sur le journal d'appels de ce site.\5. Une fois terminé, masquez le code QR. S'il a été envoyé par erreur à quelqu'un, révoquez cette clé et recréez-en une.
## Alternative manuelle
| Champ | Valeur |
| --- | --- |
| Type | OpenAI |
| Base URL | `https://1zheai.com/v1` |
| Chemin Chat Completions | `/chat/completions` |
| Clé API | Clé actuelle |
L'importation ne préconfigure ni les capacités du modèle ni la longueur de contexte, et n'active pas l'option Responses. Si vous avez besoin de Responses, vérifiez d'abord le modèle sélectionné et la version du client, puis validez séparément.
## Dépannage
Si le scan échoue, vérifiez d'abord que le code QR est complet, que l'écran est net et que la version du client est correcte ; sinon, utilisez les champs manuels. Si la récupération de la liste des modèles échoue, vérifiez la clé et l'adresse ; une insuffisance de permissions ne peut pas être résolue en rescannant.
Officiel : [Démarrage rapide](https://github.com/rikkahub/docs/blob/main/quickstart.mdx), [Implémentation du format de partage](https://github.com/rikkahub/rikkahub/blob/master/app/src/main/java/me/rerere/rikkahub/ui/components/ui/ShareSheet.kt).
protocole et ressources officielles vérifiés le 2026-10-19. Ce site a implémenté la génération de configuration et des tests de régression front-end ; la validation réelle de l'inférence sur tous les clients, systèmes et modèles n'a pas été effectuée. Après la mise à jour du client, veuillez revérifier. Une intégration personnalisée ne constitue ni un partenariat officiel ni une recommandation intégrée.
Plus : [Clé API](/fr/docs/api-keys/), [Liste des modèles](/fr/docs/models/), [Journal d'appels](/fr/docs/usage-logs/), [Explication de l'adresse](/fr/docs/base-url/).
---
# ChatWise Fournisseurs personnalisés
Source: https://1zheai.com/fr/docs/quickstart-chatwise/
Markdown: https://1zheai.com/fr/docs/quickstart-chatwise.md
---
title: "ChatWise Fournisseurs personnalisés"
description: "Ajoutez un fournisseur compatible OpenAI dans les paramètres de ChatWise en renseignant la clé, l'adresse et les modèles."
headingIds: {"Capacités d’importation et vérification":"section-1"}
---
Créez un fournisseur OpenAI-compatible personnalisé dans **Settings → Providers → +** de ChatWise. La console **API Keys → Outils → ChatWise** fournit des champs copiables.
| Champ | Valeur |
| --- | --- |
| API URL / Base URL | `https://1zheai.com/v1` |
| API Key | Clé actuelle |
| Modèles | Sélectionnez après récupération des modèles, ou saisissez manuellement l'ID du modèle |
L'interface de liste des modèles est `/v1/models`. Si la version actuelle exige l'adresse complète de la requête plutôt que l'URL de base, renseignez `https://1zheai.com/v1/chat/completions` ; référez-vous à la description du champ. Désactivez les proxys tiers inutiles avant de tester la connexion directe.
## Capacités d’importation et vérification
Le `chatwise://chat` officiellement public sert à ouvrir une conversation, pas à importer des clés de fournisseur. Ce site ne le déguise pas en bouton d'importation de configuration. Les capacités d'image, de raisonnement et d'outils doivent être configurées en fonction du support réel de chaque modèle ; ne les activez pas toutes par défaut.
Envoyez un message court et vérifiez les journaux de ce site. 401 : vérifiez la clé ; 404 : vérifiez si le champ d'adresse attend un chemin complet ; si aucun modèle n'est disponible, saisissez manuellement un ID actuellement utilisable.
Officiel : [Fournisseurs personnalisés](https://docs.chatwise.app/custom-provider), [Accords d'utilisation de l'application](https://docs.chatwise.app/open-from-other-apps).
accords et documents officiels vérifiés le 2026-10-19. Ce site a implémenté la génération de configuration et des tests de régression front-end ; la vérification réelle du raisonnement sur tous les clients, systèmes et modèles n'a pas été effectuée. Revérifiez après la mise à niveau du client. L'accès personnalisé ne constitue ni une coopération officielle ni une recommandation intégrée.
Plus : [Clés API](/fr/docs/api-keys/), [Liste des modèles](/fr/docs/models/), [Journaux d'appels](/fr/docs/usage-logs/), [Explication de l'adresse](/fr/docs/base-url/).
---
# Point de terminaison personnalisé LibreChat
Source: https://1zheai.com/fr/docs/quickstart-librechat/
Markdown: https://1zheai.com/fr/docs/quickstart-librechat.md
---
title: "Point de terminaison personnalisé LibreChat"
description: "Les administrateurs configurent les points de terminaison personnalisés de LibreChat ; les utilisateurs saisissent individuellement leurs propres clés API."
headingIds: {"Configuration de l’administrateur":"section-1","Vérification et dépannage":"section-2"}
---
LibreChat exige qu'un administrateur du déploiement autorise les points de terminaison personnalisés ; les utilisateurs ordinaires ne peuvent pas réécrire la configuration du serveur distant à l'aide des boutons de ce site. La console **API Keys → Use Tools → LibreChat** fournit un extrait de configuration.
## Configuration de l’administrateur
Fusionnez dans le `librechat.yaml` existant le `endpoints.custom` ; ne remplacez pas les autres points de terminaison :
```yaml
endpoints:
custom:
- name: '1折AI'
apiKey: user_provided
baseURL: 'https://1zheai.com/v1'
models:
default: []
fetch: true
```
Appliquez la validation de configuration requise par la version actuelle et redémarrez le service, puis demandez aux utilisateurs de saisir leurs propres clés dans les paramètres des clés API de LibreChat. La configuration partagée ne contient pas de clés réelles. Si la récupération des modèles échoue, l'administrateur peut définir `default` sur un identifiant de modèle vérifié et fonctionnel et vérifier l'accès réseau sortant du serveur.
## Vérification et dépannage
Sélectionnez le point de terminaison et le modèle nouvellement ajoutés, envoyez une brève requête, puis consultez les journaux d'appels de ce site. Si le point de terminaison n'apparaît pas, vérifiez d'abord si l'emplacement de montage de configuration et le redémarrage ont pris effet ; pour une erreur 401, vérifiez la clé saisie par l'utilisateur ; pour une erreur 404, vérifiez que l'URL de base est `/v1` et non le chemin complet de la requête. Ne stockez pas de clés sur des instances LibreChat publiques non fiables.
Officiel : [Champs de point de terminaison personnalisé](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint).
protocole et documents officiels vérifiés le 2026-10-19. Ce site a mis en œuvre la génération de configuration et les tests de régression front-end ; la vérification d'inférence réelle sur l'ensemble des clients, systèmes et modèles n'a pas été terminée. Veuillez revérifier après les mises à jour du client. L'intégration personnalisée n'implique aucun partenariat officiel ni recommandation intégrée.
Plus : [Clés API](/fr/docs/api-keys/), [Liste des modèles](/fr/docs/models/), [Journaux d'appels](/fr/docs/usage-logs/), [Notes d'adresse](/fr/docs/base-url/).
---
# Intégration de l'API Claude dans OpenClaw
Source: https://1zheai.com/fr/docs/quickstart-openclaw/
Markdown: https://1zheai.com/fr/docs/quickstart-openclaw.md
---
title: "Intégration de l'API Claude dans OpenClaw"
description: "Tutoriel de configuration de l'adresse, de la clé et du modèle du relais 1折AI Claude API dans OpenClaw, incluant le choix du protocole, des exemples de configuration, des étapes de vérification et des erreurs courantes."
headingIds: {"Vérification de l’intégration et dépannage":"section-1","Coûts et autres méthodes d’intégration":"section-2"}
---
Utilisez la fonctionnalité de fournisseur personnalisé d'OpenClaw pour vous connecter à 1折AI. Commencez par [créer une clé API](/fr/docs/api-keys/) et confirmez les [modèles actuellement disponibles](/fr/docs/models/) ; les ID de modèle ci-dessous sont des exemples, veuillez les ajuster en fonction des permissions de votre clé.
Date de vérification de la configuration officielle : 2026-10-15. La configuration suivante est basée sur la documentation officielle ; la vérification de bout en bout sur ce site n'est pas encore terminée ; veuillez d'abord effectuer une courte question-réponse et une vérification d'appel d'outil avant de l'utiliser pour des tâches longues. Les modèles OpenAI / GPT sont en ligne, la liste des modèles et les prix sont disponibles dans la [description des modèles](/fr/docs/models/).
Sur la base du [fournisseur personnalisé](https://docs.openclaw.ai/gateway/config-tools/custom-providers) et de l'[exemple de configuration](https://docs.openclaw.ai/gateway/configuration-examples), fusionnez dans `~/.openclaw/openclaw.json` :
```json
{
"agents": {
"defaults": {
"model": { "primary": "onezhe/claude-sonnet-4-6" },
"models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
}
},
"models": {
"mode": "merge",
"providers": {
"onezhe": {
"baseUrl": "https://1zheai.com",
"apiKey": "${ONEZHE_API_KEY}",
"api": "anthropic-messages",
"models": [
{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
]
}
}
}
}
```
Assurez-vous que le processus exécutant réellement la Gateway peut lire `ONEZHE_API_KEY` ; les variables d'environnement dans le terminal ne sont pas nécessairement transmises à un service d'arrière-plan existant. La [documentation officielle Synthetic](https://docs.openclaw.ai/providers/synthetic) indique explicitement que le client Anthropic ajoute automatiquement `/v1`, donc ici nous n'incluons pas `/v1` et ne remplissons pas le `/v1/messages` complet.
Lors du passage à Chat Completions, remplacez par paires par `baseUrl: "https://1zheai.com/v1"` et `api: "openai-completions"`. Bien que le nom contienne completions, cet adaptateur correspond à `/v1/chat/completions` ; ne sélectionnez pas par erreur `openai-responses`. La liste blanche des modèles existante doit conserver les autres entrées et ajouter le nouveau modèle. L'exemple n'invente pas de coûts ou de paramètres de contexte ; si la version actuellement installée nécessite des métadonnées supplémentaires pour la validation, vérifiez d'abord les capacités réelles du modèle avant de les ajouter.
## Vérification de l’intégration et dépannage
1. Enregistrez et rechargez la configuration, confirmez que le fournisseur sélectionné est `onezhe` ou le modèle personnalisé que vous avez ajouté.
2. Envoyez une question courte, confirmez qu'elle peut être retournée ; puis essayez une petite tâche annulable, confirmez séparément l'appel d'outil et la conversation multi-tours.
3. Ouvrez les [journaux d'appels](/fr/docs/usage-logs/), vérifiez l'heure de la requête, le modèle, le statut et l'utilisation. Une réponse textuelle réussie ne signifie pas que toutes les capacités des Agents sont compatibles.
4. En cas de 404, vérifiez que l'adresse et le protocole de cet article sont assortis ; en cas de 401, vérifiez l'origine de la clé et si le processus a lu les variables d'environnement ; en cas de 429, consultez les informations de limitation de débit avant de réessayer. Pour plus de cas, voir les [codes d'erreur et le dépannage](/fr/docs/troubleshooting/).
Les clés ne sont stockées que dans l'environnement local ou le stockage d'identifiants de l'outil ; ne les soumettez pas à un dépôt de code, à des captures d'écran ou à des journaux publics. Les services d'arrière-plan peuvent ne pas hériter des variables d'environnement du terminal ; les modèles auxiliaires, la recherche et d'autres outils peuvent également avoir des paramètres de fournisseur indépendants qui doivent être vérifiés séparément.
## Coûts et autres méthodes d’intégration
Consultez les [prix en temps réel de l'API Claude](https://1zheai.com/en/pricing/) et les [règles de facturation](/fr/docs/pricing-explained/). Pour d'autres clients, retournez au [catalogue d'intégration des outils](/fr/docs/integrations/) ; pour écrire votre propre programme, utilisez le [SDK et le guide de développement](/fr/docs/guides/).
---
# Intégration de l'agent Hermes avec l'API Claude
Source: https://1zheai.com/fr/docs/quickstart-hermes/
Markdown: https://1zheai.com/fr/docs/quickstart-hermes.md
---
title: "Intégration de l'agent Hermes avec l'API Claude"
description: "Tutoriel sur la configuration de l'adresse de relais, de la clé et du modèle de l'API Claude de 1折AI dans Hermes Agent, incluant la sélection du protocole, des exemples de configuration, des étapes de vérification et des erreurs courantes."
headingIds: {"Vérifier la connexion et résoudre les problèmes":"section-1","Coûts et autres méthodes d’accès":"section-2"}
---
Utilisez la fonctionnalité de fournisseur personnalisé de Hermes Agent pour vous connecter à 1折AI. D'abord [créez une clé API ](/fr/docs/api-keys/), et confirmez les [modèles actuellement disponibles ](/fr/docs/models/) ; les identifiants de modèles ci-dessous sont des exemples — ajustez-les en fonction des permissions de votre clé.
Date de vérification officielle de la configuration : 2026-10-15. La configuration suivante est compilée à partir de la documentation officielle ; la vérification de bout en bout sur ce site n'a pas encore été terminée ; veuillez d'abord effectuer une courte vérification de questions-réponses et d'appels d'outils avant de l'utiliser pour de longues tâches. Les modèles OpenAI / GPT sont désormais en ligne ; consultez la [description des modèles ](/fr/docs/models/) pour la liste des modèles et les tarifs.
Basé sur les [fournisseurs officiels ](https://hermes-agent.nousresearch.com/docs/integrations/providers) : exécutez `hermes model` dans le terminal → point de terminaison personnalisé, sélectionnez explicitement `chat_completions` pour le mode API, renseignez `https://1zheai.com/v1` pour l'URL de base, puis saisissez la clé et le modèle. Ne sélectionnez pas la connexion ChatGPT/Codex — c'est une méthode d'accès différente.
Configuration de fournisseur nommé réutilisable, à fusionner dans `~/.hermes/config.yaml` :
```yaml
providers:
onezhe:
api: https://1zheai.com/v1
key_env: ONEZHE_API_KEY
transport: chat_completions
default_model: claude-sonnet-4-6
model:
provider: custom:onezhe
default: claude-sonnet-4-6
```
Servi localement sur `~/.hermes/.env` :
```dotenv
ONEZHE_API_KEY=sk-替换为本站密钥
```
Une fois configuré, vous pouvez basculer `/model custom:onezhe:claude-sonnet-4-6` dans la conversation. `/model` ne peut pas remplacer le `hermes model` du terminal pour créer un nouveau fournisseur. Le transport `anthropic_messages` est officiellement pris en charge, mais ce tutoriel utilise Chat Completions pour éviter de deviner automatiquement le protocole à partir de l'URL. `OPENAI_BASE_URL` n'est pas une configuration universelle pour tous les fournisseurs personnalisés ; utilisez la configuration explicite ci-dessus.
## Vérifier la connexion et résoudre les problèmes
1. Enregistrez et rechargez la configuration, puis confirmez que le fournisseur actuellement sélectionné est `onezhe` ou le modèle personnalisé que vous avez ajouté.
2. Envoyez une question courte et confirmez qu'elle renvoie une réponse ; puis essayez une petite tâche réversible pour vérifier séparément les appels d'outils et la conversation multi-tours.
3. Ouvrez le [journal des appels ](/fr/docs/usage-logs/) et vérifiez l'heure de la requête, le modèle, le statut et l'utilisation. Une réponse textuelle réussie unique ne signifie pas que toutes les capacités de l'Agent sont compatibles.
4. Si vous rencontrez une erreur 404, vérifiez si l'adresse et le protocole de cet article correspondent ; si vous rencontrez une erreur 401, vérifiez la source de la clé et si le processus a lu les variables d'environnement ; si vous rencontrez une erreur 429, examinez les informations de limitation de débit avant de réessayer. Pour plus de cas, consultez les [codes d'erreur et le dépannage ](/fr/docs/troubleshooting/).
Les clés ne doivent être stockées que dans l'environnement local ou le magasin d'identifiants de l'outil — ne les commettez pas dans des dépôts de code, des captures d'écran ou des journaux publics. Les services d'arrière-plan peuvent ne pas hériter des variables d'environnement du terminal ; les modèles auxiliaires, la recherche et d'autres outils peuvent également avoir des paramètres de fournisseur indépendants qui doivent être vérifiés séparément.
## Coûts et autres méthodes d’accès
Consultez les [tarifs en temps réel de l'API Claude ](https://1zheai.com/en/pricing/) et les [règles de facturation ](/fr/docs/pricing-explained/). Pour d'autres clients, revenez au [répertoire d'accès aux outils ](/fr/docs/integrations/) ; pour écrire votre propre programme, utilisez le [SDK et le guide développeur ](/fr/docs/guides/).
---
# Intégration via CC Switch
Source: https://1zheai.com/fr/docs/quickstart-cc-switch/
Markdown: https://1zheai.com/fr/docs/quickstart-cc-switch.md
---
title: "Intégration via CC Switch"
description: "Ajoutez 1折AI avec une configuration personnalisée dans CC Switch pour basculer de fournisseur en un clic dans Claude Code, sans modifier settings.json à la main."
headingIds: {"Installation":"section-1","Ajouter 1折AI à Claude Code":"section-2","Obtenir la liste des modèles":"section-3","Codex":"section-4","Foire aux questions":"section-5"}
---
CC Switch](https://github.com/farion1231/cc-switch) est un outil de bureau qui vous aide à gérer les configurations de fournisseurs des outils en ligne de commande comme Claude Code et Codex. Après l'avoir ajouté une fois, basculer entre le compte officiel, 1折AI et d'autres fournisseurs ne demande qu'un clic.
## Installation
- macOS : `brew install --cask cc-switch`
- Windows / Linux : téléchargez l'installateur depuis [GitHub Releases](https://github.com/farion1231/cc-switch/releases)
## Ajouter 1折AI à Claude Code
Sélectionnez **Claude Code** dans la barre latérale, puis cliquez sur **Ajouter un fournisseur** (symbole +) à droite de l'en-tête de la page.
1折AI n'est actuellement pas dans la liste prédéfinie de CC Switch ; sélectionnez **Configuration personnalisée** tout en haut de la liste.
Saisissez `1折AI` comme nom, et écrivez `env` dans la zone d'édition de la configuration :
```json
{
"env": {
"ANTHROPIC_BASE_URL": "https://1zheai.com",
"ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
}
}
```
Pour fixer également le modèle, ajoutez des variables telles que `ANTHROPIC_MODEL` ; la syntaxe est décrite dans la section de correspondance des modèles de [l'intégration Claude Code](/fr/docs/quickstart-claude-code/).
Cliquez sur **Ajouter** dans le pied de page, puis activez 1折AI dans la liste des fournisseurs. CC Switch écrira la configuration dans le `~/.claude/settings.json` de Claude Code, et Claude Code utilisera le nouveau fournisseur sans redémarrage.
Exécutez `/status` dans Claude Code ; l'URL de base doit être `https://1zheai.com`. Envoyez ensuite un message et vérifiez dans les [journaux d'appel](/fr/docs/usage-logs/) de la console qu'un enregistrement existe.
L'exemple officiel de CC Switch utilise `ANTHROPIC_API_KEY` ; les deux variables fonctionnent. Nous recommandons `ANTHROPIC_AUTH_TOKEN` ; la raison est expliquée dans [l'intégration Claude Code](/fr/docs/quickstart-claude-code/).
## Obtenir la liste des modèles
Lors de la modification d'un fournisseur, le bouton **Obtenir la liste des modèles** à côté du champ de saisie du modèle utilisera votre clé API (API key) pour appeler `/v1/models`, lister les modèles disponibles et en sélectionner un à saisir.
## Codex
CC Switch peut aussi gérer les fournisseurs de Codex. Pour configurer l'URL de base de ce site, la clé API et le modèle GPT, voir [l'intégration Codex CLI](/fr/docs/quickstart-codex/).
## Foire aux questions
Vérifiez d'abord dans CC Switch que 1折AI est activé ; puis vérifiez si `ANTHROPIC_BASE_URL` ou `ANTHROPIC_AUTH_TOKEN` a été exporté dans le terminal. Claude Code se base sur settings.json, mais les anciennes variables exportées manuellement peuvent facilement induire en erreur ; il est conseillé de toutes les effacer et de les confier à CC Switch.
La clé API est mal saisie ou a été supprimée. Recopiez la clé API en veillant à ne pas inclure d'espaces.
---
# Configuration du fournisseur CC
Source: https://1zheai.com/fr/docs/quickstart-cc-provider/
Markdown: https://1zheai.com/fr/docs/quickstart-cc-provider.md
---
title: "Configuration du fournisseur CC"
description: "Gérer des fournisseurs Anthropic personnalisés avec l'extension CC Provider pour VS Code."
headingIds: {"Étapes de configuration":"section-1","Portée et dépannage":"section-2"}
---
Ici, il s'agit de l'extension VS Code **onetooken/cc-provider**, pas de CC Switch. Elle prend en charge les points de terminaison compatibles Anthropic personnalisés.
## Étapes de configuration
1. Installez l'extension depuis le lien du dépôt officiel et ouvrez son panneau de fournisseurs.
2. Créez un nouveau fournisseur personnalisé ; dans la console **Clé API → Outils → CC Provider**, vous pouvez copier les champs correspondants.
3. Remplissez le nom avec `1折AI`, l'URL de base avec `https://1zheai.com`, et le jeton API avec votre propre clé.
4. Renseignez le modèle principal et les emplacements de modèles nécessaires en fonction des modèles actuellement disponibles ; ne copiez pas les identifiants de modèles d'autres fournisseurs ni les suffixes de capacité `[1m]`.
5. Sauvegardez votre configuration Claude Code existante avant d'appliquer et vérifiez les champs qui seront modifiés. Redémarrez les sessions nécessitant la lecture de la configuration, puis testez avec une requête courte.
## Portée et dépannage
Ce site fournit la copie des champs ; le protocole d'importation en un clic des fournisseurs de cette extension n'a pas encore été vérifié. Le comportement de ce client lors de l'écriture dans la configuration Claude Code diffère de l'intégration des fournisseurs intégrés.
Pour 401, vérifiez le jeton ; pour 404, vérifiez que l'adresse racine Anthropic n'a pas été remplie par erreur avec `/v1/messages` ; si le modèle n'existe pas, utilisez un modèle disponible avec la clé actuelle. Confirmez que la requête apparaît dans le journal d'appels de ce site avant d'utiliser des tâches longues.
Officiel : [CC Provider](https://github.com/onetooken/cc-provider).
protocole et documentation officielle vérifiés le 2026-10-19. Ce site a implémenté la génération de configuration et les tests de non-régression front-end ; la validation d'inférence réelle sur tous les clients, systèmes et modèles n'a pas été effectuée. Revérifiez après la mise à niveau du client. L'intégration personnalisée ne constitue ni un partenariat officiel ni une recommandation intégrée.
Plus : [Clé API](/fr/docs/api-keys/), [Liste des modèles](/fr/docs/models/), [Journal d'appels](/fr/docs/usage-logs/), [Explication des adresses](/fr/docs/base-url/).
---
# Guide de développement
Source: https://1zheai.com/fr/docs/guides/
Markdown: https://1zheai.com/fr/docs/guides.md
---
title: "Guide de développement"
description: "Choisissez l'accès via SDK ou HTTP, de la première requête à la sortie en streaming et au cache."
headingIds: {"Continuer à améliorer après l’intégration":"section-1","Des exemples à l’application":"section-2"}
---
Si vous avez déjà du code, commencez par le SDK correspondant ; si vous n'avez pas encore choisi de pile technologique, vérifiez d'abord l'appel avec curl, puis intégrez-le à votre application.
utilise le protocole natif de Claude, consultez les exemples Python et TypeScript. utilise l'OpenAI SDK pour appeler GPT ou Claude, configurez l'ID du modèle et l'adresse de l'interface. consultez directement les requêtes HTTP pour éliminer les différences de configuration du SDK. confirmez le point de terminaison, le protocole et le périmètre d'application.
## Continuer à améliorer après l’intégration
- [Sortie en streaming](/fr/docs/streaming/) : traitez les réponses incrémentales et les interruptions de flux.
- [Prompt Caching](/fr/docs/prompt-caching/) : comprenez les conditions d'utilisation et la manière de vérifier les résultats.
- [Codes d'erreur et dépannage](/fr/docs/troubleshooting/) : localisez les problèmes de configuration ou d'amont en fonction de l'erreur précise.
- [Journaux d'utilisation et rapprochement](/fr/docs/usage-logs/) : vérifiez les enregistrements de requêtes.
Lorsque vous utilisez un logiciel existant, vous pouvez passer directement à l'[intégration d'outils](/fr/docs/integrations/).
## Des exemples à l’application
Python / Node.js, de la définition des variables d'environnement à l'exécution du programme. distinguez les erreurs de configuration, les pannes temporaires et les résultats incertains. vérifiez item par item l'adresse, la clé, le modèle et le protocole. utilisez l'interface Images et enregistrez les résultats générés.
---
# Intégration du SDK Anthropic (Python / TypeScript)
Source: https://1zheai.com/fr/docs/quickstart-anthropic-sdk/
Markdown: https://1zheai.com/fr/docs/quickstart-anthropic-sdk.md
---
title: "Intégration du SDK Anthropic (Python / TypeScript)"
description: "Appeler 1折AI avec le SDK officiel Anthropic : base_url sur https://1zheai.com, prise en charge native du cache, du streaming, des appels d'outils et du thinking."
headingIds: {"Installation":"section-1","Appel":"section-2","Sortie en streaming":"section-3","Appel avec cache":"section-4","Utiliser les variables d’environnement":"section-5","Questions fréquentes":"section-6","Structure des requêtes et des réponses":"section-7"}
---
Le SDK officiel Anthropic utilise le protocole natif `/v1/messages` ; tous les paramètres de Claude peuvent être utilisés directement. Les seuls éléments à modifier sont `base_url` et `api_key`.
## Installation
```bash title="Python"
pip install anthropic
```
```bash title="TypeScript / Node.js"
npm install @anthropic-ai/sdk
```
## Appel
```python title="Python"
import os
import anthropic
client = anthropic.Anthropic(
base_url="https://1zheai.com",
api_key=os.environ["ONEZHE_API_KEY"],
)
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(message.model)
print(message.content[0].text)
print(message.usage)
```
```typescript title="TypeScript"
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
baseURL: "https://1zheai.com",
apiKey: process.env.ONEZHE_API_KEY,
});
const message = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "用一句话介绍你自己" }],
});
console.log(message.model);
console.log(message.content);
console.log(message.usage);
```
Renseignez l'adresse de base dans `base_url`, sans ajouter `/v1`.
## Sortie en streaming
```python title="Python"
with client.messages.stream(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "写一首四行的诗"}],
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
```
```typescript title="TypeScript"
const stream = client.messages.stream({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "写一首四行的诗" }],
});
stream.on("text", (text) => process.stdout.write(text));
await stream.finalMessage();
```
## Appel avec cache
Placez le contenu long et fixe dans `system` et ajoutez `cache_control` :
```python title="Python"
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
system=[
{
"type": "text",
"text": LONG_PROJECT_CONTEXT, # 每次都一样的长文本
"cache_control": {"type": "ephemeral"},
}
],
messages=[{"role": "user", "content": "根据上面的说明回答：..."}],
)
print(message.usage.cache_creation_input_tokens, message.usage.cache_read_input_tokens)
```
Lors du deuxième appel, si `cache_read_input_tokens` est supérieur à 0, c'est un cache hit. Pour les détails, voir [Prompt Caching](/fr/docs/prompt-caching/).
## Utiliser les variables d’environnement
Le SDK officiel lit `ANTHROPIC_BASE_URL` et `ANTHROPIC_API_KEY` ; vous pouvez omettre les paramètres lors de la construction du client :
```bash
export ANTHROPIC_BASE_URL="https://1zheai.com"
export ANTHROPIC_API_KEY="sk-你的Key"
```
Puis construire le client sans passer de paramètres :
```python
client = anthropic.Anthropic() # 自动读取上面两个变量
```
Si Claude Code lit également ces deux variables sur cette machine, elles basculeront toutes deux vers 1折AI, ce qui est généralement ce que vous souhaitez.
## Questions fréquentes
Vous avez ajouté `/v1` dans `base_url`. Le SDK Anthropic assemble lui-même `/v1/messages`.
Vérifiez la clé API (API key) ; de plus, si l'environnement contient également `ANTHROPIC_AUTH_TOKEN` (par exemple une ancienne valeur définie pour Claude Code), le SDK la lira aussi — supprimez l'ancienne valeur et réessayez.
## Structure des requêtes et des réponses
Pour consulter system, les blocs de contenu et la raison d'arrêt, voir [Détail de l'interface Messages](/fr/docs/api-messages/). Un programme complet doit lire le texte en fonction du type de bloc de contenu, sans supposer que le premier bloc est toujours text.
---
# Intégration du SDK OpenAI (Python / Node)
Source: https://1zheai.com/fr/docs/quickstart-openai-sdk/
Markdown: https://1zheai.com/fr/docs/quickstart-openai-sdk.md
---
title: "Intégration du SDK OpenAI (Python / Node)"
description: "Appeler les modèles GPT et Claude de 1折AI avec le SDK officiel OpenAI : modifiez uniquement base_url et api_key, avec exemples de streaming et utilisation des variables d'environnement."
headingIds: {"Installation":"section-1","Appel":"section-2","Sortie en streaming":"section-3","Utiliser les variables d’environnement sans modifier le code":"section-4","Quand passer au SDK Anthropic":"section-5","Questions fréquentes":"section-6","Responses et programme complet":"section-7"}
---
Si vous avez déjà du code écrit avec le SDK OpenAI, passer à 1折AI ne demande que la modification de deux paramètres : `base_url` et `api_key`. Renseignez l'ID du modèle GPT ou Claude actuellement disponible.
## Installation
```bash title="Python"
pip install openai
```
```bash title="Node.js"
npm install openai
```
## Appel
```python title="Python"
import os
from openai import OpenAI
client = OpenAI(
base_url="https://1zheai.com/v1",
api_key=os.environ["ONEZHE_API_KEY"],
)
resp = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "用一句话解释什么是 prompt caching"}],
)
print(resp.model)
print(resp.choices[0].message.content)
print(resp.usage)
```
```javascript title="Node.js"
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://1zheai.com/v1",
apiKey: process.env.ONEZHE_API_KEY,
});
const resp = await client.chat.completions.create({
model: "gpt-5.6-sol",
messages: [{ role: "user", content: "用一句话解释什么是 prompt caching" }],
});
console.log(resp.model);
console.log(resp.choices[0].message.content);
console.log(resp.usage);
```
`base_url` doit inclure `/v1`.
## Sortie en streaming
```python title="Python"
stream = client.chat.completions.create(
model="gpt-5.6-sol",
messages=[{"role": "user", "content": "写一首四行的诗"}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
```
```javascript title="Node.js"
const stream = await client.chat.completions.create({
model: "gpt-5.6-sol",
messages: [{ role: "user", content: "写一首四行的诗" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}
```
## Utiliser les variables d’environnement sans modifier le code
Le SDK officiel OpenAI (Python et Node) lit `OPENAI_BASE_URL` et `OPENAI_API_KEY`. Lorsque le code ne transmet aucun paramètre, il suffit de définir ces deux variables pour basculer :
```bash
export OPENAI_BASE_URL="https://1zheai.com/v1"
export OPENAI_API_KEY="sk-你的Key"
```
Attention : cela affecte tous les programmes utilisant le SDK OpenAI dans le même environnement.
## Quand passer au SDK Anthropic
L'interface compatible OpenAI convient au cas « code existant, changement de modèle uniquement ». Si vous avez besoin des `cache_control` de Prompt Caching, de l'extended thinking ou du format d'appel d'outils de Claude, utilisez le [SDK Anthropic](/fr/docs/quickstart-anthropic-sdk/) avec l'interface native.
## Questions fréquentes
Il manque `/v1` à `base_url`. Le SDK OpenAI ne fait qu'ajouter `/chat/completions` à la fin.
Oui. Les modèles OpenAI / GPT sont en ligne, veuillez utiliser l'ID d'un modèle que votre clé peut appeler dans [les modèles pris en charge](/fr/docs/models/).
## Responses et programme complet
Lorsque le protocole Responses est requis, consultez [l'interface Responses](/fr/docs/api-responses/). Pour une première utilisation en Python ou Node.js, exécutez directement [l'exemple complet](/fr/docs/code-examples/) ; avant la mise en production, configurez [le timeout et les retries limités](/fr/docs/retries/).
---
# Appels avec curl
Source: https://1zheai.com/fr/docs/quickstart-curl/
Markdown: https://1zheai.com/fr/docs/quickstart-curl.md
---
title: "Appels avec curl"
description: "Sans installer aucun SDK, utilisez curl pour interroger 1折AI sur /v1/messages et /v1/chat/completions, consulter la liste des modèles, tester le cache et observer la sortie en flux."
headingIds: {"Natif Anthropic : /v1/messages":"section-1","Compatible OpenAI : /v1/chat/completions":"section-2","Liste des modèles : /v1/models":"section-3","Sortie en flux":"section-4","Tester le cache":"section-5","Ajouter -i lors du dépannage":"section-6"}
---
curl est la méthode la plus rapide pour vérifier si "la clé API (API key) et l'adresse fonctionnent réellement". Chaque commande ci-dessous peut être copiée directement ; commencez par placer la clé API dans une variable d'environnement :
```bash
export ONEZHE_API_KEY="sk-你的Key"
```
Les utilisateurs Windows sont invités à exécuter ces commandes dans WSL ou Git Bash ; la syntaxe PowerShell est visible dans [Démarrage rapide](/fr/docs/quickstart/).
## Natif Anthropic : /v1/messages
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "ping"}]
}'
```
## Compatible OpenAI : /v1/chat/completions
```bash
curl https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"messages": [{"role": "user", "content": "ping"}]
}'
```
## Liste des modèles : /v1/models
```bash
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer $ONEZHE_API_KEY"
```
## Sortie en flux
Ajoutez `"stream": true` et utilisez `-N` pour désactiver la mise en tampon de curl afin de voir les réponses segment par segment :
```bash
curl -N https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"stream": true,
"messages": [{"role": "user", "content": "从一数到五"}]
}'
```
Le format des événements est décrit dans [Sortie en flux](/fr/docs/streaming/).
## Tester le cache
Envoyez deux fois la même requête ; si la valeur de `usage.cache_read_input_tokens` dans la seconde réponse est supérieure à 0, cela indique un cache réussi. Le texte dans `system` doit atteindre la longueur minimale mise en cache du modèle ; le script complet est disponible dans [Vérifier les modèles et l'utilisation](/fr/docs/verify-model/), et le principe est expliqué dans [Prompt Caching](/fr/docs/prompt-caching/).
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 32,
"system": [{
"type": "text",
"text": "把一段至少 512 token、每次都一样的长文本放在这里",
"cache_control": {"type": "ephemeral"}
}],
"messages": [{"role": "user", "content": "ping"}]
}'
```
## Ajouter -i lors du dépannage
```bash
curl -i https://1zheai.com/v1/models -H "Authorization: Bearer $ONEZHE_API_KEY"
```
`-i` affiche le code de statut et les en-têtes de réponse. La signification des codes de statut est détaillée dans [Codes d'erreur et dépannage](/fr/docs/troubleshooting/).
---
# Exemples de code exécutables
Source: https://1zheai.com/fr/docs/code-examples/
Markdown: https://1zheai.com/fr/docs/code-examples.md
---
title: "Exemples de code exécutables"
description: "Programmes complets de Chat Completions en Python et Node.js, incluant la préparation de l'environnement, le choix du modèle, la gestion des erreurs et les commandes d'exécution."
headingIds: {"1. Préparer les variables d’environnement":"section-1","2. Choisir le langage et exécuter":"section-2","Python":"section-3","Node.js":"section-4","3. Vérifier les résultats":"section-5","Pour aller plus loin":"section-6"}
---
Les deux programmes suivants font la même chose : lire les variables d'environnement, émettre une requête texte non en flux, et afficher la réponse ou une erreur localisable. Les exemples désactivent la nouvelle tentative automatique pour faciliter la vérification du résultat d'une seule requête.
## 1. Préparer les variables d’environnement
À définir dans le même terminal que celui où le programme s'exécute ; `ONEZHE_MODEL` peut être remplacé par l'ID dans [modèles disponibles](/fr/docs/api-models/).
```bash title="macOS / Linux"
export ONEZHE_API_KEY="sk-你的Key"
export ONEZHE_MODEL="gpt-5.6-sol"
```
```powershell title="Windows PowerShell"
$env:ONEZHE_API_KEY = "sk-你的Key"
$env:ONEZHE_MODEL = "gpt-5.6-sol"
```
## 2. Choisir le langage et exécuter
### Python
Installer `python -m pip install openai`, enregistrer sous `chat.py`, exécuter `python chat.py`.
```python
import os
import sys
import openai
api_key = os.environ.get("ONEZHE_API_KEY")
if not api_key:
sys.exit("请先设置 ONEZHE_API_KEY 环境变量。")
client = openai.OpenAI(
api_key=api_key,
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=0,
)
try:
response = client.chat.completions.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-5.6-sol"),
messages=[{"role": "user", "content": "用一句中文解释 DNS。"}],
)
if not response.choices:
sys.exit("响应没有 choices，请检查响应协议。")
choice = response.choices[0]
print(choice.message.content or "本次响应没有普通文本。")
print("finish_reason:", choice.finish_reason)
print("response_id:", response.id)
except openai.APIStatusError as exc:
print("HTTP:", exc.status_code, "request_id:", exc.request_id, file=sys.stderr)
print("请查看控制台日志和错误码文档；不要公开密钥。", file=sys.stderr)
sys.exit(1)
except openai.APIConnectionError:
sys.exit("连接失败或超时：检查网络与代理，再核对调用日志。")
```
### Node.js
Installer `npm install openai`, enregistrer sous `chat.mjs`, exécuter `node chat.mjs`. L'extension `.mjs` active directement les ES Module.
```javascript
import OpenAI from "openai";
if (!process.env.ONEZHE_API_KEY) {
console.error("请先设置 ONEZHE_API_KEY 环境变量。");
process.exit(1);
}
const client = new OpenAI({
apiKey: process.env.ONEZHE_API_KEY,
baseURL: "https://1zheai.com/v1",
timeout: 120_000,
maxRetries: 0,
});
try {
const response = await client.chat.completions.create({
model: process.env.ONEZHE_MODEL || "gpt-5.6-sol",
messages: [{ role: "user", content: "用一句中文解释 DNS。" }],
});
const choice = response.choices[0];
if (!choice) throw new Error("响应没有 choices，请检查响应协议。");
console.log(choice.message.content || "本次响应没有普通文本。");
console.log("finish_reason:", choice.finish_reason);
console.log("response_id:", response.id);
} catch (error) {
if (error instanceof OpenAI.APIError) {
console.error("HTTP:", error.status, "request_id:", error.request_id);
console.error("请检查网络、控制台日志和错误码文档。");
} else {
console.error(error instanceof Error ? error.message : "未知错误");
}
process.exitCode = 1;
}
```
## 3. Vérifier les résultats
Vous devriez voir une réponse et la raison d'arrêt. Lorsque `finish_reason` n'est pas `stop`, vérifiez s'il s'agit d'un appel d'outil ou d'une troncature. L'ID de requête du SDK peut être vide ; le serveur peut également placer l'ID de traçage dans le corps de l'erreur, à compléter depuis la réponse brute désensibilisée lors du débogage.
Consultez [les journaux d'appel](/fr/docs/usage-logs/) pour vérifier les appels. Le code de sortie du programme et la présence ou non de texte normal ne couvrent pas toutes les conditions de succès métier ; vérifiez la structure et le contenu selon votre tâche.
## Pour aller plus loin
- [Chat Completions](/fr/docs/api-chat-completions/) : historique multi-tours et description des champs.
- [Messages](/fr/docs/api-messages/) : blocs de contenu natifs de Claude.
- [Responses](/fr/docs/api-responses/) : GPT Responses et événements en flux.
- [Génération d'images](/fr/docs/api-images/) : générer et enregistrer des fichiers image.
- [Délais d'attente et nouvelles tentatives](/fr/docs/retries/) : configurer la gestion des échecs avant la mise en production.
---
# Sortie en flux
Source: https://1zheai.com/fr/docs/streaming/
Markdown: https://1zheai.com/fr/docs/streaming.md
---
title: "Sortie en flux"
description: "Utiliser la sortie en flux sur 1折AI : séquence d'événements SSE native d'Anthropic, format de chunks compatible OpenAI, et comment gérer les interruptions de flux."
headingIds: {"Natif Anthropic":"section-1","Compatible OpenAI":"section-2","Que faire lorsque le flux se rompt":"section-3","Facturation des déconnexions en cours de flux":"section-4"}
---
Pour les réponses longues, utilisez la sortie en flux (`"stream": true`) afin que le premier caractère apparaisse plus vite et que la requête soit moins susceptible d'être coupée par les réseaux intermédiaires en raison d'une requête unique prenant trop de temps. Les deux protocoles sont pris en charge, avec des formats correspondant respectivement aux formats officiels.
## Natif Anthropic
Ajoutez `"stream": true` à la requête ; la réponse est en Server-Sent Events. Un flux normal suit cet ordre (d'après [la documentation Streaming d'Anthropic ](https://platform.claude.com/docs/en/build-with-claude/streaming)) :
| Événement | Signification |
|---|---|
| `message_start` | Le message commence, avec le modèle et le `usage` initial |
| `content_block_start` | Un bloc de contenu commence (texte, réflexion, tool_use) |
| `content_block_delta` | Delta de contenu, le texte est dans `delta.text` |
| `content_block_stop` | Ce bloc de contenu se termine |
| `message_delta` | Mise à jour au niveau du message, avec `stop_reason` et le nombre final de tokens de sortie |
| `message_stop` | L'ensemble du message se termine |
Les événements `ping` peuvent être intercalés entre les autres et peuvent être ignorés ; en cas d'erreur, vous recevrez un événement `error`.
```bash
curl -N https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":128,"stream":true,
"messages":[{"role":"user","content":"从一数到五"}]}'
```
Lorsque vous utilisez un SDK, vous n'avez pas besoin d'analyser les événements vous-même ; voir l'exemple de flux dans [le SDK Anthropic ](/fr/docs/quickstart-anthropic-sdk/).
## Compatible OpenAI
Ajoutez `"stream": true` à `/v1/chat/completions` ; la réponse est des chunks sous la forme de `data: {...}`, le texte est dans `choices[0].delta.content`, et cela se termine par `data: [DONE]`. Voir [le SDK OpenAI ](/fr/docs/quickstart-openai-sdk/) pour un exemple de SDK.
Le dernier chunk avant `usage` contient `[DONE]`, et `choices` est un tableau vide. Il est également renvoyé si `stream_options.include_usage` n'est pas transmis. Flux complet testé le 2026-10-15 :
```text
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"role":"assistant"},"finish_reason":null}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"content":"ok"},"finish_reason":null}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[{"index":0,"delta":{"content":""},"finish_reason":"stop"}]}
data: {"id":"msg_011Cg3ERqM8nN58LxLt7TVuG","object":"chat.completion.chunk","created":1792031230,"model":"claude-sonnet-4-6","choices":[],"usage":{"prompt_tokens":370,"completion_tokens":4,"total_tokens":374}}
data: [DONE]
```
Lors du traitement des chunks, vérifiez d'abord si `choices` est vide ; l'exemple sur la page du SDK OpenAI ci-dessus fait déjà cela.
## Que faire lorsque le flux se rompt
- Vérifiez d'abord s'il s'agit d'un proxy : désactivez le proxy et connectez-vous directement, puis réessayez.
- Le délai d'attente de lecture du client doit être plus long que le temps de génération du modèle ; augmentez le paramètre de délai d'attente pour les sorties longues.
- Lors de la réception de `overloaded_error` dans un événement `error`, attendez quelques secondes et réessayez ; voir [Codes d'erreur et dépannage ](/fr/docs/troubleshooting/).
## Facturation des déconnexions en cours de flux
Une requête déconnectée en cours de flux n'est pas entièrement gratuite ; elle est facturée en fonction des tokens de sortie générés avant la déconnexion, enregistrés dans le journal d'appel. Les tokens de sortie facturés peuvent être légèrement supérieurs à ce que le client a réellement reçu. Testé le 2026-10-15 : en demandant au modèle de compter de 1 à 600, lorsque le client s'est déconnecté à la 4e seconde, il avait reçu 188 lignes (environ 380 tokens de sortie), tandis que le journal d'appel enregistrait 750 tokens de sortie. Pour une longue sortie dont vous n'avez pas besoin, plutôt que de vous déconnecter en cours de flux, il vaut mieux définir `max_tokens` petit dès le départ.
---
# Utilisation et facturation du Prompt Caching
Source: https://1zheai.com/fr/docs/prompt-caching/
Markdown: https://1zheai.com/fr/docs/prompt-caching.md
---
title: "Utilisation et facturation du Prompt Caching"
description: "Utiliser le Prompt Caching de Claude sur 1折AI : comment l'activer, la longueur minimale, comment confirmer un hit, comment il est facturé après un hit, et le comportement du cache dans Claude Code."
headingIds: {"En résumé":"section-1","Comment l’activer":"section-2","Longueur minimale pour la mise en cache":"section-3","Confirmer un hit":"section-4","Comment c’est facturé":"section-5","Cache d’une heure":"section-6","Le cache dans Claude Code":"section-7","L’interface compatible OpenAI peut-elle utiliser le cache ?":"section-8","Questions fréquentes":"section-9"}
---
Le Prompt Caching permet aux longs préfixes envoyés à plusieurs reprises (invite système, définitions d'outils, longs documents, historique de conversation) d'être facturés en écriture uniquement lors de la première fois, puis en lecture par la suite. Sur ce site, la lecture et l'écriture du cache sont facturées au tarif officiel, sans appliquer la remise sur les entrées/sorties. Les tarifs unitaires du cache par modèle sont disponibles dans [Modèles et tarifs](https://1zheai.com/en/pricing/).
## En résumé
- **Le cache est activé par défaut dans Claude Code** : il prend effet dès la connexion.
- Lorsque vous appelez l'API depuis votre propre code, ajoutez `cache_control` sur le bloc de contenu à mettre en cache, en utilisant l'API native `/v1/messages`. L'interface compatible OpenAI ne met pas en cache pour l'instant.
- Pour déterminer s'il y a eu un hit, vérifiez uniquement si `usage.cache_read_input_tokens` dans la réponse est supérieur à 0.
- Le cache dure 5 minutes par défaut et chaque hit réinitialise le minuteur. Vous pouvez également utiliser `"ttl": "1h"` pour écrire un cache d'une heure, dont le tarif d'écriture est plus élevé.
## Comment l’activer
Ajoutez `"cache_control": {"type": "ephemeral"}` sur un bloc de contenu dans system, tools ou messages ; ce bloc et tout ce qui le précède seront mis en cache. Une requête peut contenir au plus 4 points de rupture de cache.
```bash
curl https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"system": [
{
"type": "text",
"text": "这里放一段很长、每次都一样的内容：项目说明、代码规范、参考文档……",
"cache_control": {"type": "ephemeral"}
}
],
"messages": [{"role": "user", "content": "根据上面的规范，审查这段代码：..."}]
}'
```
Si le préfixe à mettre en cache est trop court, la requête est traitée normalement, simplement sans mise en cache et sans erreur. La longueur minimale varie selon le modèle, voir le tableau ci-dessous.
## Longueur minimale pour la mise en cache
Les valeurs suivantes proviennent de [la documentation officielle d'Anthropic](https://platform.claude.com/docs/en/build-with-claude/prompt-caching) (2026-10-14) :
| Nombre minimal de tokens | Modèle |
|---|---|
| 512 | Fable 5.1, Fable 5, Opus 5.5, Opus 5, Sonnet 5.5, Haiku 5.5 |
| 1,024 | Opus 4.8, Sonnet 5, Sonnet 4.6, Sonnet 4.5 |
| 2,048 | Opus 4.7 |
| 4,096 | Opus 4.6, Opus 4.5, Haiku 4.5 |
## Confirmer un hit
Envoyez deux fois la même requête (avec un intervalle ne dépassant pas 5 minutes) et comparez les `usage` des deux réponses. Voici les résultats mesurés le 2026-10-15 avec `claude-sonnet-5-5`, en plaçant environ 18 000 tokens de texte fixe dans system :
```json title="第一次：写入缓存"
{
"input_tokens": 23,
"cache_creation_input_tokens": 17920,
"cache_read_input_tokens": 0,
"cache_creation": {"ephemeral_5m_input_tokens": 17920, "ephemeral_1h_input_tokens": 0},
"output_tokens": 4
}
```
```json title="第二次：命中缓存"
{
"input_tokens": 23,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 17920,
"cache_creation": {"ephemeral_5m_input_tokens": 0, "ephemeral_1h_input_tokens": 0},
"output_tokens": 4
}
```
Si le `cache_read_input_tokens` de la seconde réponse est supérieur à 0, cela indique que le cache est lu. Les tokens d'écriture et de lecture du cache de chaque appel apparaissent aussi dans la colonne Token des [journaux d'appel](/fr/docs/usage-logs/) ; la lecture est notée « cache↓ » et l'écriture « ↑ ».
## Comment c’est facturé
| Type | Tarif officiel | Tarif 1折AI |
|---|---|---|
| Écriture du cache (5 minutes) | Tarif d'entrée × 1,25 | Tarif officiel, sans remise |
| Écriture du cache (1 heure) | Tarif d'entrée × 2 | Tarif officiel, sans remise |
| Lecture du cache | Tarif d'entrée × 0,1 (0,05 pour Opus 5.5 et Sonnet 5.5, 0,025 pour Fable 5.1) | Tarif officiel, sans remise |
Le tarif officiel d'une écriture de cache de 5 minutes correspond généralement à 1,25 fois le tarif d'entrée officiel. Sur ce site, les entrées bénéficient d'une remise mais le cache non ; on ne peut donc pas conclure qu'une seule lecture de cache rembourse l'écriture en se basant sur le multiplicateur officiel — il faut comparer en tenant compte de la remise sur le modèle, du coût d'écriture et du nombre de lectures répétées. Un exemple de calcul complet est disponible dans [Tarifs et facturation](/fr/docs/pricing-explained/).
### Cache d’une heure
Ajoutez `"ttl": "1h"` dans `cache_control` pour conserver le cache pendant 1 heure ; cela convient aux préfixes utilisés à intervalles supérieurs à 5 minutes mais encore répétitivement :
```json
"cache_control": {"type": "ephemeral", "ttl": "1h"}
```
L'écriture est facturée 2 fois le tarif d'entrée officiel, sans appliquer le tarif d'entrée remisé ; la lecture est identique à celle du cache de 5 minutes. Les tokens d'écriture figurent dans `cache_creation.ephemeral_1h_input_tokens` de la réponse. Le choix du cache d'une heure doit être évalué en fonction de l'intervalle entre les deux requêtes, du coût d'écriture et du nombre de lectures répétées.
## Le cache dans Claude Code
Claude Code place automatiquement des points de rupture de cache sur l'invite système, les définitions d'outils et l'historique de conversation ; [l'explication officielle est ici](https://code.claude.com/docs/zh-CN/prompt-caching). Pour améliorer les hits :
- Travaillez en continu dans une session sans pauses prolongées. Le cache expire après 5 minutes d'inactivité.
- Les requêtes suivantes d'une même session lisent le cache. Mesure du 2026-10-15 : pour une tâche Claude Code en deux tours, le second tour a lu 31 440 tokens de cache et écrit 115 tokens. Lorsque vous ouvrez une nouvelle session, le premier tour doit peut-être réécrire tout le préfixe (environ 30 000 tokens mesurés), ce qui coûte plus cher que les tours suivants.
- Évitez de modifier `CLAUDE.md`, de basculer de serveur MCP ou de changer de modèle en cours de session ; cela modifie le préfixe.
- Ne définissez pas `DISABLE_PROMPT_CACHING=1` : cette variable d'environnement désactive le cache pour tous les modèles.
## L’interface compatible OpenAI peut-elle utiliser le cache ?
Pas pour l'instant. Mesure du 2026-10-15 : en plaçant environ 3 100 tokens de texte fixe dans le message system de `/v1/chat/completions` et en envoyant deux fois la requête, que `cache_control` soit ajouté ou non sur le bloc de contenu, les deux `usage` étaient :
```json
{"prompt_tokens": 3167, "completion_tokens": 4, "total_tokens": 3171}
```
Sans `prompt_tokens_details.cached_tokens`, les lectures et écritures de cache dans les journaux d'appel sont également à 0, et tout est facturé au tarif d'entrée. Pour les cas nécessitant le cache, utilisez `/v1/messages` (SDK Anthropic ou Claude Code).
## Questions fréquentes
Le cache a été écrit mais pas lu à la requête suivante. Vérifiez dans l'ordre : l'intervalle entre les deux requêtes dépasse-t-il 5 minutes ; le contenu avant le point de rupture est-il identique à la lettre (des horodatages ou des ID aléatoires dans system rendent chaque requête différente) ; le modèle a-t-il changé ; le préfixe atteint-il la longueur minimale indiquée ci-dessus.
Les tokens de lecture et d'écriture du cache de chaque appel figurent dans les journaux d'appel ; vous pouvez calculer vous-même : lecture du cache ÷ (entrée + écriture du cache + lecture du cache).
---
# Délais d'expiration, limitation de débit et nouvelles tentatives
Source: https://1zheai.com/fr/docs/retries/
Markdown: https://1zheai.com/fr/docs/retries.md
---
title: "Délais d'expiration, limitation de débit et nouvelles tentatives"
description: "Configurer les délais d'expiration du SDK et les nouvelles tentatives limitées, distinguer les erreurs réessayables des erreurs de configuration, et éviter les soumissions en double."
headingIds: {"Dans quels cas réessayer":"section-1","Utilisez d’abord les nouvelles tentatives intégrées du SDK":"section-2","Lorsque vous implémentez vos propres nouvelles tentatives":"section-3","Enregistrez suffisamment d’informations de débogage":"section-4"}
---
Corrigez d'abord les erreurs de configuration, puis traitez les pannes temporaires. Limitez le nombre de tentatives, la concurrence et le temps d'attente total ensemble pour éviter de renvoyer la même requête échouée de nombreuses fois en peu de temps.
## Dans quels cas réessayer
| Situation | Recommandation |
| --- | --- |
| 400 / 401 / 403 / 404 | Corrigez d'abord la requête, les permissions ou le modèle ; ne répétez pas automatiquement la requête d'origine |
| 429 | Consultez l'invite de la réponse ; si `Retry-After` est présent, respectez le délai d'attente et réduisez la concurrence |
| 500 / 502 / 503 / 504 / 529 | Vous pouvez réessayer de manière limitée ; en cas d'échec persistant, arrêtez et transmettez l'ID de la requête |
| Échec de connexion | Vérifiez DNS, proxy et réseau, réessayez de manière limitée dans le délai autorisé par la tâche |
| Délai d'expiration ou interruption du flux après l'envoi de la requête | Le résultat peut être incertain ; vérifiez d'abord les journaux ; ne supposez pas que l'amont n'a pas encore traité la requête |
La portée des nouvelles tentatives de la bibliothèque client ne correspond pas nécessairement exactement au tableau ci-dessus. Utilisez la couche de réessai que vous choisissez et définissez explicitement la stratégie à cette couche.
## Utilisez d’abord les nouvelles tentatives intégrées du SDK
Les unités de délai d'expiration diffèrent entre Python et Node.js : Python utilise les secondes, Node.js utilise les millisecondes. L'exemple suivant définit un délai d'expiration de 120 secondes et jusqu'à 2 nouvelles tentatives automatiques ; lors du débogage initial, vous pouvez le mettre à 0.
```python title="Python"
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=2,
)
```
```javascript title="Node.js"
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.ONEZHE_API_KEY,
baseURL: "https://1zheai.com/v1",
timeout: 120_000,
maxRetries: 2,
});
```
La configuration du délai d'expiration n'est pas la limite de durée totale de l'ensemble de la tâche métier : les nouvelles tentatives et les attentes augmentent la durée totale. Si la couche supérieure réexécute la tâche, définissez un délai global et un mécanisme d'annulation séparément.
## Lorsque vous implémentez vos propres nouvelles tentatives
Désactivez les nouvelles tentatives automatiques du SDK pour éviter les superpositions. Utilisez des intervalles d'attente progressifs avec un jitter aléatoire ; limitez explicitement le nombre de tentatives, le temps d'attente maximal et la file d'attente de concurrence. Lors de l'analyse de `Retry-After`, notez qu'il peut s'agir soit de secondes, soit d'une date HTTP.
Si vous avez déjà affiché une partie des résultats en flux à l'utilisateur, ne rejouez pas automatiquement depuis le début et ne concaténez pas à l'ancien texte. Conservez l'état « incomplet » et laissez l'utilisateur décider de régénérer ou de continuer.
Pour la génération d'images, l'exécution d'outils et d'autres tâches pouvant produire des résultats externes, faites particulièrement attention aux soumissions en double. Ne supposez pas que définir un ID de requête arbitraire permettra au serveur de dédupliquer automatiquement.
## Enregistrez suffisamment d’informations de débogage
Enregistrez l'heure, le point de terminaison, le modèle, le code d'état, la durée, le numéro de tentative et l'ID de requête renvoyé par le serveur. Évitez d'enregistrer les en-têtes d'authentification et les invites privées complètes. Utilisez ces informations pour comparer avec les [journaux d'appels](/fr/docs/usage-logs/).
Pour les paramètres du SDK, consultez [OpenAI Python SDK](https://github.com/openai/openai-python#retries) et [Node SDK](https://github.com/openai/openai-node#retries). Pour les erreurs spécifiques, voir [codes d'erreur et débogage](/fr/docs/troubleshooting/).
---
# Référence API
Source: https://1zheai.com/fr/docs/api-reference/
Markdown: https://1zheai.com/fr/docs/api-reference.md
---
title: "Référence API"
description: "Trouvez les interfaces documentées, les exemples de requêtes et les différences de protocole pour clarifier la portée de compatibilité."
headingIds: {"Index des interfaces":"section-1","Portée de compatibilité":"section-2","Réponses et incidents":"section-3"}
---
Cette page regroupe les descriptions d'interfaces et les exemples de requêtes disponibles sur ce site. Ce site fournit les modèles Claude et OpenAI / GPT. Choisissez le protocole correspondant en fonction du modèle et de l'outil ; les modèles précis dépendent de la liste disponible pour votre clé.
## Index des interfaces
| Interface | Usage | Description et exemples |
| --- | --- | --- |
| `POST /v1/messages` | Conversation native Anthropic | [Requête et réponse](/fr/docs/api-messages/), [SDK Anthropic](/fr/docs/quickstart-anthropic-sdk/), [curl](/fr/docs/quickstart-curl/) |
| `POST /v1/chat/completions` | Conversation compatible OpenAI | [Requête et réponse](/fr/docs/api-chat-completions/), [SDK OpenAI](/fr/docs/quickstart-openai-sdk/), [curl](/fr/docs/quickstart-curl/) |
| `POST /v1/responses` | OpenAI Responses | [Requête et réponse](/fr/docs/api-responses/), [Codex CLI](/fr/docs/quickstart-codex/) |
| `GET /v1/models` | Interroger les modèles disponibles pour la clé | [Format de liste et requête](/fr/docs/api-models/), [Sélection du modèle](/fr/docs/models/) |
| `POST /v1/messages/count_tokens` | Comptage des tokens en entrée | [Description de l'interface](/fr/docs/base-url/) |
| `POST /v1/images/generations` | Génération d'images à partir de texte | [Intégration de la génération d'images](/fr/docs/api-images/) |
## Portée de compatibilité
Pour les capacités natives de Claude, consultez en priorité le tutoriel d'intégration Anthropic. Avant de changer de protocole, vérifiez que les fonctionnalités requises sont décrites dans le tutoriel correspondant ; ne déduisez pas uniquement d'une requête réussie que les appels d'outils, la mise en cache ou les tâches longues sont pris en charge.
Codex utilise `/v1/responses`, voir [Intégration Codex CLI](/fr/docs/quickstart-codex/). Les modèles actuellement disponibles dépendent de la [description des modèles](/fr/docs/models/) et de la liste réellement renvoyée par votre clé.
## Réponses et incidents
formats d'événements et gestion des interruptions de flux pour les deux protocoles. localisation des problèmes par code de statut et message d'erreur.
Les détails des interfaces fournissent une requête minimale, les champs courants, la lecture des résultats et les limites de compatibilité ; les paramètres complets doivent toujours être combinés avec la documentation du protocole du modèle choisi. Ce site ne fournit pas encore de spécification OpenAPI complète téléchargeable.
Les Embeddings, Batch, l'hébergement de fichiers et les modèles propriétaires tiers non confirmés dans le catalogue public ne relèvent pas des engagements de cette page. Si vous avez besoin de ces capacités, contactez d'abord le support.
---
# Base URL, interfaces et authentification
Source: https://1zheai.com/fr/docs/base-url/
Markdown: https://1zheai.com/fr/docs/base-url.md
---
title: "Base URL, interfaces et authentification"
description: "Base URL de 1折AI, interfaces disponibles, écriture des en-têtes de requête, et si ajouter /v1 selon l'outil."
headingIds: {"Interfaces disponibles":"section-1","Ajouter ou non /v1":"section-2","En-têtes d’authentification":"section-3","Vérifier si une clé API est utilisable":"section-4","Limites de débit":"section-5","Réseau":"section-6"}
---
Toutes les requêtes sont envoyées vers le même domaine, avec deux jeux de chemins selon le protocole.
```text
https://1zheai.com
```
## Interfaces disponibles
| Interface | Protocole | Usage |
|---|---|---|
| `POST /v1/messages` | Natif Anthropic | Conversation. Claude Code, Anthropic SDK, Cline (mode Anthropic) passent par ici |
| `POST /v1/chat/completions` | Compatible OpenAI | Conversation. OpenAI SDK, Cursor, Cherry Studio (mode OpenAI) passent par ici |
| `GET /v1/models` | Compatible OpenAI | Liste les modèles utilisables par votre clé API (API key) |
| `POST /v1/messages/count_tokens` | Natif Anthropic | Compte le nombre de tokens d'une entrée, ne génère pas de conversation, ne facture pas |
Le corps de la requête de `count_tokens` est identique à celui de `/v1/messages` (`model`, `messages`, peut inclure `system` et `tools`) ; la réponse ne contient qu'un seul champ :
```json
{"input_tokens":19}
```
`count_tokens` ne compte que ce que vous envoyez. Lors d'un appel réel via SDK, curl ou outil tiers, chaque requête inclut en plus une invite système, facturée en tokens d'entrée (Claude Code n'en inclut pas) ; voir [la facturation des invites système](/fr/docs/pricing-explained/#section-3).
Les capacités propres à Claude comme le Prompt Caching, l'extended thinking et les appels d'outils fonctionnent le plus de manière fiable avec l'interface native `/v1/messages`. L'interface compatible OpenAI convient aux cas où vous avez déjà du code OpenAI et souhaitez simplement changer de modèle.
## Ajouter ou non /v1
Différents outils interprètent le Base URL différemment ; c'est le piège le plus courant lors de l'intégration :
| Outil / SDK | Ce qu'il faut renseigner | Raison |
|---|---|---|
| Claude Code (`ANTHROPIC_BASE_URL`) | `https://1zheai.com` | L'outil assemble lui-même `/v1/messages` |
| Anthropic SDK (`base_url`) | `https://1zheai.com` | Idem |
| OpenAI SDK (`base_url`) | `https://1zheai.com/v1` | Le SDK assemble uniquement `/chat/completions` |
| Cursor (Override OpenAI Base URL) | `https://1zheai.com/v1` | Comme l'OpenAI SDK |
| Cherry Studio | `https://1zheai.com` | Ajoute automatiquement `/v1/...` |
| Cline (OpenAI Compatible) | `https://1zheai.com/v1` | Comme l'OpenAI SDK |
Règle : la famille Anthropic prend l'adresse racine, la famille OpenAI jusqu'à `/v1`. Une erreur de saisie se manifeste typiquement par un 404.
## En-têtes d’authentification
La clé API est placée dans l'en-tête de requête ; les deux écritures suivantes fonctionnent :
```text title="Anthropic 原生"
x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json
```
```text title="Bearer（两种协议都支持）"
Authorization: Bearer sk-你的Key
content-type: application/json
```
- Lors de l'appel à `/v1/messages`, incluez `anthropic-version` conformément au protocole officiel ; la valeur actuelle est `2023-06-01`. En test, l'appel fonctionne aussi sans, mais les SDK et outils officiels l'incluent ; faites de même lorsque vous écrivez vos propres requêtes.
- Le `ANTHROPIC_AUTH_TOKEN` de Claude Code envoie `Authorization: Bearer`, et `ANTHROPIC_API_KEY` envoie `x-api-key` ; nous acceptons les deux.
- Lorsque vous avez besoin d'une fonctionnalité beta, incluez l'en-tête `anthropic-beta` conformément à la documentation officielle. Inclure une valeur inconnue ne provoque pas d'erreur ; l'effet réel d'une fonctionnalité beta se juge donc sur l'effet observé dans la réponse.
## Vérifier si une clé API est utilisable
```bash
curl https://1zheai.com/v1/models \
-H "Authorization: Bearer sk-你的Key"
```
La renvoi de la liste des modèles indique que la clé API et l'adresse sont correctes. Un 401 provient de la clé API ; la réponse ressemble à ceci (testé le 2026-10-15) :
```json
{"error":{"code":"","message":"Invalid token (request id: 202610150244361675490398268d9d6eKJPmcph)","type":"authentication_error"}}
```
Lors d'une requête à `/v1/models` avec les en-têtes `x-api-key` et `anthropic-version`, la réponse est une liste de modèles au format Anthropic (`data[].id`, `display_name`, `has_more`) ; c'est ce format que lit la découverte automatique des modèles de Claude Code.
Pour les autres cas, voir [codes d'erreur et dépannage](/fr/docs/troubleshooting/).
## Limites de débit
Aucune limite de débit n'est actuellement appliquée aux clés API. En cas de 429, il s'agit généralement d'une charge amont élevée ; réessayez plus tard, et ajoutez un backoff exponentiel pour les tâches par lots. Voir [codes d'erreur et dépannage](/fr/docs/troubleshooting/).
## Réseau
En cas de délai d'expiration de connexion ou d'erreur TLS, vérifiez d'abord le réseau utilisé par le terminal : si un proxy global est actif, désactivez-le et réessayez en connexion directe ; sur un réseau d'entreprise avec liste blanche de sortie, autorisez `1zheai.com`.
---
# Interroger l'API des modèles disponibles
Source: https://1zheai.com/fr/docs/api-models/
Markdown: https://1zheai.com/fr/docs/api-models.md
---
title: "Interroger l'API des modèles disponibles"
description: "Les deux formats de réponse de GET /v1/models, la lecture des identifiants de modèle, ainsi que la différence entre la visibilité d'un modèle et sa réelle capacité d'appel."
headingIds: {"Format OpenAI":"section-1","Format Anthropic":"section-2","Comment utiliser les résultats de la requête":"section-3","Liste vide ou modèles manquants":"section-4"}
---
Interrogez d'abord les modèles, puis rédigez votre requête. `GET https://1zheai.com/v1/models` renvoie les modèles visibles sous les restrictions de clé, de groupe et de modèle actuelles, sans nécessiter d'envoyer une requête d'inférence.
## Format OpenAI
```bash
curl --fail-with-body --connect-timeout 10 --max-time 30 \
https://1zheai.com/v1/models \
-H "Authorization: Bearer $ONEZHE_API_KEY"
```
Voici un aperçu simplifié de la structure ; la liste dépend du retour réel :
```json
{
"object": "list",
"data": [{"id": "gpt-5.6-sol", "object": "model"}]
}
```
Lorsque `jq` est installé, vous pouvez ajouter `| jq -r '.data[].id'` après la requête pour afficher un identifiant de modèle par ligne. Ne confondez pas le `model_name` de l'interface de prix publique avec le `id` ici.
## Format Anthropic
Lorsque les deux en-têtes suivants sont utilisés, le même chemin renvoie des données de style Anthropic :
```bash
curl --fail-with-body https://1zheai.com/v1/models \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01"
```
Portez attention sur `data[].id`, `data[].display_name` et `has_more`. Après avoir changé de méthode d'authentification, ne continuez pas à analyser la réponse selon l'autre structure.
## Comment utiliser les résultats de la requête
1. Copiez l'identifiant complet depuis `data[].id` en conservant la casse, les tirets et le suffixe de date.
2. Vérifiez le type d'interface de ce modèle dans le [catalogue de modèles de la console](https://1zheai.com/model-catalog?lng=fr).
3. Validez avec une requête de texte minimale, puis ajoutez progressivement des images, des outils ou d'autres paramètres.
La liste des modèles n'est pas un contrôle de santé en temps réel et n'inclut pas toutes les restrictions de paramètres. Un modèle peut être visible mais les requêtes peuvent encore échouer si aucun amont disponible n'est temporairement disponible ; la surveillance de disponibilité HTTP du site officiel ne signifie pas non plus que chaque modèle peut réussir une inférence.
## Liste vide ou modèles manquants
Vérifiez les restrictions de modèle et le groupe de votre clé ; les modèles affichés sur la page de prix publique ne sont pas nécessairement ouverts à chaque clé. Pour 401, vérifiez d'abord l'état de la clé ; pour 403, vérifiez les conditions d'accès ; pour les étapes détaillées, consultez [codes d'erreur et dépannage](/fr/docs/troubleshooting/).
Pour les familles de modèles et les conseils de sélection, consultez [modèles pris en charge](/fr/docs/models/).
---
# Interface de conversation Chat Completions
Source: https://1zheai.com/fr/docs/api-chat-completions/
Markdown: https://1zheai.com/fr/docs/api-chat-completions.md
---
title: "Interface de conversation Chat Completions"
description: "Requête minimale, champs courants, lecture de la réponse et rédaction de conversations multi-tours pour POST /v1/chat/completions."
headingIds: {"Requête minimale":"section-1","Champs courants":"section-2","Comment lire la réponse":"section-3","Conversations multi-tours":"section-4","Flux et suites":"section-5"}
---
Si vous utilisez un client compatible OpenAI, ou si vous disposez déjà de code `chat.completions.create`, commencez par cette interface. L'adresse complète est `https://1zheai.com/v1/chat/completions` ; pour le SDK, la Base URL ne doit contenir que jusqu'à `/v1`.
## Requête minimale
Définissez d'abord `ONEZHE_API_KEY` dans le terminal avec la clé de ce site. Le modèle ci-dessous doit exister dans [votre liste de modèles disponibles](/fr/docs/api-models/).
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/chat/completions \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [{"role": "user", "content": "请用一句中文解释 DNS 的作用。"}]
}'
```
`--fail-with-body` fait retourner un code de sortie non nul en cas d'erreur HTTP tout en conservant le corps de l'erreur ; nécessite curl 7.76 ou une version plus récente. Sur une version antérieure, utilisez d'abord `-i` pour afficher le code de statut.
## Champs courants
| Champ | Type | Mode d'emploi |
| --- | --- | --- |
| `model` | string | Obligatoire, copiez l'ID du modèle de ce site, sans ajouter de préfixe de fournisseur d'une autre plateforme |
| `messages` | array | Obligatoire, envoyez dans l'ordre la question de ce tour et les messages d'historique à conserver |
| `messages[].role` | string | Pour une conversation normale, utilisez `user` / `assistant` ; la prise en charge du rôle d'instruction système dépend du modèle |
| `messages[].content` | string ou tableau de blocs de contenu | Pour du texte pur, utilisez d'abord une chaîne ; l'entrée d'image nécessite que le modèle prenne en charge le bloc de contenu correspondant |
| `stream` | boolean | Lorsqu'il est défini sur `true`, lisez le SSE au lieu de traiter l'intégralité de la réponse comme un unique JSON |
| `temperature` | number | Facultatif, certains modèles de raisonnement ne permettent pas de le modifier ; omettez-le d'abord puis vérifiez item par item |
| `tools` / `tool_choice` | array / string ou object | Facultatif, doit être pris en charge à la fois par le modèle et l'amont ; l'exécution réelle des outils est effectuée par votre programme |
Les paramètres de limite de sortie varient selon le modèle. Ne remplacez pas mécaniquement les paramètres de Claude `max_tokens`, ceux de Responses `max_output_tokens` et ceux de Chat Completions ; référez-vous aux exigences du modèle choisi, et en cas de 400, consultez d'abord le corps de l'erreur.
## Comment lire la réponse
Le résultat en texte se trouve dans `choices[0].message.content`. La raison de fin se trouve dans `choices[0].finish_reason` ; lorsqu'un appel d'outil est renvoyé, le texte peut être vide et vous devrez lire `message.tool_calls`. Les `id`, `model` et `usage` de la réponse peuvent servir à vérifier cet appel.
Ci-dessous, seules les structures à examiner sont affichées ; les champs et chiffres omis ne représentent pas le résultat d'une vraie requête :
```json
{
"id": "example-completion",
"object": "chat.completion",
"model": "gpt-5.6-sol",
"choices": [{
"index": 0,
"message": {"role": "assistant", "content": "DNS 将域名解析为网络地址。"},
"finish_reason": "stop"
}]
}
```
## Conversations multi-tours
L'interface ne se souvient pas automatiquement du tour précédent parce que vous réutilisez la même clé. Envoyez ensemble l'historique à conserver :
```json
{
"model": "gpt-5.6-sol",
"messages": [
{"role": "user", "content": "我正在学习 DNS。"},
{"role": "assistant", "content": "我们可以从域名解析开始。"},
{"role": "user", "content": "它和 HTTP 有什么区别？"}
]
}
```
Plus l'historique est long, plus la requête est volumineuse. L'application doit tronquer ou résumer selon la limite de contexte, et conserver les paires complètes d'appels d'outils et de résultats.
## Flux et suites
Avec `"stream": true` ajouté, les incrémentes de texte proviennent de `choices[].delta.content`. Certains événements n'ont pas de texte ou `choices` est vide ; à la lecture, il faut en tenir compte ; voir [sortie en flux](/fr/docs/streaming/).
Exécutez directement [l'exemple complet Python / Node.js](/fr/docs/code-examples/), ou passez à [Responses](/fr/docs/api-responses/) ; pour les paramètres natifs de Claude, voir [Messages](/fr/docs/api-messages/).
---
# Interface de conversation native Messages
Source: https://1zheai.com/fr/docs/api-messages/
Markdown: https://1zheai.com/fr/docs/api-messages.md
---
title: "Interface de conversation native Messages"
description: "En-têtes de requête Messages de Claude, différences entre system et messages, blocs de contenu et motifs d'arrêt."
headingIds: {"Requête minimale":"section-1","Structure de la requête":"section-2","Lecture des blocs de contenu":"section-3","Multi-tours et diffusion":"section-4"}
---
Claude Code, le SDK Anthropic et les applications qui souhaitent préserver les blocs de contenu natifs de Claude utilisent `POST https://1zheai.com/v1/messages`. Renseignez l'URL de base du SDK avec `https://1zheai.com`.
## Requête minimale
Définissez d'abord la variable d'environnement de clé de ce site `ONEZHE_API_KEY`, puis exécutez :
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/messages \
-H "x-api-key: $ONEZHE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 256,
"system": "请用简短的中文回答。",
"messages": [{"role": "user", "content": "什么是域名解析？"}]
}'
```
## Structure de la requête
| Champ | Type | Utilisation |
| --- | --- | --- |
| `model` | chaîne | Requis, sélectionne le modèle Claude disponible pour la clé |
| `max_tokens` | entier | Requis, limite supérieure de sortie ; à définir en combinaison avec les limites du modèle sélectionné |
| `messages` | tableau | Requis, envoie les messages `user` et `assistant` dans l'ordre chronologique |
| `system` | chaîne ou tableau de blocs de contenu | Facultatif, les instructions système sont placées au niveau supérieur, et non en tant que message `role: system` |
| `stream` | booléen | Facultatif, diffuse les incréments de blocs de contenu |
| `tools` | tableau | Facultatif, déclare les noms d'outils, leurs finalités et les Schémas d'entrée |
`thinking`, le cache control et les paramètres bêta dépendent du modèle spécifique et du support en amont. Vérifiez d'abord le texte brut, puis ajoutez au besoin ; ne considérez pas que tous les modèles disposent du même ensemble de paramètres.
## Lecture des blocs de contenu
Le `content` retourné est un tableau et peut contenir simultanément du texte, des requêtes d'outils ou d'autres blocs de contenu. Ne lisez pas `content[0].text` de manière inconditionnelle. Par exemple, avec le SDK Python Anthropic :
```python
for block in message.content:
if block.type == "text":
print(block.text)
```
Ici, `message` provient de `client.messages.create(...)` dans le [Tutoriel du SDK Anthropic ](/fr/docs/quickstart-anthropic-sdk/).
| `stop_reason` | Comment l'application doit le traiter |
| --- | --- |
| `end_turn` | La réponse de ce tour est terminée |
| `max_tokens` | La sortie a été tronquée par la limite supérieure et ne peut être considérée comme une réponse complète |
| `tool_use` | Vérifiez les requêtes d'outils, exécutez les outils autorisés et renvoyez les résultats |
| Autres valeurs | Conservez la réponse et traitez-la selon le protocole du modèle sélectionné ; ne supposez pas qu'il s'agit nécessairement d'une complétion de texte |
Dans une boucle d'appel d'outil, ajoutez d'abord le bloc de contenu complet de l'assistant à l'historique, puis renvoyez-le avec `tool_result` dans le contenu utilisateur ; `tool_use_id` doit correspondre à la requête d'origine. Ne convertissez pas directement les requêtes d'outils en un seul passage de texte brut.
## Multi-tours et diffusion
Envoyez chaque fois l'historique à conserver ; l'interface elle-même ne stocke pas les conversations pour l'application. La diffusion utilise `message_stop` pour indiquer la fin d'un message ; recevoir un texte partiel ne signifie pas que la requête est terminée. Voir [Sortie en diffusion ](/fr/docs/streaming/) pour plus de détails.
Pour les détails du protocole, consultez [Notes d'utilisation des Messages Anthropic ](https://platform.claude.com/docs/en/build-with-claude/working-with-messages). La disponibilité des paramètres étendus de ce site est déterminée par le catalogue de modèles et les réponses réelles.
---
# Interface Responses
Source: https://1zheai.com/fr/docs/api-responses/
Markdown: https://1zheai.com/fr/docs/api-responses.md
---
title: "Interface Responses"
description: "Connectez 1折AI via l'interface Responses d'OpenAI, et comprenez l'input, l'output, les événements de streaming et les limites de compatibilité."
headingIds: {"Requête minimale":"section-1","Différences avec Chat Completions":"section-2","SDK Python":"section-3","Lecture en streaming":"section-4","Portée de compatibilité":"section-5"}
---
Codex CLI utilise le protocole Responses. Lorsque vous écrivez votre propre application, vous pouvez également demander les modèles GPT prenant en charge cette interface via `POST https://1zheai.com/v1/responses`. Renseignez l'URL de base du SDK OpenAI avec `https://1zheai.com/v1`.
## Requête minimale
```bash
curl --fail-with-body --connect-timeout 10 --max-time 120 \
https://1zheai.com/v1/responses \
-H "Authorization: Bearer $ONEZHE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6-astra",
"input": "用三句话解释 API 网关。",
"store": false
}'
```
Avant l'exécution, définissez `ONEZHE_API_KEY` et vérifiez que le modèle figure dans [votre liste des modèles disponibles ](/fr/docs/api-models/). `store: false` est une option de stockage du protocole ; cela ne signifie pas que tous les niveaux de service sont exempts de journaux ou de conservation des données ; n'en déduisez pas d'engagement de confidentialité.
## Différences avec Chat Completions
| Élément | Chat Completions | Responses |
| --- | --- | --- |
| Entrée | `messages` | `input`, pouvant être une chaîne ou des éléments d'entrée structurés |
| Résultat textuel | `choices[].message.content` | Bloc de contenu message dans `output` |
| Attribut d'aide textuel du SDK | Extraction manuelle du choix | `response.output_text` |
| Texte en streaming | `choices[].delta.content` | Événements `response.output_text.delta` |
| Détection de fin | `finish_reason` et fin du flux | Vérifiez l'état de la réponse et l'événement de terminaison |
`output_text` est un attribut de commodité fourni par le SDK ; ne supposez pas que ce champ existe au premier niveau du JSON HTTP brut. Lors d'un appel HTTP direct, parcourez `output`, sélectionnez `type: message`, puis lisez la `text` de `type: output_text` dans son `content`.
## SDK Python
Après l'installation de `python -m pip install openai` :
```python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=120.0,
max_retries=0,
)
response = client.responses.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-6-astra"),
input="用三句话解释 API 网关。",
store=False,
)
print(response.output_text)
print("status:", response.status)
```
Ici, la reprise automatique est désactivée afin de faciliter l'identification d'une requête unique lors de la première intégration. Avant la mise en production, définissez la stratégie selon [les délais d'attente et les tentatives ](/fr/docs/retries/).
## Lecture en streaming
À utiliser après l'initialisation de `client` ci-dessus :
```python
with client.responses.create(
model=os.environ.get("ONEZHE_MODEL", "gpt-6-astra"),
input="用三句话解释 API 网关。",
store=False,
stream=True,
) as stream:
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
elif event.type == "response.completed":
print("\n完成")
elif event.type in {"response.failed", "response.incomplete", "error"}:
raise RuntimeError(f"响应未完成：{event.type}")
```
Si la connexion est interrompue sans réception de l'événement de complétion, le résultat doit être marqué comme incomplet ; le succès ne peut être déduit uniquement du texte déjà affiché.
## Portée de compatibilité
Cette page couvre la création de réponses et la lecture de texte. N'en déduisez pas que toutes les fonctionnalités telles que les tâches en arrière-plan, la récupération des réponses passées, `previous_response_id`, les outils hébergés, le stockage de fichiers, etc. sont disponibles. Pour la reprise de session, validez d'abord avec un historique d'entrée explicite ; pour un outil spécifique, validez item par item selon le modèle et le client.
Pour configurer les outils prêts à l'emploi, consultez [Codex CLI ](/fr/docs/quickstart-codex/). Pour l'utilisation du SDK, consultez [OpenAI Python SDK ](https://github.com/openai/openai-python).
---
# Intégration de la génération d'images
Source: https://1zheai.com/fr/docs/api-images/
Markdown: https://1zheai.com/fr/docs/api-images.md
---
title: "Intégration de la génération d'images"
description: "Générer des images via l'API OpenAI Images, enregistrer le résultat en Base64 et diagnostiquer les permissions de modèle et les timeouts."
headingIds: {"API et préparation":"section-1","Générer et enregistrer une image":"section-2","Vérifier la prise en charge du modèle avant d’ajouter des paramètres":"section-3","Problèmes courants":"section-4"}
---
Le catalogue public de modèles de ce site répertorie actuellement `gpt-image-1.5` et `chatgpt-image-latest` (vérifié le 2026-10-16). Avant utilisation, interrogez d'abord [les modèles disponibles pour la clé](/fr/docs/api-models/), puis confirmez l'API d'images et ses paramètres dans le [catalogue de modèles de la console](https://1zheai.com/model-catalog?lng=fr).
Cette page fournit un exemple d'intégration conforme au protocole OpenAI Images ; cette mise à jour de la documentation n'a pas exécuté de génération d'images payante et ne doit pas être interprétée comme la preuve que toutes les combinaisons de modèles, de tailles et de qualités ont été testées.
## API et préparation
- Adresse complète : `POST https://1zheai.com/v1/images/generations`
- Base URL du SDK OpenAI : `https://1zheai.com/v1`
- Utilisez la variable d'environnement `ONEZHE_API_KEY` de ce site.
- Installer le SDK Python : `python -m pip install openai`.
## Générer et enregistrer une image
Enregistrez sous `generate-image.py`, puis exécutez `python generate-image.py` dans le terminal :
```python
import base64
import os
from pathlib import Path
from openai import OpenAI
client = OpenAI(
api_key=os.environ["ONEZHE_API_KEY"],
base_url="https://1zheai.com/v1",
timeout=300.0,
max_retries=0,
)
result = client.images.generate(
model=os.environ.get("ONEZHE_IMAGE_MODEL", "gpt-image-1.5"),
prompt="一只白色陶瓷茶杯放在浅灰色桌面上，柔和自然光，无文字。",
)
if not result.data:
raise RuntimeError("响应没有图片数据，请检查错误信息与调用日志。")
item = result.data[0]
if item.b64_json:
target = Path("generated-image.png")
target.write_bytes(base64.b64decode(item.b64_json, validate=True))
print(f"图片已保存到 {target.resolve()}")
elif item.url:
print("返回的是图片地址，请及时下载：", item.url)
else:
raise RuntimeError("响应没有 b64_json 或 url。")
```
L'exemple utilise le format de sortie par défaut. Si vous spécifiez un autre format (JPEG / WebP, etc.), modifiez également l'extension de fichier lors de l'enregistrement. N'écrivez pas la chaîne Base64 directement dans un fichier texte puis ne la renommez pas en PNG.
## Vérifier la prise en charge du modèle avant d’ajouter des paramètres
Validez d'abord avec une requête contenant uniquement `model` et `prompt`. Les paramètres tels que la taille, la qualité, l'arrière-plan transparent et le format de sortie ne sont pas universels parmi tous les modèles d'images ; ne copiez pas directement les noms de modèles ou les paramètres propriétaires d'autres fournisseurs.
Lorsque la réponse contient `data[].b64_json`, effectuez le décodage Base64 ; lorsqu'elle contient `data[].url`, téléchargez-la rapidement et n'utilisez pas l'URL temporaire comme stockage permanent. L'application doit gérer elle-même le stockage des résultats.
## Problèmes courants
| Situation | Méthode de diagnostic |
| --- | --- |
| 400 paramètre non pris en charge | Retirez les paramètres optionnels personnalisés (taille, qualité, etc.) et vérifiez-les un par un |
| 403 / 404 | Vérifiez l'ID du modèle d'image, les permissions de la clé et le chemin complet de l'API |
| Temps d'attente long | Définissez un délai d'attente raisonnable pour la génération et affichez un état en cours d'exécution pour éviter les soumissions répétées par clics consécutifs |
| Aucune image après un timeout | Consultez d'abord les journaux d'appel ; l'absence de résultat reçu ne signifie pas que l'amont n'a pas traité la requête |
| Modifier une image existante | La modification d'image est une autre API et un autre mode d'entrée ; l'exemple de génération d'image à partir de texte de cette page ne peut pas le remplacer directement |
Référence des paramètres du protocole : [OpenAI image generation reference](https://developers.openai.com/api/reference/resources/images/methods/generate). Les frais sont basés sur le catalogue de modèles en temps réel de ce site ; voir [Timeouts et retries](/fr/docs/retries/) pour la stratégie de nouvelle tentative.
---
# Compte et assistance
Source: https://1zheai.com/fr/docs/support/
Markdown: https://1zheai.com/fr/docs/support.md
---
title: "Compte et assistance"
description: "Gérer les frais et les journaux d'appels, localiser les problèmes d'intégration et fournir les informations de dépannage nécessaires."
headingIds: {"Commandes de la boutique":"section-1","Frais et compte":"section-2","Problèmes lors des appels":"section-3","Consultation en libre-service":"section-4"}
---
## Commandes de la boutique
[Guide d'achat](/fr/docs/store-guide/) · [Dépannage des commandes](/fr/docs/store-orders/) · [Règles de transaction et de service après-vente](/fr/docs/store-rules/)
Pour les problèmes concernant les comptes prêts à l'emploi, les recharges et les cartes cadeaux, consultez d'abord [Mes commandes](https://1zheai.com/store-orders?lng=fr) pour vérifier l'état ; lors de la prise de contact avec l'assistance, fournissez le numéro de commande et les informations d'erreur masquées, sans envoyer de mots de passe, de codes de vérification ou de données de session complètes.
## Frais et compte
comprendre la composition des frais et les explications de calcul. consulter les règles de paiement et de service après-vente. localiser chaque appel et vérifier les frais. consulter les instructions de création, de stockage et de rotation.
## Problèmes lors des appels
Consultez d'abord les [codes d'erreur et le dépannage](/fr/docs/troubleshooting/), puis vérifiez [l'adresse et le protocole](/fr/docs/base-url/) ainsi que [les limites des outils](/fr/docs/integrations/). Pour vérifier le modèle et l'utilisation, voir [Vérifier le modèle et l'utilisation](/fr/docs/verify-model/).
Si vous avez encore besoin d'aide, fournissez via la console ou les canaux d'assistance publiés sur le site officiel : l'heure de survenue et le fuseau horaire, l'outil et sa version, l'ID du modèle, le code d'état HTTP, l'ID de requête (le cas échéant), les informations d'erreur masquées, et si le problème peut être reproduit avec une requête minimale.
N'envoyez pas de clés API complètes, d'en-têtes d'authentification complets ou de conversations complètes contenant du contenu privé.
## Consultation en libre-service
- [FAQ d'intégration](/fr/docs/faq/) : adresses, modèles, lecture des réponses et signification de la surveillance.
- [Délais d'attente et nouvelles tentatives](/fr/docs/retries/) : configurer le temps d'attente du client et le traitement des échecs.
- [Guide de migration](/fr/docs/migration/) : basculer point par point depuis le fournisseur d'origine.
---
# Prix et facturation
Source: https://1zheai.com/fr/docs/pricing-explained/
Markdown: https://1zheai.com/fr/docs/pricing-explained.md
---
title: "Prix et facturation"
description: "Les entrées et sorties de Claude sont facturées avec la remise du modèle, les lectures et écritures de cache au tarif officiel ; vérifiez les coûts d'appel grâce aux exemples de calcul par catégorie."
headingIds: {"Coût d’un appel":"section-1","Exemple de calcul":"section-2","Facturation de l’invite système":"section-3","Solde et devise":"section-4","Comment vérifier les remises et les coûts":"section-5","Questions fréquentes":"section-6"}
---
**Les entrées et sorties de Claude sont facturées avec la remise du modèle, les lectures et écritures de cache au tarif officiel, sans remise.** Les prix unitaires et remises de chaque modèle se trouvent dans [Modèles et tarifs](https://1zheai.com/en/pricing/). Pour GPT, MiMo et les modèles de génération d'images, consultez leurs unités de facturation et tarifs respectifs ; les exemples de calcul en tokens de cette page visent Claude.
## Coût d’un appel
Chaque appel est facturé séparément selon les quatre types de tokens de la réponse `usage` :
```text
费用 = ( 输入 token × 输入单价
+ 缓存写入 token × 缓存写单价
+ 缓存读取 token × 缓存读单价
+ 输出 token × 输出单价 ) ÷ 1,000,000
输入单价、输出单价 = 对应官方单价 × 该模型折扣
缓存读取单价、缓存写入单价 = 对应官方原价
```
Les quatre types de tokens correspondent aux champs de la réponse :
| Élément de facturation | Champ `usage` (natif Anthropic) | Tarif officiel relatif au prix d'entrée |
|---|---|---|
| Entrée | `input_tokens` | 1× |
| Écriture de cache | `cache_creation_input_tokens` | 1,25× (cache 5 minutes), 2× (cache 1 heure, `"ttl": "1h"`) |
| Lecture de cache | `cache_read_input_tokens` | 0,1× (0,05× pour Opus 5.5 et Sonnet 5.5, 0,025× pour Fable 5.1) |
| Sortie | `output_tokens` | selon le modèle, voir la page des tarifs |
Les multiplicateurs officiels du cache proviennent de la [documentation Anthropic Prompt Caching](https://platform.claude.com/docs/en/build-with-claude/prompt-caching). Le cache de ce site est facturé au tarif officiel correspondant, sans appliquer la remise d'entrée/sortie.
Les tokens d'écriture du cache de 1 heure sont comptés séparément dans `cache_creation.ephemeral_1h_input_tokens`, facturés au double du tarif officiel d'entrée, sans appliquer la remise d'entrée/sortie. Les prix unitaires d'écriture de cache indiqués sur la page des tarifs concernent le cache de 5 minutes.
## Exemple de calcul
Les prix unitaires ci-dessous sont des entiers pris au hasard à des fins de démonstration ; ils ne correspondent à aucun modèle spécifique. Les prix unitaires réels se trouvent sur la page des tarifs.
Supposons les prix unitaires officiels d'un modèle (par million de tokens) : entrée 3 $, sortie 15 $, écriture de cache 3,75 $, lecture de cache 0,30 $. La répartition `usage` d'une requête Claude Code est :
```json
{
"input_tokens": 2000,
"cache_creation_input_tokens": 1500,
"cache_read_input_tokens": 30000,
"output_tokens": 800
}
```
Au tarif officiel :
| Élément | tokens | Prix unitaire officiel | Coût officiel |
|---|---|---|---|
| Entrée | 2 000 | 3 $ | 0,006 $ |
| Écriture de cache | 1 500 | 3,75 $ | 0,005625 $ |
| Lecture de cache | 30 000 | 0,30 $ | 0,009 $ |
| Sortie | 800 | 15 $ | 0,012 $ |
| Total | | | 0,032625 $ |
Si les entrées et sorties de ce modèle d'exemple sont à 20 % du tarif officiel (uniquement pour l'exemple, ne reflétant pas les prix actuels des modèles), alors :
```text
输入费用 = $0.006 × 0.2 = $0.0012
输出费用 = $0.012 × 0.2 = $0.0024
缓存费用 = $0.005625 + $0.009 = $0.014625
合计 = $0.018225
```
On ne peut pas multiplier directement le coût total officiel par la remise d'entrée/sortie, car la partie cache n'est pas remisée.
Si le cache n'est pas touché pour la même requête, ces 30 000 tokens seront calculés au prix d'entrée remisé du modèle. Pour déterminer si des économies sont réalisées, il faut comparer en tenant compte de la remise du modèle, du coût d'écriture du cache et du nombre de lectures répétées, et non uniquement du tarif officiel. La configuration et la méthode de vérification sont décrites dans [Prompt Caching](/fr/docs/prompt-caching/).
## Facturation de l’invite système
L'API Claude provient d'un pool de comptes d'abonnement officiels. Les appels via Claude Code n'ajoutent aucun contenu supplémentaire. Les autres clients (SDK, curl et outils tiers) ajoutent à chaque requête une invite système facturée en tokens d'entrée : environ 350 tokens pour Sonnet 4.6, environ 500 tokens pour la série 5.x. Cette portion est comptée avec le contenu que vous envoyez vous-même dans le `input_tokens` de la réponse `usage`.
Mesures réelles le 2026-10-15 avec curl en envoyant « Reply with just: ok » :
| Modèle | Comptage `count_tokens` | `input_tokens` réel | Invite système jointe (approximatif) |
|---|---|---|---|
| Sonnet 4.6 | 19 | 370 | 350 tokens |
| Série 5.x | 18–19 | 510–530 | environ 500 tokens |
- `count_tokens` ne compte que le contenu que vous envoyez, sans cette invite système. Lorsque vous estimez un coût avec le SDK, curl ou un outil tiers, ajoutez les chiffres du tableau ci-dessus ; ce n'est pas nécessaire avec Claude Code.
- Les tokens d'entrée enregistrés dans le journal d'appels incluent déjà cette portion ; en recalculant avec la formule ci-dessus, le résultat correspond à la facturation du journal.
- Plus la requête est courte, plus cette portion pèse lourd ; dans les requêtes à long contexte, elle est très faible.
## Solde et devise
- La facturation est calculée selon l'algorithme en dollars ci-dessus et déduite du solde de votre compte. Le solde est exprimé en dollars.
- Le principal de la recharge est crédité en dollars ; les frais de traitement des paiements sont indiqués séparément et non remboursés ; les moyens de paiement disponibles et les limites de montant sont indiqués sur la page de commande du portefeuille.
## Comment vérifier les remises et les coûts
Vérifiez d'abord la remise d'entrée/sortie du modèle, puis calculez séparément l'entrée, la sortie, la lecture de cache et l'écriture de cache. Chaque facturation peut être recalculée dans le [journal d'appels](/fr/docs/usage-logs/) avec le prix unitaire correspondant.
## Questions fréquentes
La cause la plus fréquente est un cache non touché : les deux requêtes sont trop espacées (cache par défaut de 5 minutes), le début du contexte a changé, ou le modèle a été changé. Ouvrez le journal d'appels et comparez les tokens de lecture de cache des deux entrées pour le voir.
Non. Les lectures et écritures de cache sont facturées au tarif officiel ; les entrées et sorties sont facturées avec la remise de chaque modèle.
Les appels via Claude Code n'ajoutent aucun contenu supplémentaire. Les autres clients (SDK, curl et outils tiers) ajoutent à chaque requête une invite système facturée en tokens d'entrée : environ 350 tokens pour Sonnet 4.6, environ 500 tokens pour la série 5.x. Les mesures réelles sont dans [Facturation de l'invite système](#section-3).
Trouvez cette entrée dans le journal d'appels, reportez les quatre types de tokens et les prix unitaires de la page des tarifs dans la formule ci-dessus ; le résultat doit correspondre à la facturation du journal. Si ce n'est pas le cas, envoyez-nous l'heure et le modèle de cette entrée de journal.
---
# Journal d'utilisation et rapprochement
Source: https://1zheai.com/fr/docs/usage-logs/
Markdown: https://1zheai.com/fr/docs/usage-logs.md
---
title: "Journal d'utilisation et rapprochement"
description: "Consultez dans les journaux d'appels de la console 1折AI le modèle, les quatre types de tokens et les frais de chaque appel, et recalculez un compte selon la formule."
headingIds: {"Où consulter":"section-1","Contenu de chaque log":"section-2","Faire le rapprochement d’un compte":"section-3","Utiliser le journal pour évaluer l’effet du cache":"section-4","Ne correspond pas à vos propres statistiques":"section-5"}
---
Chaque appel laisse une ligne de détail dans le journal des appels. Cette page explique comment la consulter et comment faire le rapprochement.
## Où consulter
[Console](https://1zheai.com/console?lng=fr) menu de gauche → « Journal des appels » (adresse `https://1zheai.com/usage-logs`), le titre de la page est « Journal général ».
En haut, vous pouvez filtrer par plage de temps ; après avoir cliqué sur « Développer », vous pouvez aussi filtrer par nom de modèle, nom de clé API (« Nom du jeton »), ID de requête et type de log. Une fois les filtres définis, cliquez sur « Rechercher » ; « Exporter » télécharge les résultats filtrés actuels pour faciliter le rapprochement dans un tableur.
## Contenu de chaque log
| Colonne | Contenu |
|---|---|
| Heure | Moment où la requête a eu lieu |
| Jeton | Nom de la clé API utilisée pour cet appel |
| Modèle | ID du modèle réellement appelé |
| Flux | « Flux » ou « Non flux », ainsi que la vitesse de sortie (t/s) |
| Token | La première ligne indique les tokens « entrée / sortie » ; en cas de cache, une ligne supplémentaire apparaît en dessous, avec « Cache↓ » suivi des tokens de lecture de cache, puis « ↑ » suivi des tokens d'écriture de cache |
| Frais | Montant en dollars débité pour cet appel |
| Durée | Durée totale ; les requêtes en flux affichent aussi le temps du premier caractère |
| Détails | Détails tels que le tarif unitaire de cet appel |
Les requêtes rejetées par la passerelle (clé API invalide, solde insuffisant, modèle mal orthographié, etc.) ne sont pas facturées. Les requêtes renvoyant une erreur en amont ont des frais de 0. Une requête en flux interrompue en cours de route n'est pas entièrement gratuite, voir [Sortie en flux](/fr/docs/streaming/).
## Faire le rapprochement d’un compte
Repérez dans le temps et par modèle la ligne à vérifier, et notez les quatre valeurs de la colonne Token : entrée, sortie, lecture de cache (Cache↓) et écriture de cache (↑).
Sur la [page des tarifs](https://1zheai.com/en/pricing/), trouvez les tarifs unitaires d'entrée, de sortie, de lecture de cache et d'écriture de cache du modèle (entrée et sortie déjà calculées avec la remise du modèle, cache au tarif officiel d'origine).
```text
扣费 = ( 输入 × 输入单价
+ 缓存写入 × 缓存写单价
+ 缓存读取 × 缓存读单价
+ 输出 × 输出单价 ) ÷ 1,000,000
```
Le résultat devrait correspondre aux frais débités dans le journal. L'arrondi peut entraîner une différence sur le dernier chiffre.
En cas de discrepancy, envoyez-nous l'heure, le modèle et une capture d'écran de ce log.
## Utiliser le journal pour évaluer l’effet du cache
Dans des outils comme Claude Code, la majeure partie de l'entrée devrait tomber dans la colonne « lecture de cache ». Si plusieurs lignes consécutives affichent beaucoup d'« écriture de cache » mais très peu de « lecture de cache », cela signifie que le cache n'est pas réutilisé ; les causes et les correctifs sont dans [Prompt Caching](/fr/docs/prompt-caching/).
Un taux de succès approximatif : lecture de cache ÷ (entrée + écriture de cache + lecture de cache).
## Ne correspond pas à vos propres statistiques
- Claude Code utilise des modèles de niveau Haiku pour certaines petites tâches d'arrière-plan ; des modèles que vous n'avez pas choisis peuvent donc apparaître dans le journal. Voir la correspondance des modèles dans [Intégration de Claude Code](/fr/docs/quickstart-claude-code/).
- Les tokens d'entrée dans le journal dépassent votre contenu envoyé de quelques centaines : lors d'appels via SDK, curl ou outils tiers, chaque requête inclut un segment d'invite système facturé comme entrée (Claude Code n'en inclut pas), voir [Facturation de l'invite système](/fr/docs/pricing-explained/#section-3).
- Une « conversation » dans un outil peut correspondre à de nombreux appels API (un tour par appel d'outil) ; le journal enregistre par appel API.
---
# Recharges, remboursements et factures
Source: https://1zheai.com/fr/docs/billing/
Markdown: https://1zheai.com/fr/docs/billing.md
---
title: "Recharges, remboursements et factures"
description: "Comment recharger sur 1折AI, montant minimum, moyens de paiement acceptés, règles de remboursement des fonds non utilisés sous 7 jours, et types de factures disponibles selon le moyen de paiement."
headingIds: {"Recharge":"section-1","Remboursement du solde API":"section-2","Factures":"section-3","Questions fréquentes":"section-4"}
---
Cette page explique le solde du compte API : rechargez d'abord, puis les frais sont déduits selon l'usage lors des appels. Les comptes IA s'achètent selon les spécifications du produit ; pour le service après-vente, voir [la boutique de comptes ](https://1zheai.com/en/store/), les règles de remboursement du solde API de cette page ne s'y appliquent pas.
Les règles de remboursement du solde de cet article s'appliquent aux recharges sur l'API de modèle. Pour les commandes de comptes prêts à l’emploi, de recharges par tiers et de cartes cadeaux, consultez [les règles de transaction et de service après-vente de la boutique ](/fr/docs/store-rules/), la règle des 7 jours de l'API ne s'y applique pas directement.
## Recharge
| Élément | Description |
|---|---|
| Limites de montant | Se référer à la page de commande du portefeuille |
| Moyens de paiement | WeChat Pay, Alipay, Stripe (carte bancaire), USDT |
| Accès | [Console ](https://1zheai.com/console?lng=fr) menu de gauche « Portefeuille » → « Ajouter des fonds » |
| Comment les frais sont déduits | Entrées/sorties de Claude selon la remise du modèle, mise en cache au tarif officiel ; autres modèles selon le tarif correspondant, voir [Prix et facturation ](/fr/docs/pricing-explained/) |
Le principal de la recharge est crédité en dollars ; les frais de traitement du paiement sont facturés séparément et non remboursables.
## Remboursement du solde API
**Dans les 7 jours suivant la recharge, vous pouvez demander le remboursement du principal non utilisé par le moyen de paiement d'origine. La partie déjà consommée et les frais de traitement du paiement ne sont pas remboursés.**
Consultez la consommation depuis cette recharge dans les journaux d'appels ; le montant de référence est le principal non utilisé et remboursable indiqué dans le portefeuille ; les frais de traitement du paiement ne sont pas inclus dans le principal remboursable.
Envoyez un e-mail à support@1zheai.com en indiquant le compte, l'heure de recharge et le moyen de paiement.
Pour une première utilisation, rechargez d'abord le montant autorisé par le portefeuille, puis exécutez l'ensemble des vérifications selon [vérifier les modèles et l'usage ](/fr/docs/verify-model/), et utilisez-le pendant quelques jours sur vos tâches réelles. Dans les 7 jours, vous pouvez demander le remboursement du principal non utilisé par le moyen de paiement d'origine ; les frais de traitement du paiement ne sont pas remboursés.
## Factures
| Moyen de paiement | Facture disponible |
|---|---|
| WeChat Pay / Alipay | Facture disponible, supplément de 6 % du montant payé |
| Stripe (carte bancaire) | Facture Stripe (en anglais) |
| USDT | Aucune facture fournie |
Pour les factures, les achats d'entreprise et les virements bancaires, contactez par e-mail support@1zheai.com.
## Questions fréquentes
Les limites de montant sont celles de la page de commande du portefeuille. Avant de payer, vérifiez le principal de la recharge, les frais de traitement du paiement et le montant crédité.
Lorsque le solde est épuisé, la requête renvoie HTTP 403, avec `Insufficient user quota` dans la réponse (`error.type` vaut `billing_error` sur `/v1/messages`, et `insufficient_quota` sur `/v1/chat/completions`). Les requêtes refusées ne sont pas facturées ; après la recharge créditée, vous pouvez continuer à les utiliser.
Les appels via Claude Code n'accompagnent aucun contenu supplémentaire. Les autres clients (SDK, curl et outils tiers) ajoutent à chaque requête un message système facturé en tokens d'entrée : environ 350 tokens pour Sonnet 4.6, environ 500 tokens pour la série 5.x. Explications et données de mesure dans [facturation du message système ](/fr/docs/pricing-explained/#section-3).
La règle de remboursement du solde API couvre le principal non utilisé dans les 7 jours suivant la recharge ; la partie déjà consommée et les frais de traitement du paiement ne sont pas remboursés. Pour les situations au-delà de 7 jours, contactez-nous séparément pour nous les exposer.
---
# Vérifier le modèle et l'utilisation
Source: https://1zheai.com/fr/docs/verify-model/
Markdown: https://1zheai.com/fr/docs/verify-model.md
---
title: "Vérifier le modèle et l'utilisation"
description: "Vérifiez le modèle, l'utilisation des tokens et les frais de chaque appel à l'aide du journal d'appels et de cinq contrôles."
headingIds: {"Journal d’appels":"section-1","Cinq contrôles":"section-2","Réaliser les quatre premiers contrôles avec un script":"section-3","Blocs thinking":"section-4","En cas d’incohérence":"section-5","Questions fréquentes":"section-6"}
---
## Journal d’appels
Chaque appel est enregistré dans le [journal d'appels](/fr/docs/usage-logs/) de la console, qui liste le modèle, l'utilisation des tokens en entrée, en sortie, en lecture de cache et en écriture de cache, ainsi que les frais.
## Cinq contrôles
Les contrôles suivants comparent le format public de l'interface Anthropic afin de détecter les différences dans les champs et le format des réponses.
| Contrôle | Résultat attendu | Points de vigilance |
|---|---|---|
| 1. Champ `model` renvoyé | Identique à l'ID du modèle demandé | Un autre nom de modèle est renvoyé, ou le champ est absent |
| 2. Lecture de cache | La même requête satisfaisant les conditions de cache est envoyée deux fois dans la durée de validité du cache ; le `cache_read_input_tokens` de la seconde est supérieur à 0 | Toujours à 0, ou aucun champ de cache dans `usage` |
| 3. ID d'appel d'outil | Le `id` du bloc `tool_use` commence par `toolu_` | Autre format, ou le modèle n'appelle pas l'outil comme demandé |
| 4. Ordre des événements en streaming | Apparition dans l'ordre de `message_start`, `content_block_start`, `content_block_delta`, `message_delta` et `message_stop` | Seulement des blocs `data:` au format OpenAI, ou événements manquants, ordre incorrect |
| 5. Comparaison sur une tâche réelle | Comparer les résultats d'une tâche fixe avec l'API officielle ou une autre source fiable | Résultats nettement dégradés, refus anormaux ou troncatures fréquentes |
Ces contrôles ne permettent de détecter que des différences de champs et de format ; ils ne peuvent pas confirmer à eux seuls le modèle réellement utilisé. Le champ `model` peut être falsifié et le format peut être imité.
## Réaliser les quatre premiers contrôles avec un script
Nécessite `bash`, `curl` et `jq`. Le script effectue cinq petits appels, dont un avec une écriture d'environ 18 000 tokens en cache, facturée au tarif normal.
```bash title="verify.sh"
#!/usr/bin/env bash
# 用法：ONEZHE_API_KEY=sk-你的API密钥 bash verify.sh [模型ID]
set -euo pipefail
BASE="https://1zheai.com"
MODEL="${1:-claude-sonnet-5-5}"
H=(-H "x-api-key: $ONEZHE_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json")
echo "== 1. model 字段"
curl -s "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:16,messages:[{role:"user",content:"ping"}]}')" \
| jq 'if .error then .error else {id, model, usage} end'
echo "== 2. 缓存：同一请求发两次，看第二次的 cache_read_input_tokens"
LONG=$(printf '这是一段用来测试缓存的固定文本，内容不重要，长度够就行。%.0s' {1..600})
BODY=$(jq -n --arg m "$MODEL" --arg t "$LONG" '{model:$m,max_tokens:16,
system:[{type:"text",text:$t,cache_control:{type:"ephemeral"}}],
messages:[{role:"user",content:"ping"}]}')
for i in 1 2; do
curl -s "$BASE/v1/messages" "${H[@]}" -d "$BODY" | jq -c 'if .error then .error else .usage end'
done
echo "== 3. 工具调用 ID"
curl -s "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:256,
tools:[{name:"get_weather",description:"查询城市天气",
input_schema:{type:"object",properties:{city:{type:"string"}},required:["city"]}}],
tool_choice:{type:"auto"},
messages:[{role:"user",content:"北京今天天气怎么样"}]}')" \
| jq -r 'if .error then .error.message else (.content[]? | select(.type=="tool_use") | .id) end'
echo "== 4. 流式事件序列"
curl -sN "$BASE/v1/messages" "${H[@]}" \
-d "$(jq -n --arg m "$MODEL" '{model:$m,max_tokens:32,stream:true,messages:[{role:"user",content:"数到三"}]}')" \
| grep '^event:' | uniq
```
Le contrôle n° 3 utilise `tool_choice: auto`. Les modèles 5.x comme Sonnet 5.5 ne prennent pas en charge la spécification forcée d'un outil (`{"type":"tool"}` ou `{"type":"any"}`) et renvoient une erreur 400 `does not support forced tool_choice`.
Sortie obtenue le 2026-10-15 avec `claude-sonnet-5-5` (le contrôle n° 1 ne conserve que les champs clés) :
```text
== 1. model 字段
{
"id": "msg_011Cg3Esh8zeEdLeXAPVALKe",
"model": "claude-sonnet-5-5",
"usage": {
"input_tokens": 518,
"cache_creation_input_tokens": 0,
"cache_read_input_tokens": 0,
"output_tokens": 12,
...
}
}
== 2. 缓存：同一请求发两次，看第二次的 cache_read_input_tokens
{"input_tokens":23,"cache_creation_input_tokens":17920,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":17920,"ephemeral_1h_input_tokens":0},"output_tokens":4,"output_tokens_details":{"thinking_tokens":0},"service_tier":"standard","inference_geo":"global"}
{"input_tokens":23,"cache_creation_input_tokens":0,"cache_read_input_tokens":17920,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":0},"output_tokens":4,"output_tokens_details":{"thinking_tokens":0},"service_tier":"standard","inference_geo":"global"}
== 3. 工具调用 ID
toolu_01UPsdyKX8M9fJTTkDoSKHXA
== 4. 流式事件序列
event: message_start
event: content_block_start
event: ping
event: content_block_delta
event: content_block_stop
event: message_delta
event: message_stop
```
L'apparition de l'événement `ping` et sa position ne sont pas fixes et n'affectent pas le jugement.
## Blocs thinking
Lorsque thinking est activé, le bloc `thinking` renvoyé comporte le champ `signature`, qui peut également servir de contrôle de format. La syntaxe des modèles 5.x diffère de celle des 4.x ; testé le 2026-10-15 :
| Modèle | Paramètre `thinking` | Résultat |
|---|---|---|
| `claude-sonnet-4-6` | `{"type":"enabled","budget_tokens":1024}` | Renvoie un bloc `thinking` avec le texte de réflexion et `signature` |
| `claude-sonnet-5` | `{"type":"enabled","budget_tokens":1024}` ou `{"type":"adaptive"}` | Les deux fonctionnent |
| `claude-sonnet-5-5` | `{"type":"adaptive"}` | Fonctionne ; envoyer `enabled` renvoie 400, indiquant que seul adaptive est pris en charge |
Par défaut, le bloc `thinking` des modèles 5.x ne contient que `signature`, le texte de réflexion étant une chaîne vide. Pour afficher le résumé de réflexion, ajoutez `"display": "summarized"` :
```json
"thinking": {"type": "adaptive", "display": "summarized"}
```
Lors de l'utilisation d'un site de détection tiers, il est recommandé de créer une clé API dédiée puis de la supprimer après le test.
## En cas d’incohérence
Envoyez un e-mail à support@1zheai.com en indiquant l'heure de la requête, l'ID du modèle, le contenu complet de la réponse (sans la clé API) et le contrôle correspondant. Le request id présent dans la réponse ou le message d'erreur peut aider à localiser cet appel.
## Questions fréquentes
Peu fiable. L'auto-présentation du modèle est influencée par le prompt système et, sous certains prompts, il peut se tromper sur sa propre version. Vérifier les champs renvoyés et le format des événements est plus pertinent.
Claude Code utilise le modèle Haiku pour traiter certaines tâches d'arrière-plan ; des enregistrements correspondants apparaissent dans le journal d'appels. Vous pouvez spécifier le modèle utilisé pour ces tâches avec la variable d'environnement `ANTHROPIC_DEFAULT_HAIKU_MODEL`, voir [Intégration de Claude Code](/fr/docs/quickstart-claude-code/). Si ce cas se produit sans utiliser Claude Code, envoyez l'heure de la requête à support@1zheai.com.
---
# Codes d'erreur et dépannage
Source: https://1zheai.com/fr/docs/troubleshooting/
Markdown: https://1zheai.com/fr/docs/troubleshooting.md
---
title: "Codes d'erreur et dépannage"
description: "Causes et solutions lors de l'appel à 1折AI avec des erreurs 401, 404, 429, 529, 5xx, des délais d'attente et des erreurs Claude Code."
headingIds: {"Ordre de dépannage":"section-1","Table de référence des codes d’erreur":"section-2","Réponses réelles testées":"section-3","Dépannage par symptôme":"section-4","401 / Invalid token":"section-5","404 / Invalid URL":"section-6","403 / error code: 1010":"section-7","429 Trop de requêtes":"section-8","529 / overloaded_error":"section-9","Délais d’attente, interruption en cours de streaming":"section-10","Claude Code : ouverture directe de l’écran de connexion":"section-11","Claude Code : Extra inputs are not permitted / context_management renvoie 400":"section-12","Solde suffisant mais échec de l’appel":"section-13","Limitation des tentatives et modèle de retour":"section-14","Toujours pas résolu":"section-15"}
---
Parcourez d'abord la liste ci-dessous dans l'ordre, la plupart des problèmes se trouvent dans les trois premières étapes.
## Ordre de dépannage
1. **Adresse** : pour les outils de type Anthropic, renseignez `https://1zheai.com` ; pour ceux de type OpenAI, renseignez `https://1zheai.com/v1`. Voir [Base URL et authentification](/fr/docs/base-url/).
2. **Clé API (API key)** : est-elle complète (sans espaces ou retours à la ligne supplémentaires), a-t-elle été supprimée, est-elle saisie dans le bon champ ?
3. **Solde** : le solde dans la console est-il suffisant ?
4. **ID de modèle** : est-il exactement identique à celui des [modèles pris en charge](/fr/docs/models/) ?
5. **Réseau** : désactivez le proxy et réessayez en connexion directe.
6. **Toujours pas** : fournissez une reproduction curl minimale (voir ci-dessous) avec la réponse et le délai.
```bash title="最小复现"
curl -i https://1zheai.com/v1/messages \
-H "x-api-key: sk-你的Key" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'
```
`-i` affiche également les codes de statut et les en-têtes de réponse, ce qui est très utile pour le dépannage.
## Table de référence des codes d’erreur
| Code de statut | Cause courante | Que faire |
|---|---|---|
| 400 | Problème dans le corps de la requête : nom de paramètre incorrect, type de champ incorrect, `max_tokens` dépasse la limite du modèle, champ beta non reconnu par l'amont | Vérifiez le champ indiqué dans `message` ; pour Claude Code, voir « Extra inputs are not permitted » ci-dessous |
| 401 | Clé API invalide, supprimée, désactivée, expirée, quota personnel épuisé, ou absente/mal placée dans l'en-tête | Toutes les réponses sont `Invalid token`, vérifiez chaque point ; pour Anthropic natif, utilisez `x-api-key` ou `Authorization: Bearer` |
| 403 | Solde du compte insuffisant (`billing_error` / `insufficient_quota`) ; cette clé API n'a pas accès à ce modèle ; l'IP de la requête n'est pas dans la liste blanche de cette clé API (tous `permission_error`) | Rechargez, ou modifiez les restrictions de modèle et la liste blanche IP de cette clé API sur la page « Clés API » |
| 404 | Chemin incorrect, ou modèle inexistant / actuellement indisponible | Vérifiez l'adresse avec `Invalid URL` ; vérifiez l'ID de modèle et la liste disponible avec `not_found_error` / `model_not_found` |
| 413 | Corps de requête trop volumineux | Réduisez le contenu envoyé en une fois, divisez les gros fichiers |
| 429 | Limitation temporaire de débit côté amont. Actuellement, nous n'appliquons pas de limite de débit aux clés API | Réessayez plus tard, ajoutez un backoff exponentiel aux tâches par lot |
| 503 | Le modèle existe mais aucun service amont sain n'est disponible pour l'instant, ou panne temporaire du service | Réessayez plus tard ; en cas d'échec persistant, contactez le support avec l'ID de requête |
| 500 / 502 | Panne temporaire de la passerelle ou de l'amont | Réessayez plus tard ; si cela persiste, envoyez un e-mail à support@1zheai.com |
| 504 | Délai d'attente de la requête dépassé | Utilisez le streaming pour les sorties longues ; augmentez le délai d'attente du client |
| 529 | Surcharge de l'amont Anthropic (`overloaded_error`) | Attendez quelques secondes et réessayez, ou changez temporairement de modèle |
Le sens complet des types d'erreur officiels Anthropic (`invalid_request_error`, `authentication_error`, `rate_limit_error`, `overloaded_error`, etc.) est documenté dans la [documentation officielle Errors](https://platform.claude.com/docs/en/api/errors).
Les erreurs renvoyées par l'amont sont transmises telles quelles avec leur code de statut et `message`, et `message` ajoute en fin le request id de cette requête. Lors du passage par `/v1/messages`, la structure externe est la structure officielle `{"type":"error","error":{...}}`, `error.type` est rempli avec le type officiel selon le code de statut ; lors du passage par `/v1/chat/completions`, il s'agit de la structure OpenAI `{"error":{...}}`.
## Réponses réelles testées
Voici les réponses réelles obtenues lors d'un test le 2026-10-15 sur `/v1/messages`. Lors du passage par `/v1/chat/completions`, le contenu est identique, sans `"type":"error"` à l'extérieur, et `error` contient en plus un champ `code`.
```json title="401 API 密钥无效、禁用、过期或额度用完"
{"error":{"message":"Invalid token (request id: 202610150244355244812608268d9d6T1pY7T84)","type":"authentication_error"},"type":"error"}
```
```json title="403 账户余额不足"
{"error":{"type":"billing_error","message":"Insufficient user quota, remaining quota: ＄0.000000 (request id: 202610150244418753787808268d9d67YNhvwXd)"},"type":"error"}
```
```json title="403 API 密钥没开通该模型"
{"error":{"message":"This token has no access to model claude-sonnet-4-6 (request id: 202610150244377127013108268d9d6yCiFOxJA)","type":"permission_error"},"type":"error"}
```
```json title="403 IP 不在白名单"
{"error":{"message":"Your IP address is not on this token's allowlist (request id: 202610150244409011371208268d9d63tJvd5GD)","type":"permission_error"},"type":"error"}
```
```json title="400 上游参数错误"
{"error":{"type":"invalid_request_error","message":"messages: Unexpected role \"robot\". Allowed roles are \"user\", \"assistant\" or \"system\" (request id: 202610150245008404167198268d9d6sajV9TX3)"},"type":"error"}
```
```json title="404 路径不存在"
{"error":{"message":"Invalid URL (POST /v1/nonexistent)","type":"invalid_request_error","param":"","code":""}}
```
L'explication du 404 lorsque le modèle est inexistant ou indisponible est donnée dans [modèles pris en charge](/fr/docs/models/). Le request id dans la réponse correspond à cette requête précise ; joignez-le lors d'un signalement de problème.
## Dépannage par symptôme
### 401 / Invalid token
- La clé API a été copiée avec des espaces ou retours à la ligne supplémentaires ; recopiez-la.
- La clé API a été supprimée ou désactivée dans la console, ou elle a expiré / son quota est épuisé. Dans tous ces cas, la réponse est la même phrase `Invalid token`.
- Dans Claude Code, `ANTHROPIC_API_KEY` et `ANTHROPIC_AUTH_TOKEN` sont tous deux définis, et l'un des deux est une ancienne valeur : ne gardez qu'un seul, `ANTHROPIC_AUTH_TOKEN` est recommandé.
- `env` de `settings.json` écrase la variable du même nom exportée dans le terminal ; si la modification de la variable du terminal n'a aucun effet, vérifiez `~/.claude/settings.json`.
### 404 / Invalid URL
Vérifiez d'abord le type d'erreur : `not_found_error` ou `model_not_found` nécessitent de vérifier [l'ID de modèle et la liste disponible](/fr/docs/models/). Pour `Invalid URL`, vérifiez `/v1` : OpenAI SDK, Cursor, Cline (OpenAI Compatible) doivent être renseignés dans `https://1zheai.com/v1` ; Claude Code et l'SDK Anthropic ne renseignent que `https://1zheai.com`, renseigner `/v1` donnera `/v1/v1/messages`.
### 403 / error code: 1010
Si la réponse ne contient que la ligne `error code: 1010` sans JSON, la requête a été bloquée avant d'atteindre la passerelle. On sait actuellement que cela se produit avec les requêtes envoyées directement via la bibliothèque standard Python `urllib` (son User-Agent par défaut est `Python-urllib/3.x`). Ajoutez votre propre `User-Agent` dans les en-têtes, ou utilisez l'SDK officiel, `requests`, `httpx`.
### 429 Trop de requêtes
Actuellement, aucune limite de débit n'est appliquée aux clés API. La réception d'un 429 est généralement due à une charge élevée côté amont ; réessayez plus tard. Pour les tâches par lot, ajoutez un backoff exponentiel : après un échec, attendez un certain temps avant de réessayer, doublez la durée d'attente à chaque fois, et contrôlez la concurrence avec votre propre file d'attente.
### 529 / overloaded_error
L'amont Anthropic est temporairement en surcharge, sans rapport avec votre clé API ou votre solde. Attendez quelques secondes et réessayez ; si vous êtes pressé, changez temporairement pour un autre modèle de la même série.
### Délais d’attente, interruption en cours de streaming
- Pour les réponses longues, utilisez autant que possible le streaming (`"stream": true`), moins susceptible d'être coupé par les équipements réseau intermédiaires.
- Claude Code permet d'augmenter le délai d'attente avec `API_TIMEOUT_MS`, par défaut 600000 (10 minutes).
- Si un proxy est actif, désactivez-le d'abord et réessayez ; de nombreuses interruptions de flux proviennent des nœuds de proxy.
### Claude Code : ouverture directe de l’écran de connexion
Cela signifie que Claude Code n'a pas lu votre clé API. Exécutez `/status` dans Claude Code et vérifiez les lignes base URL et source des identifiants ; si elles sont vides, retournez à [Claude Code integration](/fr/docs/quickstart-claude-code/) pour vérifier les variables d'environnement ou `settings.json`.
### Claude Code : Extra inputs are not permitted / context_management renvoie 400
Claude Code inclut certains champs beta expérimentaux dans les requêtes ; un amont strict qui ne les reconnaît pas renverra 400. Définissez la variable d'environnement suivante pour les désactiver (issue de la documentation officielle LLM gateway de Claude Code) :
```bash
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
```
### Solde suffisant mais échec de l’appel
- Si seul un modèle échoue, il est peut-être temporairement indisponible, son ID est mal écrit, ou cette clé API a une restriction de modèle (403 `This token has no access to model …`).
- Si tout échoue avec un 401, vérifiez si cette clé API a un plafond de quota déjà atteint, ou si elle a expiré. Cela est visible dans les colonnes « Quota ($) » et « Expiration » de la page « Clés API ».
- Pour les autres cas, consultez le tableau des codes d'erreur ci-dessus.
## Limitation des tentatives et modèle de retour
N'utilisez pas de boucle infinie pour masquer des erreurs de configuration. Pour les délais d'attente du SDK, le nombre de tentatives automatiques et le backoff, voir [Délais d'attente et tentatives](/fr/docs/retries/).
Lorsque vous contactez le support, vous pouvez copier le modèle suivant, supprimer les clés, les en-têtes d'authentification et le contenu privé avant l'envoi :
```text
发生时间与时区：
客户端及版本：
请求方法与完整路径：
模型 ID：
HTTP 状态码：
request id（如有）：
脱敏后的错误正文：
最小请求能否复现：
是否使用代理 / 是否仅某个模型失败：
```
## Toujours pas résolu
Envoyez un e-mail à support@1zheai.com avec l'heure, l'ID de modèle, l'outil et la version utilisés, et la sortie complète de `curl -i` (sans la clé API).
---
# IA et automatisation
Source: https://1zheai.com/fr/docs/ai/
Markdown: https://1zheai.com/fr/docs/ai.md
---
title: "IA et automatisation"
description: "Permettre à un assistant IA de lire la documentation à la demande, et connaître l'état des points d'accès machine existants et du MCP de documentation."
headingIds: {"Points d’accès machine disponibles":"section-1","Tâches d’intégration à confier à l’IA":"section-2","État du MCP de documentation":"section-3"}
---
Vous pouvez demander à un assistant IA de lire d'abord la documentation de ce site, puis l'aider à configurer des outils ou à écrire du code d'appel. La lecture ordinaire de la documentation et l'appel de l'API du modèle sont deux choses distinctes : lire la documentation publique ne nécessite pas de fournir de clé API.
## Points d’accès machine disponibles
| Point d'accès | Usage |
| --- | --- |
| [llms.txt](/fr/docs/llms.txt) | Découvrir la documentation par rubrique, sélectionner les pages à lire |
| [Liste de la documentation](/fr/docs/docs-manifest.json) | Obtenir le titre des pages, leur rubrique, ainsi que les adresses web et Markdown |
| [Texte complet de la documentation](/fr/docs/llms-full.txt) | Lire toutes les pages en une fois ; le contenu est long, privilégier la lecture page par page |
| [Markdown de la page d'accueil](/fr/docs/index.md) | Lire le contenu source de la documentation sans la navigation du site |
Chaque article possède une adresse Markdown correspondante, par exemple `/fr/docs/quickstart-claude-code/` correspond à `/fr/docs/quickstart-claude-code.md`. Vous pouvez également utiliser « Copier cette page » en haut de la page. Le Markdown peut conserver des marqueurs de composants de documentation tels que des cartes.
## Tâches d’intégration à confier à l’IA
Copier les instructions de la tâche, demander à l'assistant de vérifier d'abord la portée prise en charge, puis configurer et valider.Selon l'outil, choisir le protocole, l'adresse et la configuration du modèle.
## État du MCP de documentation
Ce site ne propose actuellement pas de serveur MCP de documentation connectable. Veuillez d'abord utiliser les adresses de documentation ci-dessus, ou copier le contenu des pages pour l'assistant ; ne prenez pas l'URL de base de l'API du modèle comme adresse MCP.
L'objectif du MCP de documentation est de rechercher et lire des ressources publiques. Les opérations telles que les requêtes de compte et la gestion des clés relèvent d'une autre catégorie de capacités et ne peuvent pas être obtenues via les points d'accès de la documentation publique.
---
# Laissez l'IA vous aider à effectuer la configuration
Source: https://1zheai.com/fr/docs/agent-workflow/
Markdown: https://1zheai.com/fr/docs/agent-workflow.md
---
title: "Laissez l'IA vous aider à effectuer la configuration"
description: "Une consigne de tâche copiable qui aide une IA à lire d'abord la documentation, à vérifier les restrictions, puis à effectuer la configuration et la vérification."
headingIds: {"Copiez la consigne de tâche":"section-1","Comment juger si c’est terminé":"section-2"}
---
## Copiez la consigne de tâche
Donnez les instructions ci-dessous à un assistant IA capable de lire des pages web, et ajoutez le nom de l'outil et le système d'exploitation. Si l'assistant ne peut pas accéder au réseau, obtenez d'abord le contenu de l'article pertinent via [le point d'entrée lisible par machine](/fr/docs/ai/).
```text
请帮助我将现有工具或应用接入 1折AI。
目标工具与版本：[填写]
操作系统或编程语言：[填写]
先读取 https://1zheai.com/fr/docs/llms.txt，找到目标工具或 SDK 的文档。
再读取该页 Markdown，以及 API 参考和模型说明。
要求：
1. 先说明当前支持范围和工具配置要求。
2. 根据目标工具确定 Base URL，不要统一添加或删除 /v1。
3. 模型 ID 以当前文档和密钥可用模型列表为准，不要猜测。
4. 查看现有配置，只修改必要字段，保留其他供应商配置。
5. 使用环境变量或工具提供的凭据存储方式；不要把密钥写入源码、
对话、日志或提交记录。需要密钥时，让我在本地安全配置。
6. 执行会产生费用的测试前，说明测试内容并取得我的同意。
7. 用一次最小请求验证，再提示我在调用日志里核对记录。
8. 如果验证失败，保留脱敏的状态码与请求 ID，按排错文档处理；
不要用反复重试掩盖配置问题。
9. 最后说明修改位置、验证结果、剩余限制及恢复原配置的方法。
```
## Comment juger si c’est terminé
Effectuer la configuration ne signifie pas que l'installation est terminée. Vous devez confirmer en même temps que l'outil renvoie des résultats normalement, que le modèle réellement utilisé correspond aux attentes, et que l'enregistrement correspondant peut être trouvé dans [le journal des appels](/fr/docs/usage-logs/).
Cette page est une consigne de tâche copiable, pas un Agent Skill installé ou un service MCP. Tout assistant a toujours besoin de la capacité correspondante pour lire la documentation et manipuler la configuration locale.
---