Démarrage rapide

Créez une clé API 1zheai, appelez Claude / GPT via curl ou un SDK, puis connectez-vous à vos clients habituels.

Objectif : obtenir une clé API (API key) en 5 minutes et effectuer votre première requête Claude ou GPT.

S'inscrire et recharger
Ouvrez 1zheai.com/register 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.
Créer une clé API
Entrez dans la console, 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.
Envoyer la première requête
Placez la clé API dans une variable d’environnement, puis appelez l’interface native Anthropic avec curl :
macOS / Linux
Windows PowerShell
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"}] }'
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.

Voir la réponse

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 :

1
{
2
  "model": "claude-sonnet-5-5",
3
  "id": "msg_011Cg3G8HQmyTrnqSBX6o6Pw",
4
  "type": "message",
5
  "role": "assistant",
6
  "content": [
7
    {
8
      "type": "text",
9
      "text": "HTTP(超文本传输协议)是一种基于请求-响应模式的应用层协议,用于在客户端(如浏览器)和服务器之间传输网页、图片、API 数据等内容。"
10
    }
11
  ],
12
  "container": null,
13
  "stop_reason": "end_turn",
14
  "stop_sequence": null,
15
  "stop_details": null,
16
  "usage": {
17
    "input_tokens": 530,
18
    "cache_creation_input_tokens": 0,
19
    "cache_read_input_tokens": 0,
20
    "cache_creation": {
21
      "ephemeral_5m_input_tokens": 0,
22
      "ephemeral_1h_input_tokens": 0
23
    },
24
    "output_tokens": 69,
25
    "output_tokens_details": {"thinking_tokens": 0},
26
    "service_tier": "standard",
27
    "inference_geo": "global"
28
  },
29
  "input_transformations": [],
30
  "diagnostics": null,
31
  "context_management": {"applied_edits": []}
32
}

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.

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 :

1
curl --fail-with-body https://1zheai.com/v1/chat/completions \
2
  -H "Authorization: Bearer $ONEZHE_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -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. 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. Codex nécessite Responses ; intégrez-le selon le tutoriel de configuration Codex.

Étape suivante

Intégrez-le à vos outils habituels :

Claude Code

Deux variables d’environnement suffisent.

CC Switch

À utiliser si vous ne voulez pas modifier manuellement les fichiers de configuration.

Cursor

Syntaxe et restrictions d’une URL de base personnalisée.

OpenAI SDK

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. Pour vérifier les champs renvoyés et l’utilisation, voir Vérifier le modèle et l’utilisation.