curl-Aufrufe

Dokumentation gepflegt von 1ZheAI. Quellen und Korrekturen.

Fehler gefunden? Support kontaktieren mit Seitenadresse und Beschreibung. Senden Sie keine API-Schlüssel oder Kontodaten.

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 sieheSchnellstart.

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 sieheStreaming-Ausgabe.

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 sieheModelle und Verbrauch prüfen, das Prinzip siehe 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 sieheFehlercodes und Troubleshooting.