API‑Playground
InteractiefProbeer elk model en endpoint in de browser met je eigen sleutel — streaming output, request-inspector en gegenereerde code die je direct in je app kunt plakken.
De playground is een chatconsole voor de API op /docs/playground. Je praat met een model en de playground verstuurt dezelfde aanvragen als je code zou versturen: naar een van drie endpoints, met het model, de systeemprompt, de parameters en de tools die je instelt. Elke aanvraag kan worden teruggelezen als code en als ruwe streamgebeurtenissen.
Beginnen
- Geef hem een sleutel — Ben je ingelogd, dan gebruikt de playground de API-sleutel van je account en toont hij je saldo. Ben je niet ingelogd, kies dan Sleutel toevoegen en plak een sleutel: die wordt alleen in dit tabblad bewaard en nooit opgeslagen.
- Kies een endpoint en een model — De bovenbalk bevat de endpointschakelaar en de modelkiezer. Een nieuw gesprek begint op Chat Completions met
shannon-3. - Een bericht versturen — Typ hieronder en druk op Enter. Elk antwoord wordt deel van het gesprek, dus het volgende bericht zet het voort. Het lege scherm biedt drie startprompts en een kant-en-klaar voorbeeld van een toolaanroep.
Je vindt en vernieuwt je sleutel op de pagina Keys & usage. Sleutels en gebruik
Endpoints en modellen
De endpointschakelaar bepaalt welk aanvraagformaat de playground opbouwt. Je kunt hem midden in een gesprek wijzigen; de berichten blijven staan.
| Endpoint | Aanvraag die het verstuurt | Referentie |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Anthropic‑formaat |
De modelkiezer toont wat GET /v1/models teruggeeft. Je kunt erin zoeken, hij houdt je recente modellen bovenaan en toont bij elk model de prijs per 1M tokens, het contextvenster en markeringen voor tools, afbeeldingsinput, redenering en gestructureerde output.
Het gesprek
- Antwoorden stromen het gesprek in terwijl ze worden geschreven. De redenering van het model wordt getoond in een eigen blok dat je kunt inklappen.
- Onder elk antwoord: tijd tot het eerste token, tokens per seconde, verstreken tijd, input- en outputtokens met de gecachete en redeneerdelen, een schatting van de kosten van de beurt, de finish reason en de response-id.
- Een bericht van jou kan worden bewerkt en vanaf dat punt opnieuw worden verstuurd. Een antwoord kan opnieuw worden gegenereerd. Een bericht kan worden verwijderd, en de verwijdering kan enkele seconden worden ongedaan gemaakt.
- Stoppen of de Esc-toets beëindigt een antwoord dat wordt geschreven.
- Afbeeldingen voeg je toe met de afbeeldingsknop, door te plakken of door een bestand neer te zetten, voor modellen die afbeeldingen accepteren. Een afbeelding wordt voor het verzenden geschaald tot 1,568 pixels op de lange zijde. Een bestand van meer dan 30 MB wordt overgeslagen.
- De invoerbalk en de systeemprompt tonen een tokenaantal. Voor de gehoste open-weight modellen is het de exacte telling van
POST /v1/tokenize. Voor de andere modellen is het een schatting, gemarkeerd met≈. - Een mislukte aanvraag toont wat je daarna kunt doen: een sleutel instellen als de sleutel werd geweigerd, opwaarderen als het saldo op is, de seconden wachten na te veel aanvragen, of opnieuw proberen na een serverfout.
Aanvraaginstellingen
De knop Instellingen opent een paneel met zes tabbladen. Instellingen horen bij het gesprek: elk gesprek houdt zijn eigen instellingen.
| Tabblad | Wat het bevat |
|---|---|
| Systeem | De systeemprompt van het gesprek, met elke aanvraag meegestuurd. Vijf sjablonen vullen hem in, en het aantal tokens wordt getoond. |
| Parameters | Max. outputtokens, temperatuur, top_p, redeneerinspanning, stopsequenties, seed en de schakelaars voor streaming en webzoeken. Een bedieningselement waarvoor het gekozen endpoint geen veld heeft, is uitgeschakeld en gemarkeerd. |
| Tools | Tooldefinities die met de aanvraag worden meegestuurd: vier presets (get_weather, read_file, run_shell, web_search) of je eigen definitie als JSON, en tool_choice (auto, none, required of één tool op naam). Als het model een tool aanroept, toont het gesprek de aanroep met een vak voor het resultaat. Met Voorbeeldresultaten aanbieden aan vult één klik een voorbeeldresultaat in. Je kunt ook een eigen resultaat typen en het dan versturen om de beurt voort te zetten. |
| Gestructureerd | response_format: text, json_object of json_schema met een schemanaam en een JSON-schema. Als er een schema is ingesteld, wordt het laatste antwoord ertegen gecontroleerd en in het gesprek gemarkeerd als passend of niet. Het tabblad is uitgeschakeld op het Messages-endpoint, en een optie die het gekozen model niet accepteert, wordt niet aangeboden. |
| Code | De aanvraag van het huidige gesprek als cURL-, Python-, Node- of Go-code, opgebouwd uit het gesprek en de instellingen. De sleutel wordt afgedrukt als YOUR_API_KEY. De code kan worden gekopieerd of in een grote weergave worden geopend. |
| Gebeurtenissen | De laatste beurt zoals die over de lijn ging: elke streamgebeurtenis met haar tijdsverschuiving en een filter, het samengestelde antwoord, de antwoordheaders (x-request-id, content-type, retry-after, date) en de aanvraagbody. Deze blijven bewaard tot de pagina opnieuw wordt geladen. |
Invoercontroles
Waarden die je typt, worden gecontroleerd voordat een aanvraag wordt verstuurd. Een waarde buiten het bereik wordt bij het veld gemarkeerd en verzenden wordt tegengehouden tot het is opgelost.
| Instelling | Controle |
|---|---|
| Max. outputtokens | Een geheel getal van 1 tot de max_output_tokens van het model. |
| Temperatuur | Een getal van 0 tot 2. Leeg laat het veld uit de aanvraag weg. |
top_p | Een getal van 0 tot 1. Leeg laat het veld uit de aanvraag weg. |
seed | Een geheel getal. |
| Stopsequenties | Hoogstens 4, gescheiden door komma's. |
response_format | Moet een waarde zijn die het gekozen model accepteert. Een gesprek dat is verplaatst naar een model zonder json_schema of zonder response_format wordt met de reden tegengehouden. |
| Afbeeldingen | Worden uit het bericht verwijderd als je overschakelt naar een model dat alleen tekst accepteert, met een melding. |
Twee modellen vergelijken
Twee modellen vergelijken in het menu Meer voegt een tweede modelkiezer toe. Elk bericht gaat dan tegelijk naar beide modellen, met dezelfde instellingen, en de twee antwoorden staan naast elkaar, gemarkeerd met A en B. Je kunt één kant apart opnieuw laten genereren. Als één kant een tool aanroept, zet het resultaat dat je verstuurt alleen die kant voort.
Delen, exporteren en importeren
- Deellink kopiëren verpakt het gesprek in de link zelf, in het deel na
#. Er wordt niets geüpload. Afbeeldingen, je sleutel en de details van de laatste run worden weggelaten. Wie de link opent, krijgt het gesprek als nieuw gesprek in zijn eigen playground. - Een gesprek dat te lang is voor een link, wordt met een melding geweigerd. Download het in plaats daarvan als JSON.
- Gesprek downloaden als JSON slaat het gesprek met zijn instellingen op als bestand. JSON importeren in het gesprekkenpaneel opent zo'n bestand.
- Kopiëren als cURL kopieert de huidige aanvraag als één cURL-opdracht.
Wat waar wordt bewaard
| Wat | Waar het wordt bewaard |
|---|---|
| Gesprekken, opgeslagen tools, recente modellen, paneelindeling | In deze browser. Ze worden niet naar Shannon verstuurd en volgen je niet naar een ander apparaat. |
| API-sleutel | In het geheugen van het geopende tabblad. Een geplakte sleutel is weg als de pagina opnieuw wordt geladen of het tabblad sluit. Als je bent ingelogd, wordt de sleutel elke keer uit je account gelezen. |
| Streamgebeurtenissen, headers en aanvraag van de laatste beurt | In de geopende pagina, tot ze opnieuw wordt geladen. |
| Aanvragen | Vanuit je browser met je sleutel naar de API verstuurd. Ze tellen mee tegen je saldo zoals elke andere API-aanvraag. |
Toetsenbord
| Toetsen | Wat het doet |
|---|---|
Enter | Het bericht versturen. |
Shift + Enter | Een nieuwe regel beginnen. |
Ctrl + K | Het opdrachtenpalet openen: van endpoint of model wisselen, een systeemsjabloon instellen, een nieuw gesprek beginnen, streaming, tools of vergelijken in- of uitschakelen. Op een Mac: ⌘ K. |
Esc | Het antwoord stoppen dat wordt geschreven, of op een smal scherm een geopend paneel sluiten. |