Appels avec curl

Documentation maintenue par 1ZheAI. Sources et corrections.

Vous avez trouvé une erreur ? Contactez l’assistance en indiquant l’adresse de la page et une description. N’envoyez pas de clés API ni d’identifiants de compte.

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.

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.

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, et le principe est expliqué dans 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.