Hopp til innholdet
API‑lekeplass

API‑lekeplass

Interaktiv

Prøv hver modell og hvert endepunkt i nettleseren med din egen nøkkel — streaming-output, forespørselsinspektør og generert kode du kan lime rett inn i appen din.

Start Playground

Playground er en chat-konsoll for API-et på /docs/playground. Du snakker med en modell, og playground sender de samme forespørslene som koden din ville sendt: til ett av tre endepunkter, med modellen, system prompten, parameterne og verktøyene du setter. Hver forespørsel kan leses tilbake som kode og som rå strømhendelser.

Kom i gang

  • Gi den en nøkkel — Når du er innlogget, bruker playground API-nøkkelen til kontoen din og viser saldoen din. Når du ikke er innlogget, velger du Legg til nøkkel og limer inn en nøkkel: den lagres kun i denne fanen og blir aldri lagret permanent.
  • Velg et endepunkt og en modell — Den øverste linjen har endepunktbryteren og modellvelgeren. En ny samtale starter på Chat Completions med shannon-3.
  • Send en melding — Skriv nedenfor og trykk Enter. Hvert svar blir en del av samtalen, så neste melding fortsetter den. Den tomme skjermen tilbyr tre startprompter og et ferdig eksempel på verktøykall.

Du finner og bytter nøkkelen din på siden Keys & usage. Nøkler og bruk

Endepunkter og modeller

Endepunktbryteren bestemmer hvilket forespørselsformat playground bygger. Du kan bytte midt i en samtale; meldingene blir stående.

Endepunkt Forespørselen den sender Referanse
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic-format

Modellvelgeren lister det GET /v1/models returnerer. Den kan søkes i, holder de nylige modellene dine øverst, og viser for hver modell prisen per 1M tokens, kontekstvinduet og merker for verktøy, bildeinput, resonnering og strukturert utdata.

Samtalen

  • Svar strømmer inn i tråden etter hvert som de skrives. Modellens resonnering vises i en egen blokk som du kan brette sammen.
  • Under hvert svar: tid til første token, tokens per sekund, medgått tid, input- og output-tokens med de cachede og resonnerende delene, et estimat av kostnaden for runden, finish reason og respons-id-en.
  • En melding fra deg kan redigeres og sendes på nytt fra det punktet. Et svar kan genereres på nytt. En melding kan slettes, og slettingen kan angres i noen sekunder.
  • Stopp eller Esc-tasten avslutter et svar som skrives.
  • Bilder legges ved med bildeknappen, ved å lime inn eller ved å slippe en fil, for modeller som tar imot bilder. Et bilde skaleres til 1,568 piksler på den lange kanten før det sendes. En fil over 30 MB hoppes over.
  • Meldingsfeltet og system prompten viser et tokenantall. For de hostede åpne vektmodellene er det det nøyaktige tallet fra POST /v1/tokenize. For de andre modellene er det et estimat, merket med ≈.
  • En forespørsel som feiler, viser hva du bør gjøre videre: sette en nøkkel når nøkkelen ble avvist, fylle på når saldoen er brukt opp, antall sekunder å vente etter for mange forespørsler, eller et nytt forsøk etter en serverfeil.

Forespørselsinnstillinger

Knappen Innstillinger åpner et panel med seks faner. Innstillingene hører til samtalen: hver samtale beholder sine egne.

Fane Hva den inneholder
System System prompten for samtalen, sendt med hver forespørsel. Fem maler fyller den ut, og tokenantallet vises.
Parametere Maks utdata-tokens, temperatur, top_p, resonneringsinnsats, stoppsekvenser, seed, og bryterne for streaming og websøk. En kontroll som det valgte endepunktet ikke har noe felt for, er slått av og merket.
Verktøy Verktøydefinisjoner sendt med forespørselen: fire forhåndsinnstillinger (get_weather, read_file, run_shell, web_search) eller din egen definisjon som JSON, og tool_choice (auto, none, required eller ett verktøy ved navn). Når modellen kaller et verktøy, viser tråden kallet med en boks for resultatet. Med Tilby eksempelresultater på fyller ett klikk inn et eksempelresultat. Du kan også skrive ditt eget og så sende det for å fortsette runden.
Strukturert response_format: text, json_object eller json_schema med et skjemanavn og et JSON-skjema. Når et skjema er satt, kontrolleres det siste svaret mot det og markeres i tråden som samsvarende eller ikke. Fanen er slått av på Messages-endepunktet, og et valg som den valgte modellen ikke tar imot, tilbys ikke.
Kode Forespørselen i den gjeldende samtalen som cURL-, Python-, Node- eller Go-kode, bygget fra samtalen og innstillingene. Nøkkelen skrives ut som YOUR_API_KEY. Koden kan kopieres eller åpnes i en stor visning.
Hendelser Den siste runden slik den gikk over ledningen: hver strømhendelse med tidsforskyvning og et filter, det sammensatte svaret, svarheaderne (x-request-id, content-type, retry-after, date) og forespørselskroppen. Disse beholdes til siden lastes på nytt.

Kontroll av inndata

Verdiene du skriver, sjekkes før en forespørsel sendes. En verdi utenfor området markeres ved feltet, og sending holdes tilbake til den er rettet.

Innstilling Sjekk
Maks utdata-tokens Et helt tall fra 1 til max_output_tokens for modellen.
Temperatur Et tall fra 0 til 2. Tomt utelater feltet fra forespørselen.
top_p Et tall fra 0 til 1. Tomt utelater feltet fra forespørselen.
seed Et helt tall.
Stoppsekvenser Høyst 4, atskilt med komma.
response_format Må være en som den valgte modellen tar imot. En samtale som flyttes til en modell uten json_schema eller uten response_format, holdes tilbake med begrunnelse.
Bilder Fjernes fra meldingen når du bytter til en modell som bare tar imot tekst, med et notat.

Sammenlign to modeller

Sammenlign to modeller i menyen Mer legger til en andre modellvelger. Hver melding går da til begge modellene samtidig, med de samme innstillingene, og de to svarene står side ved side, merket A og B. Du kan generere én side på nytt alene. Når en side kaller et verktøy, fortsetter resultatet du sender, bare den siden.

Del, eksporter og importer

  • Kopier delingslenke pakker samtalen inn i selve lenken, i delen etter #. Ingenting lastes opp. Bilder, nøkkelen din og detaljene fra siste kjøring utelates. Den som åpner lenken, får samtalen som en ny samtale i sin egen playground.
  • En samtale som er for lang for en lenke, avvises med et notat. Last den ned som JSON i stedet.
  • Last ned samtale-JSON lagrer samtalen med innstillingene som en fil. Importer JSON i samtalepanelet åpner en slik fil.
  • Kopier som cURL kopierer den gjeldende forespørselen som én cURL-kommando.

Hva som lagres hvor

Hva Hvor den lagres
Samtaler, lagrede verktøy, nylige modeller, panelutforming I denne nettleseren. De sendes ikke til Shannon og følger deg ikke til en annen enhet.
API-nøkkel I minnet til den åpne fanen. En innlimt nøkkel er borte når siden lastes på nytt eller fanen lukkes. Når du er innlogget, leses nøkkelen fra kontoen din hver gang.
Strømhendelser, headere og forespørsel fra den siste runden På den åpne siden, til den lastes på nytt.
Forespørsler Sendes fra nettleseren din til API-et med nøkkelen din. De telles mot saldoen din som alle andre API-forespørsler.

Tastatur

Taster Hva den gjør
Enter Send meldingen.
Shift + Enter Start en ny linje.
Ctrl + K Åpne kommando-paletten: bytt endepunkt eller modell, sett en systemmal, start en ny samtale, slå av eller på streaming, verktøy eller sammenligning. På Mac: ⌘ K.
Esc Stopp svaret som skrives, eller lukk et åpent panel på en smal skjerm.

Start Playground