API mit cURL aufrufen
Auf dieser Seite
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