Zum Inhalt sprangen
API-Playground

API-Playground

Interaktiv

Probéiert all Modell an all Endpoint am Browser mat Ärem eegene Schlëssel — Streaming-Output, Request-Inspector a generéierte Code, deen Dir direkt an Är App kënnt astécken.

Playground starten

De Playground ass eng Chat-Konsol fir d'API ënner /docs/playground. Dir schwätzt mat engem Modell, an de Playground schéckt déiselwecht Ufroen, déi Äre Code géif schécken: un een vun den dräi Endpoints, mam Modell, System-Prompt, de Parameter an den Tools, déi Dir setzt. All Ufro kann als Code an als rau Stream-Events nees gelies ginn.

Ufänken

  • E Schlëssel ginn — Wann Dir ugemellt sidd, benotzt de Playground den API-Schlëssel vun Ärem Kont a weist Äre Solde. Wann Dir net ugemellt sidd, wielt Schlëssel derbäisetzen a paste e Schlëssel: en gëtt nëmmen an dësem Tab gehalen a ni gespäichert.
  • Een Endpoint an e Modell wielen — An der Leescht uewen sinn de Schalter fir den Endpoint an de Modell-Picker. Eng nei Konversatioun fänkt op Chat Completions mat shannon-3 un.
  • Eng Message schécken — Tippt ënnen an dréckt Enter. All Äntwert gëtt Deel vun der Konversatioun, sou datt déi nächst Message se weiderféiert. Um eidele Bildschierm sinn dräi Start-Prompten an e fäerdegt Beispill fir en Tool-Ruff.

Äre Schlëssel fannt an erneiert Dir op der Säit Schlësselen & Notzung. Schlësselen & Notzung

Endpoints a Modeller

De Schalter fir den Endpoint entscheet, wéi e Ufro-Format de Playground opbaut. Dir kënnt en mëtten an enger Konversatioun änneren; d'Messagen bleiwen.

Endpoint Ufro, déi et schéckt Referenz
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses-API
Messages POST /v1/messages Anthropic-Format

De Modell-Picker lëscht op, wat GET /v1/models zréckgëtt. Et kann gesicht ginn, hält Är rezent Modeller uewen, a weist bei all Modell de Präis pro 1M Tokens, d'Kontextfënster a Marken fir Tools, Bild-Input, Reasoning a strukturéierten Output.

D'Konversatioun

  • Äntwerte stréimen an den Thread, wéi se geschriwwe ginn. D'Reasoning vum Modell gëtt an engem eegene Block gewisen, dee Dir zouklappe kënnt.
  • Ënner all Äntwert: Zäit bis zum éischten Token, Tokens pro Sekonn, vergaange Zäit, Input- an Output-Tokens mat den Deeler fir Cache a Reasoning, eng Schätzung vun de Käschte vum Tour, de Grond fir d'Enn an d'Response-ID.
  • Eng Message vun Iech kann editéiert a vun deem Punkt un nei geschéckt ginn. Eng Äntwert kann nei generéiert ginn. Eng Message kann geläscht ginn, an d'Läsche kann e puer Sekonnen laang réckgängeg gemaach ginn.
  • Stoppen oder d'Esc-Taste hält eng Äntwert un, déi gerade geschriwwe gëtt.
  • Biller ginn mam Bild-Knäppchen, duerch Paste oder duerch Dropzéie vun enger Datei ugehaangen, bei Modeller, déi Biller huelen. E Bild gëtt op 1,568 Pixel un der laanger Kant verklengert, ier et geschéckt gëtt. Eng Datei iwwer 30 MB gëtt iwwersprong.
  • De Composer an den System-Prompt weisen eng Tokenzuel. Bei den Hosted Open-Weight-Modeller ass et déi exakt Zuel aus POST /v1/tokenize. Bei deenen anere Modeller ass et eng Schätzung, markéiert mat ≈.
  • Eng Ufro, déi feelschléit, weist, wat als nächst ze maachen ass: e Schlëssel setzen, wann de Schlëssel refuséiert gouf, Crédit opluede, wann de Solde opgebraucht ass, d'Sekonnen zum Waarden no ze villen Ufroen, oder en neie Versuch no engem Serverfeeler.

Ufro-Astellungen

De Knäppchen Astellungen mécht e Panel mat sechs Tabs op. D'Astellunge gehéieren zur Konversatioun: all Konversatioun hält hir eege.

Tab Wat et enthält
System De System-Prompt vun der Konversatioun, mat all Ufro geschéckt. Fënnef Schablounen fëllen en aus, an seng Tokenzuel gëtt gewisen.
Parameter Max Output-Tokens, Temperatur, top_p, Reasoning-Effort, Stop-Sequenzen, seed, an d'Schalter fir Streaming a Websich. E Bedienelement, fir dat de gewielten Endpoint kee Feld huet, ass ausgeschalt a markéiert.
Tools Tool-Definitiounen, déi mat der Ufro geschéckt ginn: véier Presets (get_weather, read_file, run_shell, web_search) oder Är eege Definitioun als JSON, an tool_choice (auto, none, required oder ee Tool mam Numm). Wann de Modell en Tool rifft, weist den Thread de Ruff mat engem Feld fir d'Resultat. Mat Beispill-Resultater ubidden un fëllt een Klick e Beispill-Resultat an. Dir kënnt och Ären eegenen tippen a schécken, fir den Tour weiderzeféieren.
Strukturell response_format: text, json_object oder json_schema mat engem Schema-Numm an engem JSON Schema. Wann e Schema gesat ass, gëtt déi lescht Äntwert dergéint kontrolléiert a am Thread als passend oder net passend markéiert. Den Tab ass um Messages-Endpoint ausgeschalt, an eng Optioun, déi de gewielte Modell net hëlt, gëtt net ugebueden.
Code D'Ufro vun der aktueller Konversatioun als cURL-, Python-, Node- oder Go-Code, gebaut aus der Konversatioun an hiren Astellungen. De Schlëssel gëtt als YOUR_API_KEY gedréckt. De Code kann kopéiert oder an enger grousser Usiicht opgemaach ginn.
Events De leschten Tour, wéi e iwwer d'Leitung gaangen ass: all Stream-Event mat sengem Zäitofstand an engem Filter, déi zesummegesat Äntwert, d'Äntwert-Header (x-request-id, content-type, retry-after, date) an de Body vun der Ufro. Dës bleiwe gehalen, bis d'Säit nei lued.

Kontrolle vun den Agaben

Wäerter, déi Dir tippt, ginn kontrolléiert, ier eng Ufro geschéckt gëtt. E Wäert baussent dem Beräich gëtt bei sengem Feld markéiert, an d'Schécke gëtt zeréckgehalen, bis et korrigéiert ass.

Astellung Kontroll
Max Output-Tokens Eng ganz Zuel vun 1 bis zum max_output_tokens vum Modell.
Temperatur Eng Zuel vun 0 bis 2. Eidel léisst d'Feld aus der Ufro eraus.
top_p Eng Zuel vun 0 bis 1. Eidel léisst d'Feld aus der Ufro eraus.
seed Eng ganz Zuel.
Stop-Sequenzen Héchstens 4, duerch Komma getrennt.
response_format Muss eent sinn, dat de ausgewielte Modell hëlt. Eng Konversatioun, déi op e Modell ouni json_schema oder ouni response_format geréckelt gëtt, gëtt mat der Begrënnung zeréckgehalen.
Biller Gi mat enger Notiz aus der Message ewechgeholl, wann Dir op e Modell wiesselt, dee just Text hëlt.

Zwee Modeller vergläichen

Zwee Modeller vergläichen am Menü Méi füügt e zweete Modell-Picker derbäi. All Message geet dann zur selwechter Zäit un déi zwee Modeller, mat deene selwechten Astellungen, an déi zwou Äntwerte stinn niewenteneen, markéiert mat A a B. Dir kënnt eng Säit eleng nei generéieren. Wann eng Säit en Tool rifft, setzt d'Resultat, dat Dir schéckt, just déi Säit weider.

Deelen, exportéieren an importéieren

  • Deele-Link kopiéieren packt d'Konversatioun an de Link selwer, an den Deel no #. Et gëtt näischt eropgelueden. Biller, Äre Schlëssel an d'Detailer vum leschte Lef ginn erausgelooss. Wien de Link opmécht, kritt d'Konversatioun als nei an sengem eegene Playground.
  • Eng Konversatioun, déi ze laang fir e Link ass, gëtt mat enger Notiz refuséiert. Luet se amplaz als JSON erof.
  • Konversatioun JSON eroflueden späichert d'Konversatioun mat hiren Astellungen als Datei. JSON importéieren am Konversatiounspanel mécht esou eng Datei op.
  • Als cURL kopiéieren kopéiert déi aktuell Ufro als een cURL-Kommando.

Wat wou gespäichert ass

Wat Wou et gespäichert ass
Konversatiounen, gespäichert Tools, rezent Modeller, Layout vun de Panelen An dësem Browser. Si ginn net u Shannon geschéckt a begleeden Iech net op en anert Gerät.
API-Schlëssel Am Gedächtnis vum oppenen Tab. E gepaste Schlëssel ass fort, wann d'Säit nei lued oder den Tab zougeet. Wann Dir ugemellt sidd, gëtt de Schlëssel all Kéier aus Ärem Kont gelies.
Stream-Events, Header an Ufro vum leschten Tour Op der oppener Säit, bis se nei lued.
Ufroen Vun Ärem Browser mat Ärem Schlëssel un d'API geschéckt. Si ginn op Äre Solde gerechent wéi all aner API-Ufro.

Tastatur

Tasten Wat et mécht
Enter D'Message schécken.
Shift + Enter Eng nei Zeil ufänken.
Ctrl + K D'Kommando-Palette opmaachen: Endpoint oder Modell wiesselen, eng System-Schabloun setzen, eng nei Konversatioun ufänken, Streaming, Tools oder Vergläich un- an ausschalten. Op engem Mac: ⌘ K.
Esc D'Äntwert stoppen, déi gerade geschriwwe gëtt, oder op engem schmuelen Ecran en oppene Panel zoumaachen.

Playground starten