---
title: "curl-Aufrufe"
description: "Ohne SDK installieren, 1折AI über curl aufrufen: /v1/messages und /v1/chat/completions, Modellliste abfragen, Cache testen, Streaming-Ausgabe ansehen."
headingIds: {"Anthropic-nativ: /v1/messages":"section-1","OpenAI-kompatibel: /v1/chat/completions":"section-2","Modellliste: /v1/models":"section-3","Streaming-Ausgabe":"section-4","Cache testen":"section-5","-i beim Troubleshooting hinzufügen":"section-6"}
---

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

Dokumentation gepflegt von [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Quellen und Korrekturen](https://1zheai.com/en/editorial/).

Fehler gefunden? [Support kontaktieren](mailto:support@1zheai.com) mit Seitenadresse und Beschreibung. Senden Sie keine API-Schlüssel oder Kontodaten.

</aside>
curl ist die schnellste Möglichkeit, zu prüfen, ob "API-Schlüssel (API key) und Adresse" tatsächlich funktionieren. Jeder der folgenden Befehle kann direkt kopiert werden. Zuerst den API-Schlüssel in eine Umgebungsvariable setzen:

```bash
export ONEZHE_API_KEY="sk-你的Key"
```

Windows-Nutzer sollten diese Befehle in WSL oder Git Bash ausführen; die Schreibweise für PowerShell siehe[Schnellstart](/de/docs/quickstart/).

## Anthropic-nativ: /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"}]
  }'
```

## OpenAI-kompatibel: /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"}]
  }'
```

## Modellliste: /v1/models

```bash
curl https://1zheai.com/v1/models \
  -H "Authorization: Bearer $ONEZHE_API_KEY"
```

## Streaming-Ausgabe

`"stream": true` hinzufügen und mit `-N` das Puffern von curl deaktivieren, um die Abschnittsweise Rückgabe zu sehen:

```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": "从一数到五"}]
  }'
```

Das Ereignisformat siehe[Streaming-Ausgabe](/de/docs/streaming/).

## Cache testen

Dieselbe Anfrage zweimal hintereinander senden: Wenn der `usage.cache_read_input_tokens` in der zweiten Antwort größer als 0 ist, war es ein Treffer. Der Text in `system` muss die minimale cachebare Länge des Modells erreichen. Das vollständige Skript siehe[Modelle und Verbrauch prüfen](/de/docs/verify-model/), das Prinzip siehe [Prompt Caching](/de/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"}]
  }'
```

## -i beim Troubleshooting hinzufügen

```bash
curl -i https://1zheai.com/v1/models -H "Authorization: Bearer $ONEZHE_API_KEY"
```

`-i` gibt den Statuscode und die Antwortheader aus. Die Bedeutung der Statuscodes siehe[Fehlercodes und Troubleshooting](/de/docs/troubleshooting/).