---
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/).