Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

API mit cURL aufrufen

Lektion 8 von 14 Aktualisiert am 30. Juli 2026 Entwickler
Auf dieser Seite
  1. Das universelle Werkzeug zum Testen von APIs
  2. Ihre erste cURL-Anfrage
  3. Nutzung des Endpunkts /v1/responses
  4. Nützliche cURL-Optionen
  5. Körper aus einer Datei lesen
  6. Debuggen häufiger Fehler
  7. Kernaussagen

Das universelle Werkzeug zum Testen von APIs

cURL ist ein Befehlszeilen-Tool, das auf jedem Betriebssystem verfügbar ist. Es ermöglicht das Senden von HTTP-Anfragen, ohne dass eine SDK-Installation oder das Schreiben eines Programms erforderlich ist. Es ist das ideale Werkzeug, um Endpunkte schnell zu testen, Anfragen zu debuggen oder Aufrufe in einem Shell-Skript zu automatisieren.

Ihre erste cURL-Anfrage

So senden Sie eine Anfrage an die Grok-API mit cURL:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "messages": [
      {"role": "user", "content": "Hello, introduce yourself in one sentence."}
    ]
  }'

Analyse des Befehls

  • curl https://api.x.ai/v1/chat/completions: sendet eine POST-Anfrage (impliziert durch -d) an den Endpunkt
  • -H "Authorization: Bearer $XAI_API_KEY": fügt den Authentifizierungs-Header mit Ihrem Schlüssel hinzu
  • -H "Content-Type: application/json": gibt an, dass der Körper JSON ist
  • -d '{...}': der Anfragekörper im JSON-Format

Nutzung des Endpunkts /v1/responses

Der moderne Endpunkt /v1/responses bietet eine prägnantere Syntax:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Explain machine learning to me in simple terms."
  }'

Beachten Sie, dass input messages für einfache Anfragen ersetzt. Sie können einen String direkt übergeben, anstatt ein Array von Nachrichten.

Nützliche cURL-Optionen

Formatierung der JSON-Ausgabe

Die rohe Antwort ist schwer lesbar. Verwenden Sie jq, um sie zu formatieren:

curl -s https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-4.5", "input": "Hello"}' | jq .

Die Option -s (silent) verbirgt den Fortschrittsbalken von cURL.

Extrahieren nur der Antwort

Um den Text der Antwort ohne Metadaten zu erhalten:

curl -s https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "messages": [{"role": "user", "content": "Hello"}]
  }' | jq -r '.choices[0].message.content'

Einsehen der Antwort-Header

Um Quotenlimits oder Fehler zu debuggen, fügen Sie -i hinzu, um die HTTP-Header anzuzeigen:

curl -i https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "grok-4.5", "input": "Test"}'

Körper aus einer Datei lesen

Für komplexe Anfragen speichern Sie das JSON in einer Datei:

# request.json
{
  "model": "grok-4.5",
  "messages": [
    {"role": "system", "content": "You are a translator."},
    {"role": "user", "content": "Translate into French: Hello world"}
  ],
  "temperature": 0.3
}

Verweisen Sie darauf dann mit @:

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Debuggen häufiger Fehler

  • 401 Unauthorized: ungültiger oder fehlender API-Schlüssel. Prüfen Sie echo $XAI_API_KEY
  • 400 Bad Request: fehlerhaftes JSON. Validieren Sie Ihr JSON mit jq . < request.json
  • 429 Too Many Requests: Sie haben das Quotenlimit erreicht. Warten Sie ein paar Sekunden
  • 404 Not Found: überprüfen Sie die URL und den Endpunkt-Pfad

Kernaussagen

  • cURL ist perfekt zum Testen und Debuggen ohne Code-Schreiben
  • Authentifizieren Sie sich mit -H "Authorization: Bearer $XAI_API_KEY"
  • Verwenden Sie jq, um JSON-Antworten zu formatieren und zu filtern
  • Speichern Sie komplexe Anfragen in separaten JSON-Dateien