---
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"}
---

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

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

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

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