Zum Inhalt springen
API‑Playground

API‑Playground

Interaktiv

Probieren Sie jedes Modell und jeden Endpunkt im Browser mit Ihrem eigenen Key aus — Streaming-Ausgabe, Request-Inspector und generierter Code, den Sie direkt in Ihre App einfügen können.

Playground starten

Der Playground ist eine Chat-Konsole für die API unter /docs/playground. Sie sprechen mit einem Modell, und der Playground sendet dieselben Anfragen, die Ihr Code senden würde: an einen von drei Endpunkten, mit dem Modell, System-Prompt, den Parametern und Tools, die Sie festlegen. Jede Anfrage kann als Code und als rohe Stream-Events zurückgelesen werden.

Start

  • Einen Key angeben — Wenn Sie angemeldet sind, verwendet der Playground den API-Key Ihres Kontos und zeigt Ihr Guthaben. Wenn Sie nicht angemeldet sind, wählen Sie Key hinzufügen und fügen Sie einen Key ein: Er wird nur in diesem Tab gehalten und nie gespeichert.
  • Einen Endpunkt und ein Modell wählen — Die obere Leiste enthält den Endpunkt-Schalter und die Modellauswahl. Eine neue Konversation beginnt bei Chat Completions mit shannon-3.
  • Eine Nachricht senden — Geben Sie unten etwas ein und drücken Sie Enter. Jede Antwort wird Teil der Konversation, sodass die nächste Nachricht sie fortsetzt. Der leere Bildschirm bietet drei Start-Prompts und ein fertiges Beispiel für einen Tool-Aufruf.

Sie finden und rotieren Ihren Key auf der Seite Keys & Nutzung. Keys & Nutzung

Endpunkte und Modelle

Der Endpunkt-Schalter bestimmt, welches Anfrageformat der Playground erstellt. Sie können ihn mitten in einer Konversation ändern; die Nachrichten bleiben erhalten.

Endpunkt Anfrage, die es sendet Referenz
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic‑Format

Die Modellauswahl listet auf, was GET /v1/models zurückgibt. Sie ist durchsuchbar, hält Ihre zuletzt verwendeten Modelle oben und zeigt zu jedem Modell den Preis pro 1M Tokens, das Kontextfenster und Markierungen für Tools, Bild-Input, Reasoning und strukturierte Ausgabe.

Die Konversation

  • Antworten fließen in den Thread, während sie geschrieben werden. Das Reasoning des Modells wird in einem eigenen Block angezeigt, den Sie einklappen können.
  • Unter jeder Antwort: Zeit bis zum ersten Token, Tokens pro Sekunde, vergangene Zeit, Input- und Output-Tokens mit den Cached- und Reasoning-Anteilen, eine Schätzung der Kosten des Turns, der Finish-Grund und die Antwort-ID.
  • Eine Ihrer Nachrichten kann bearbeitet und ab diesem Punkt erneut gesendet werden. Eine Antwort kann neu generiert werden. Eine Nachricht kann gelöscht werden, und das Löschen kann einige Sekunden lang rückgängig gemacht werden.
  • Stopp oder die Esc-Taste beendet eine Antwort, die gerade geschrieben wird.
  • Bilder werden bei Modellen, die Bilder annehmen, mit der Bild-Schaltfläche, durch Einfügen oder durch Ablegen einer Datei angehängt. Ein Bild wird vor dem Senden auf 1,568 Pixel an der langen Kante skaliert. Eine Datei über 30 MB wird übersprungen.
  • Das Eingabefeld und der System-Prompt zeigen eine Token-Anzahl. Bei den gehosteten Open-Weight-Modellen ist es die exakte Zählung von POST /v1/tokenize. Bei den anderen Modellen ist es eine Schätzung, mit ≈ markiert.
  • Eine fehlgeschlagene Anfrage zeigt, was als Nächstes zu tun ist: einen Key setzen, wenn der Key abgelehnt wurde, aufladen, wenn das Guthaben aufgebraucht ist, die Sekunden, die nach zu vielen Anfragen zu warten sind, oder einen erneuten Versuch nach einem Serverfehler.

Anfrage-Einstellungen

Die Schaltfläche Einstellungen öffnet ein Panel mit sechs Tabs. Einstellungen gehören zur Konversation: Jede Konversation behält ihre eigenen.

Tab Was es enthält
System Der System-Prompt der Konversation, der mit jeder Anfrage gesendet wird. Fünf Vorlagen füllen ihn aus, und seine Token-Anzahl wird angezeigt.
Parameter Max. Output-Tokens, Temperatur, top_p, Reasoning-Aufwand, Stop-Sequenzen, seed und die Schalter für Streaming und Websuche. Ein Bedienelement, für das der gewählte Endpunkt kein Feld hat, ist ausgeschaltet und markiert.
Tools Tool-Definitionen, die mit der Anfrage gesendet werden: vier Vorlagen (get_weather, read_file, run_shell, web_search) oder Ihre eigene Definition als JSON, und tool_choice (auto, none, required oder ein Tool nach Namen). Ruft das Modell ein Tool auf, zeigt der Thread den Aufruf mit einem Feld für das Ergebnis. Bei eingeschaltetem Beispielergebnisse anbieten füllt ein Klick ein Beispielergebnis ein. Sie können auch ein eigenes eingeben und es dann senden, um den Turn fortzusetzen.
Strukturiert response_format: text, json_object oder json_schema mit einem Schema-Namen und einem JSON-Schema. Ist ein Schema gesetzt, wird die letzte Antwort dagegen geprüft und im Thread als passend oder nicht passend markiert. Der Tab ist beim Messages-Endpunkt ausgeschaltet, und eine Option, die das gewählte Modell nicht annimmt, wird nicht angeboten.
Code Die Anfrage der aktuellen Konversation als cURL-, Python-, Node- oder Go-Code, erstellt aus der Konversation und ihren Einstellungen. Der Key wird als YOUR_API_KEY ausgegeben. Der Code kann kopiert oder in einer großen Ansicht geöffnet werden.
Events Der letzte Turn, so wie er über die Leitung ging: jedes Stream-Event mit seinem Zeitversatz und einem Filter, die zusammengesetzte Antwort, die Antwort-Header (x-request-id, content-type, retry-after, date) und der Request-Body. Sie werden gehalten, bis die Seite neu geladen wird.

Eingabeprüfungen

Werte, die Sie eingeben, werden geprüft, bevor eine Anfrage gesendet wird. Ein Wert außerhalb des Bereichs wird an seinem Feld markiert, und das Senden wird zurückgehalten, bis er korrigiert ist.

Einstellung Prüfung
Max. Output-Tokens Eine ganze Zahl von 1 bis zum max_output_tokens des Modells.
Temperatur Eine Zahl von 0 bis 2. Leer lässt das Feld aus der Anfrage weg.
top_p Eine Zahl von 0 bis 1. Leer lässt das Feld aus der Anfrage weg.
seed Eine ganze Zahl.
Stop-Sequenzen Höchstens 4, durch Kommas getrennt.
response_format Muss eines sein, das das gewählte Modell annimmt. Eine Konversation, die zu einem Modell ohne json_schema oder ohne response_format gewechselt wird, wird mit der Begründung zurückgehalten.
Bilder Werden mit einem Hinweis aus der Nachricht entfernt, wenn Sie zu einem Modell wechseln, das nur Text annimmt.

Zwei Modelle vergleichen

Zwei Modelle vergleichen im Menü Mehr fügt eine zweite Modellauswahl hinzu. Jede Nachricht geht dann gleichzeitig an beide Modelle, mit denselben Einstellungen, und die beiden Antworten stehen nebeneinander, mit A und B markiert. Sie können eine Seite allein neu generieren. Ruft eine Seite ein Tool auf, setzt das Ergebnis, das Sie senden, nur diese Seite fort.

Teilen, exportieren und importieren

  • Share-Link kopieren packt die Konversation in den Link selbst, in den Teil nach #. Es wird nichts hochgeladen. Bilder, Ihr Key und die Details des letzten Laufs werden weggelassen. Wer den Link öffnet, erhält die Konversation als neue in seinem eigenen Playground.
  • Eine Konversation, die für einen Link zu lang ist, wird mit einem Hinweis abgelehnt. Laden Sie sie stattdessen als JSON herunter.
  • Konversation als JSON herunterladen speichert die Konversation mit ihren Einstellungen als Datei. JSON importieren im Konversations-Panel öffnet eine solche Datei.
  • Als cURL kopieren kopiert die aktuelle Anfrage als einen cURL-Befehl.

Was wo gespeichert wird

Was Wo es gespeichert wird
Konversationen, gespeicherte Tools, zuletzt verwendete Modelle, Panel-Layout In diesem Browser. Sie werden nicht an Shannon gesendet und folgen Ihnen nicht auf ein anderes Gerät.
API-Key Im Speicher des geöffneten Tabs. Ein eingefügter Key ist weg, wenn die Seite neu geladen oder der Tab geschlossen wird. Wenn Sie angemeldet sind, wird der Key jedes Mal aus Ihrem Konto gelesen.
Stream-Events, Header und Anfrage des letzten Turns In der geöffneten Seite, bis sie neu geladen wird.
Anfragen Von Ihrem Browser mit Ihrem Key an die API gesendet. Sie werden wie jede andere API-Anfrage auf Ihr Guthaben angerechnet.

Tastatur

Tasten Was es tut
Enter Die Nachricht senden.
Shift + Enter Eine neue Zeile beginnen.
Ctrl + K Die Befehlspalette öffnen: Endpunkt oder Modell wechseln, eine System-Vorlage setzen, eine neue Konversation beginnen, Streaming, Tools oder Vergleich umschalten. Auf einem Mac: ⌘ K.
Esc Die Antwort stoppen, die gerade geschrieben wird, oder auf einem schmalen Bildschirm ein geöffnetes Panel schließen.

Playground starten