Gå til indhold
API‑Playground

API‑Playground

Interaktiv

Prøv alle modeller og endpoints i browseren med din egen nøgle — streamet output, anmodningsinspektør og genereret kode, du kan indsætte direkte i din app.

Start Playground

Playgrounden er en chatkonsol til API'et på /docs/playground. Du taler med en model, og playgrounden sender de samme anmodninger, som din kode ville sende: til et af tre endpoints, med den model, systemprompt, de parametre og de værktøjer, du har indstillet. Hver anmodning kan læses tilbage som kode og som rå stream-hændelser.

Kom i gang

  • Giv den en nøgle — Når du er logget ind, bruger playgrounden din kontos API-nøgle og viser din saldo. Er du ikke logget ind, så vælg Tilføj nøgle og indsæt en nøgle: den opbevares kun i denne fane og gemmes aldrig.
  • Vælg et endpoint og en model — Topbjælken indeholder endpoint-kontakten og modelvælgeren. En ny samtale starter på Chat Completions med shannon-3.
  • Send en besked — Skriv nedenfor, og tryk på Enter. Hvert svar indgår i samtalen, så den næste besked fortsætter den. Den tomme skærm tilbyder tre startprompts og et færdigt eksempel på et værktøjskald.

Du finder og roterer din nøgle på siden Nøgler og forbrug. Nøgler og forbrug

Endpoints og modeller

Endpoint-kontakten bestemmer, hvilket anmodningsformat playgrounden bygger. Du kan skifte midt i en samtale; beskederne bliver.

Endpoint Anmodning, den sender Reference
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic-format

Modelvælgeren viser det, GET /v1/models returnerer. Den kan søges i, holder dine seneste modeller øverst og viser for hver model prisen per 1M tokens, kontekstvinduet og mærker for værktøjer, billedinput, ræsonnement og struktureret output.

Samtalen

  • Svar streames ind i tråden, mens de skrives. Modellens ræsonnement vises i en blok for sig, som du kan folde sammen.
  • Under hvert svar: tid til første token, tokens per sekund, forløbet tid, input- og output-tokens med de cachede og ræsonnerende dele, et skøn over turens omkostninger, afslutningsårsagen og svar-id'et.
  • En besked fra dig kan redigeres og sendes igen fra det punkt. Et svar kan genereres igen. En besked kan slettes, og sletningen kan fortrydes i nogle få sekunder.
  • Stop eller Esc-tasten afslutter et svar, der skrives.
  • Billeder vedhæftes med billedknappen, ved at indsætte eller ved at slippe en fil, for modeller der tager billeder. Et billede skaleres til 1,568 pixel på den lange kant, før det sendes. En fil over 30 MB springes over.
  • Skrivefeltet og systemprompten viser et antal tokens. For de hostede open-weight-modeller er det den nøjagtige tælling fra POST /v1/tokenize. For de andre modeller er det et skøn, markeret med ≈.
  • En mislykket anmodning viser, hvad du skal gøre bagefter: indstil en nøgle, når nøglen blev afvist, opfyld kredit, når saldoen er brugt, de sekunder, du skal vente efter for mange anmodninger, eller et nyt forsøg efter en serverfejl.

Indstillinger for anmodning

Knappen Indstillinger åbner et panel med seks faner. Indstillinger hører til samtalen: hver samtale beholder sine egne.

Fane Hvad den indeholder
System Samtalens systemprompt, sendt med hver anmodning. Fem skabeloner udfylder den, og dens antal tokens vises.
Parametre Maks output tokens, temperatur, top_p, ræsonnementsindsats, stopsekvenser, seed og kontakterne for streaming og websøgning. En kontrol, som det valgte endpoint ikke har noget felt til, er slået fra og markeret.
Værktøjer Værktøjsdefinitioner sendt med anmodningen: fire forudindstillinger (get_weather, read_file, run_shell, web_search) eller din egen definition som JSON, og tool_choice (auto, none, required eller ét værktøj ved navn). Når modellen kalder et værktøj, viser tråden kaldet med en boks til resultatet. Med Tilbyd eksempelresultater slået til udfylder ét klik et eksempelresultat. Du kan også skrive dit eget og derefter sende det for at fortsætte turen.
Struktureret response_format: text, json_object eller json_schema med et skemanavn og et JSON-skema. Når et skema er sat, kontrolleres det sidste svar mod det og markeres i tråden som matchende eller ikke. Fanen er slået fra på Messages-endpointet, og en mulighed, den valgte model ikke tager, tilbydes ikke.
Kode Den aktuelle samtales anmodning som cURL-, Python-, Node- eller Go-kode, bygget ud fra samtalen og dens indstillinger. Nøglen udskrives som YOUR_API_KEY. Koden kan kopieres eller åbnes i en stor visning.
Hændelser Den seneste tur, som den gik over ledningen: hver stream-hændelse med sit tidsforskud og et filter, det samlede svar, svarets headers (x-request-id, content-type, retry-after, date) og anmodningens body. De opbevares, til siden genindlæses.

Kontrol af input

Værdier, du skriver, kontrolleres, før en anmodning sendes. En værdi uden for intervallet markeres ved sit felt, og afsendelsen standses, til den er rettet.

Indstilling Kontrol
Maks output tokens Et helt tal fra 1 til modellens max_output_tokens.
Temperatur Et tal fra 0 til 2. Tomt udelader feltet fra anmodningen.
top_p Et tal fra 0 til 1. Tomt udelader feltet fra anmodningen.
seed Et helt tal.
Stopsekvenser Højst 4, adskilt af kommaer.
response_format Skal være et, den valgte model tager. En samtale, der flyttes til en model uden json_schema eller uden response_format, standses med begrundelsen.
Billeder Fjernes fra beskeden, når du skifter til en model, der kun tager tekst, med en note.

Sammenlign to modeller

Sammenlign to modeller i menuen Mere tilføjer en ekstra modelvælger. Hver besked går så til begge modeller på samme tid med de samme indstillinger, og de to svar står side om side, markeret A og B. Du kan generere den ene side igen alene. Når den ene side kalder et værktøj, fortsætter det resultat, du sender, kun den side.

Del, eksportér og importér

  • Kopier delingslink pakker samtalen ind i selve linket, i delen efter #. Intet uploades. Billeder, din nøgle og detaljerne fra den seneste kørsel udelades. Den, der åbner linket, får samtalen som en ny i sin egen playground.
  • En samtale, der er for lang til et link, afvises med en note. Download den som JSON i stedet.
  • Download samtale som JSON gemmer samtalen med dens indstillinger som en fil. Importér JSON i samtalepanelet åbner sådan en fil.
  • Kopier som cURL kopierer den aktuelle anmodning som én cURL-kommando.

Hvad der opbevares hvor

Hvad Hvor den opbevares
Samtaler, gemte værktøjer, seneste modeller, panelopsætning I denne browser. De sendes ikke til Shannon og følger ikke med til en anden enhed.
API-nøgle I den åbne fanes hukommelse. En indsat nøgle er væk, når siden genindlæses, eller fanen lukkes. Når du er logget ind, læses nøglen fra din konto hver gang.
Stream-hændelser, headers og anmodning fra den seneste tur På den åbne side, til den genindlæses.
Anmodninger Sendt fra din browser til API'et med din nøgle. De tælles mod din saldo som enhver anden API-anmodning.

Tastatur

Taster Hvad den gør
Enter Send beskeden.
Shift + Enter Start en ny linje.
Ctrl + K Åbn kommando-paletten: skift endpoint eller model, vælg en systemskabelon, start en ny samtale, skift streaming, værktøjer eller sammenligning. På en Mac: ⌘ K.
Esc Stop det svar, der skrives, eller luk et åbent panel på en smal skærm.

Start Playground