API-Aufrufe mit curl

API-Aufrufe mit curl

Nach diesem Leitfaden können Sie einen Chat-Aufruf mit curl über die Kommandozeile durchführen. Unsere API ist OpenAI-kompatibel — die vollständige Parameterdokumentation finden Sie in der OpenAI API-Referenz.

Anfrage

curl https://api.tvtapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-name",
    "messages": [
      {"role": "system", "content": "Du bist ein hilfreicher Assistent"},
      {"role": "user", "content": "Hallo"}
    ]
  }'

Drei Ersetzungen:

  1. sk-xxxxxxxx → Ihr API-Key
  2. your-model-name → ein Modellname aus dem Modell-Marktplatz
  3. Hallo → die Nachricht, die Sie senden möchten

Antwort

Im Normalfall wird JSON zurückgegeben; die Antwort des Modells steht in choices[0].message.content.

Häufige Parameter

  • temperature: Zufälligkeit — 0 am stabilsten, 1 am kreativsten
  • max_tokens: begrenzt die maximale Antwortlänge
  • stream: auf true setzen für Streaming-Ausgabe — die Antwort trifift Zeichen für Zeichen ein

Problemlösung

  • 401: falscher Key — siehe Fehlercode-Referenz.
  • 429: zu viele Anfragen — später erneut versuchen.
  • Lange keine Antwort: Netzwerk prüfen; sicherstellen, dass die Base URL https://api.tvtapi.com/v1 lautet.