Docs · curl

curl: die LLM API vom Terminal aus

Q: Wie vergleiche ich zwei Modelle schnell?

Führen Sie dieselbe Datei zweimal aus und ändern Sie nur model, zum Beispiel deepseek-v4-pro und gpt-oss-120b; die Zeilen usage zeigen, was jede Antwort an Tokens gekostet hat.

Jeder Aufruf ist reines HTTPS mit einem JSON-Body, also reicht curl, um einen API-Schlüssel zu testen, zwei Modelle zu vergleichen oder einen schnellen Job zu skripten. jq macht das JSON lesbar; beides ist auf den meisten Systemen dabei oder mit einem Befehl installiert.

Zuletzt aktualisiert: 23. Oktober 2026 · 3 Min. Lesezeit

Kurze Antwort

Wie rufe ich LLMwithCrypto mit curl auf?

Senden Sie ein POST an https://llmwithcrypto.com/api/v1/chat/completions mit -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY", einem JSON-Content-Type und einem Body mit model und messages. LLMwithCrypto gibt das OpenAI-Response-Objekt zurück; leiten Sie es an jq weiter, um die Antwort und die Token-Zahlen auszugeben. Fügen Sie -N und "stream": true hinzu, um den Text live ankommen zu sehen, wie am 23. Oktober 2026 dokumentiert.

Wie setze ich den API-Schlüssel einmal?

Exportieren Sie ihn in Ihrer Shell-Sitzung, damit jeder Befehl ihn nutzen kann, und halten Sie ihn aus Ihrer Shell-History und aus geteilten Skripten heraus:

Linux und macOS: export LLMWITHCRYPTO_API_KEY=… im Terminal oder in einer .env-Datei, die Ihre Skripte laden und die nie committet wird.
Windows PowerShell: $env:LLMWITHCRYPTO_API_KEY = "…", dann führen Sie die Befehle in Git Bash oder WSL aus oder passen Sie das Quoting an.

Legen Sie einen API-Schlüssel pro App, Agent oder Teammitglied an und widerrufen Sie jeden davon im Dashboard, ohne die anderen zu berühren.

Eine kurze Antwort und ihre Token-Zahlen

curl -s "https://llmwithcrypto.com/api/v1/chat/completions" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-oss-20b", "messages": [{"role": "user", "content": "One word for fast?"}], "max_tokens": 20}' \
  | jq -r '.choices[0].message.content, "\(.usage.prompt_tokens) in, \(.usage.completion_tokens) out"'

Wie vermeide ich Quoting-Probleme?

Legen Sie den Body in eine Datei. Shell-Quotes und JSON-Quotes bekämpfen sich, sobald ein Prompt ein Apostroph oder ein Dollarzeichen enthält; eine Datei vermeidet beides. --data @request.json sendet die Datei unverändert.

Eine Anfrage aus einer Datei

cat > request.json <<'EOF'
{
  "model": "deepseek-v4-pro",
  "messages": [
    {"role": "system", "content": "You review shell scripts."},
    {"role": "user", "content": "Is it safe to run rm -rf \"$DIR\"/ when DIR may be empty?"}
  ],
  "max_tokens": 300
}
EOF
curl -s "https://llmwithcrypto.com/api/v1/chat/completions" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY" \
  -H "Content-Type: application/json" \
  --data @request.json | jq -r '.choices[0].message.content'

Wie sehe ich eine gestreamte Antwort?

-N schaltet den Ausgabepuffer von curl ab, sodass jedes Server-Sent Event sofort ausgegeben wird, sobald es eintrifft. Sie sehen dann rohe data:-Zeilen; die Streaming-Seite erklärt sie.

Gestreamte Antwort, rohe Events

curl -sN "https://llmwithcrypto.com/api/v1/chat/completions" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "Write a haiku about latency."}],
    "stream": true,
    "stream_options": {"include_usage": true},
    "max_tokens": 120
  }'

Wie liste ich die Modelle auf und prüfe das Guthaben?

Beide Aufrufe sind kostenlos. Der erste gibt eine Modell-ID pro Zeile aus, direkt geeignet für das Feld model; der zweite gibt das verbleibende Guthaben in US-Dollar aus.

Modell-IDs

curl -s "https://llmwithcrypto.com/api/v1/models" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY" | jq -r '.data[].id'

Verbleibendes Guthaben

curl -s "https://llmwithcrypto.com/api/v1/credits" \
  -H "Authorization: Bearer $LLMWITHCRYPTO_API_KEY" | jq -r '.balance_usd'

Wie sehe ich einen Fehler im Terminal?

Fügen Sie -w "\nHTTP %{http_code}\n" hinzu, um den Status nach dem Body auszugeben. Ein Fehler-Body ist ein kleines JSON-Objekt mit einem Feld code, etwa invalid_api_key, insufficient_balance oder model_not_found; die Fehlerseite erklärt jeden einzelnen. Mit jq gibt .error.code // empty den Code aus, wenn einer vorhanden ist, und sonst nichts, was Skripten die Verzweigung erleichtert.

Fehler kosten nichts. Sie zahlen pro Token aus Ihrem Guthaben: Input- und Output-Tokens werden mit dem eigenen Tokenizer des Modells gezählt und zum Preis des Modells pro 1M Tokens berechnet. Ein Aufruf, der mit einem Fehler endet, kostet nichts.

Kann ich mit curl einen Batch skripten?

Für eine Handvoll Anfragen ist eine Shell-Schleife über Dateien in Ordnung: ein JSON-Body pro Datei, ein curl pro Datei, Ergebnisse daneben geschrieben. Halten Sie es sequenziell oder führen Sie mit xargs -P 4 einige gleichzeitig aus, damit Sie unter Ihrem rate limit bleiben. Jedes Konto hat ein Anfrage- und Token-Limit pro Minute, das im Dashboard angezeigt wird; fragen Sie den Support, dann kann es erhöht werden.

Für alles Größere sind Retries und Nebenläufigkeit im Code einfacher: die Seiten Python und Node.js enthalten fertige Batch-Beispiele mit einer Obergrenze für die Nebenläufigkeit.

curl: häufige Fragen

Warum erhalte ich einen 401-Fehler?

Der Schlüssel fehlt, ist falsch geschrieben oder wurde widerrufen, oder die Variable ist in dieser Shell nicht gesetzt. Führen Sie echo ${#LLMWITHCRYPTO_API_KEY} aus, um zu prüfen, dass sie nicht leer ist.

Wie vergleiche ich zwei Modelle schnell?

Führen Sie dieselbe Datei zweimal aus und ändern Sie nur model, zum Beispiel deepseek-v4-pro und gpt-oss-120b; die Zeilen usage zeigen, was jede Antwort an Tokens gekostet hat.

Wird mein Prompt gespeichert?

Nein. Wir speichern Ihre Prompts und die Antworten der Modelle nicht: Sobald eine Antwort gesendet ist, ist ihr Text weg. Jeder Aufruf hinterlässt eine Logzeile mit Zeit, Konto, Modell und Token-Anzahl, die nach 30 Tagen gelöscht wird.