Hoppa till innehållet
API‑Playground

API‑Playground

Interaktiv

Testa varje modell och endpoint i webbläsaren med din egen nyckel — streamad utdata, begäransinspektör och genererad kod som du kan klistra rakt in i din app.

Starta Playground

Playground är en chattkonsol för API:et på /docs/playground. Du pratar med en modell, och playground skickar samma begäranden som din kod skulle skicka: till en av tre endpoints, med den modell, systemprompt, de parametrar och verktyg som du ställt in. Varje begäran kan läsas tillbaka som kod och som råa strömhändelser.

Kom igång

  • Ange en nyckel — När du är inloggad använder playground ditt kontos API-nyckel och visar din balans. Om du inte är inloggad väljer du Lägg till nyckel och klistrar in en nyckel: den sparas bara i den här fliken och sparas aldrig permanent.
  • Välj en endpoint och en modell — Det övre fältet innehåller endpoint-växeln och modellväljaren. En ny konversation startar på Chat Completions med shannon-3.
  • Skicka ett meddelande — Skriv nedan och tryck på Enter. Varje svar blir en del av konversationen, så nästa meddelande fortsätter den. Den tomma skärmen erbjuder tre startprompter och ett färdigt exempel på verktygsanrop.

Du hittar och byter din nyckel på sidan Nycklar och användning. Nycklar och användning

Endpoints och modeller

Endpoint-växeln bestämmer vilket begäranformat playground bygger. Du kan ändra den mitt i en konversation; meddelandena finns kvar.

Endpoint Begäran den skickar Referens
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic‑format

Modellväljaren listar det som GET /v1/models returnerar. Den går att söka i, håller dina senaste modeller överst och visar för varje modell priset per 1M tokens, kontextfönstret och markeringar för verktyg, bildinput, resonemang och strukturerad output.

Konversationen

  • Svaren strömmar in i tråden medan de skrivs. Modellens resonemang visas i ett eget block som du kan fälla ihop.
  • Under varje svar: tid till första token, tokens per sekund, förfluten tid, input- och outputtokens med de cachade och resonerande delarna, en uppskattning av vändningens kostnad, avslutsorsaken och svars-id:t.
  • Ett meddelande från dig kan redigeras och skickas igen från den punkten. Ett svar kan genereras om. Ett meddelande kan tas bort, och borttagningen kan ångras i några sekunder.
  • Stopp eller Esc-tangenten avslutar ett svar som skrivs.
  • Bilder bifogas med bildknappen, genom att klistra in eller genom att släppa en fil, för modeller som tar bilder. En bild skalas till 1,568 pixlar på den långa kanten innan den skickas. En fil över 30 MB hoppas över.
  • Meddelandefältet och systemprompten visar ett tokenantal. För de hostade open-weight-modellerna är det det exakta antalet från POST /v1/tokenize. För de andra modellerna är det en uppskattning, markerad med ≈.
  • En misslyckad begäran visar vad du ska göra härnäst: ange en nyckel när nyckeln avvisades, fyll på när balansen är förbrukad, hur många sekunder du ska vänta efter för många begäranden, eller försök igen efter ett serverfel.

Begäraninställningar

Knappen Inställningar öppnar en panel med sex flikar. Inställningarna hör till konversationen: varje konversation har sina egna.

Flik Vad den innehåller
System Konversationens systemprompt, som skickas med varje begäran. Fem mallar fyller i den, och dess tokenantal visas.
Parametrar Max outputtokens, temperatur, top_p, resonemangsnivå, stoppsekvenser, seed, samt knapparna för streaming och webbsökning. En kontroll som den valda endpointen saknar fält för är avstängd och markerad.
Verktyg Verktygsdefinitioner som skickas med begäran: fyra förinställningar (get_weather, read_file, run_shell, web_search) eller din egen definition som JSON, samt tool_choice (auto, none, required eller ett verktyg efter namn). När modellen anropar ett verktyg visar tråden anropet med en ruta för resultatet. Med Erbjud exempelresultat påslaget fyller ett klick i ett exempelresultat. Du kan också skriva ett eget och sedan skicka det för att fortsätta vändningen.
Strukturerad response_format: text, json_object eller json_schema med ett schemanamn och ett JSON-schema. När ett schema är angivet kontrolleras det sista svaret mot det och markeras i tråden som matchande eller inte. Fliken är avstängd på Messages-endpointen, och ett alternativ som den valda modellen inte tar erbjuds inte.
Kod Den aktuella konversationens begäran som cURL-, Python-, Node- eller Go-kod, byggd från konversationen och dess inställningar. Nyckeln skrivs ut som YOUR_API_KEY. Koden kan kopieras eller öppnas i en stor vy.
Händelser Den senaste vändningen så som den gick över nätet: varje strömhändelse med sin tidsförskjutning och ett filter, det hopsatta svaret, svarsheadrarna (x-request-id, content-type, retry-after, date) och begäranbodyn. Dessa sparas tills sidan laddas om.

Inputkontroller

Värden du skriver kontrolleras innan en begäran skickas. Ett värde utanför intervallet markeras vid sitt fält, och sändningen hålls tillbaka tills det är rättat.

Inställning Kontroll
Max outputtokens Ett heltal från 1 till modellens max_output_tokens.
Temperatur Ett tal från 0 till 2. Tomt lämnar fältet utanför begäran.
top_p Ett tal från 0 till 1. Tomt lämnar fältet utanför begäran.
seed Ett heltal.
Stoppsekvenser Högst 4, åtskilda med kommatecken.
response_format Måste vara ett som den valda modellen tar. En konversation som flyttats till en modell utan json_schema eller utan response_format hålls tillbaka med en anledning.
Bilder Tas bort från meddelandet när du byter till en modell som bara tar text, med en notering.

Jämför två modeller

Jämför två modeller i menyn Mer lägger till en andra modellväljare. Varje meddelande går då till båda modellerna samtidigt, med samma inställningar, och de två svaren står sida vid sida, markerade A och B. Du kan generera om en sida för sig. När en sida anropar ett verktyg fortsätter det resultat du skickar bara den sidan.

Dela, exportera och importera

  • Kopiera delningslänk packar konversationen i själva länken, i delen efter #. Ingenting laddas upp. Bilder, din nyckel och uppgifterna om den senaste körningen utelämnas. Den som öppnar länken får konversationen som en ny i sin egen playground.
  • En konversation som är för lång för en länk avvisas med en notering. Ladda ned den som JSON i stället.
  • Ladda ner konversation JSON sparar konversationen med dess inställningar som en fil. Importera JSON i konversationspanelen öppnar en sådan fil.
  • Kopiera som cURL kopierar den aktuella begäran som ett cURL-kommando.

Vad som sparas var

Vad Var den sparas
Konversationer, sparade verktyg, senaste modeller, panelens layout I den här webbläsaren. De skickas inte till Shannon och följer inte med till en annan enhet.
API-nyckel I den öppna flikens minne. En inklistrad nyckel försvinner när sidan laddas om eller fliken stängs. När du är inloggad läses nyckeln från ditt konto varje gång.
Strömhändelser, headers och begäran från den senaste vändningen På den öppna sidan, tills den laddas om.
Begäranden Skickas från din webbläsare till API:et med din nyckel. De räknas mot din balans som vilken annan API-begäran som helst.

Tangentbord

Tangenter Vad den gör
Enter Skicka meddelandet.
Shift + Enter Börja en ny rad.
Ctrl + K Öppna kommandopaletten: byt endpoint eller modell, ange en systemmall, starta en ny konversation, slå på eller av streaming, verktyg eller jämförelse. På en Mac: ⌘ K.
Esc Stoppa svaret som skrivs, eller stäng en öppen panel på en smal skärm.

Starta Playground