Preskoči na vsebino
Igrišče API

Igrišče API

Interaktivno

Preizkusite vsak model in endpoint v brskalniku z lastnim ključem — pretočni izhod, pregledovalnik zahtevkov in ustvarjena koda, ki jo prilepite naravnost v svojo aplikacijo.

Odpri igrišče

Playground je konzola za klepet z API-jem na /docs/playground. Pogovarjate se z modelom, playground pa pošilja enake zahtevke kot vaša koda: na eno od treh končnih točk, z modelom, sistemskim promptom, parametri in orodji, ki jih nastavite. Vsak zahtevek je mogoče prebrati nazaj kot kodo in kot surove dogodke toka.

Začetek

  • Dajte mu ključ — Če ste prijavljeni, playground uporablja API ključ vašega računa in prikazuje vaše stanje. Če niste prijavljeni, izberite Dodaj ključ in prilepite ključ: hrani se samo v tem zavihku in se nikoli ne shrani.
  • Izberite končno točko in model — Zgornja vrstica vsebuje stikalo končne točke in izbirnik modela. Nov pogovor se začne na Chat Completions z shannon-3.
  • Pošljite sporočilo — Vnesite besedilo spodaj in pritisnite Enter. Vsak odgovor postane del pogovora, zato ga naslednje sporočilo nadaljuje. Prazen zaslon ponuja tri začetne prompte in pripravljen primer klica orodja.

Svoj ključ najdete in zamenjate na strani Ključi in poraba. Ključi in poraba

Končne točke in modeli

Stikalo končne točke določa, kateri format zahtevka playground sestavi. Spremenite ga lahko sredi pogovora; sporočila ostanejo.

Končna točka Zahtevek, ki ga pošlje Referenca
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses API Responses
Messages POST /v1/messages Format Anthropic

Izbirnik modelov navaja tisto, kar vrne GET /v1/models. Po njem je mogoče iskati, vaše nedavne modele drži na vrhu in za vsak model prikazuje ceno za 1M tokenov, kontekstno okno in oznake za orodja, vhod slik, razmišljanje in strukturiran izhod.

Pogovor

  • Odgovori se v pogovor pretakajo, ko se pišejo. Razmišljanje modela je prikazano v lastnem bloku, ki ga lahko zložite.
  • Pod vsakim odgovorom: čas do prvega tokena, tokeni na sekundo, pretečeni čas, vhodni in izhodni tokeni s predpomnjenim delom in delom za razmišljanje, ocena stroška obrata, razlog zaključka in id odgovora.
  • Vaše sporočilo je mogoče urediti in ga poslati znova od tiste točke. Odgovor je mogoče ponovno ustvariti. Sporočilo je mogoče izbrisati, izbris pa je mogoče nekaj sekund razveljaviti.
  • Ustavi ali tipka Esc konča odgovor, ki se piše.
  • Slike se priložijo z gumbom za slike, z lepljenjem ali s spustom datoteke, za modele, ki sprejemajo slike. Slika se pred pošiljanjem zmanjša na 1,568 pikslov po daljši stranici. Datoteka nad 30 MB se preskoči.
  • Polje za pisanje in sistemski prompt prikazujeta število tokenov. Pri gostovanih modelih z odprtimi utežmi je to natančno število iz POST /v1/tokenize. Pri drugih modelih je ocena, označena z ≈.
  • Neuspel zahtevek prikaže, kaj storiti naprej: nastavite ključ, če je bil ključ zavrnjen, dopolnite stanje, če je porabljeno, sekunde čakanja po preveč zahtevkih ali ponovni poskus po napaki strežnika.

Nastavitve zahtevka

Gumb Nastavitve odpre ploščo s šestimi zavihki. Nastavitve pripadajo pogovoru: vsak pogovor hrani svoje.

Zavihek Kaj vsebuje
Sistem Sistemski prompt pogovora, poslan z vsakim zahtevkom. Izpolni ga pet predlog, prikazano pa je tudi število njegovih tokenov.
Parametri Največ izhodnih tokenov, temperatura, top_p, napor razmišljanja, zaporedja za ustavitev, seed ter stikali za pretakanje in spletno iskanje. Kontrolnik, za katerega izbrana končna točka nima polja, je izklopljen in označen.
Orodja Definicije orodij, poslane z zahtevkom: štiri prednastavitve (get_weather, read_file, run_shell, web_search) ali vaša lastna definicija kot JSON ter tool_choice (auto, none, required ali eno orodje po imenu). Ko model pokliče orodje, pogovor prikaže klic s poljem za rezultat. Ko je vklopljeno Ponudi vzorčne rezultate, en klik izpolni vzorčni rezultat. Vnesete lahko tudi svojega in ga nato pošljete, da obrat nadaljujete.
Strukturirano response_format: text, json_object ali json_schema z imenom sheme in shemo JSON. Ko je shema nastavljena, se zadnji odgovor preveri glede nje in v pogovoru označi kot ustrezen ali ne. Zavihek je na končni točki Messages izklopljen, možnost, ki je izbrani model ne sprejema, pa ni ponujena.
Koda Zahtevek trenutnega pogovora kot koda cURL, Python, Node ali Go, sestavljena iz pogovora in njegovih nastavitev. Ključ je izpisan kot YOUR_API_KEY. Kodo je mogoče kopirati ali odpreti v velikem pogledu.
Dogodki Zadnji obrat, kot je šel po žici: vsak dogodek toka z zamikom časa in filtrom, sestavljen odgovor, glave odgovora (x-request-id, content-type, retry-after, date) in telo zahtevka. Hranijo se do osvežitve strani.

Preverjanje vnosa

Vrednosti, ki jih vnesete, se preverijo, preden se zahtevek pošlje. Vrednost zunaj razpona je označena pri svojem polju, pošiljanje pa je zadržano, dokler je ne popravite.

Nastavitev Preverjanje
Največ izhodnih tokenov Celo število od 1 do max_output_tokens modela.
Temperatura Število od 0 do 2. Prazno polje v zahtevku izpusti.
top_p Število od 0 do 1. Prazno polje v zahtevku izpusti.
seed Celo število.
Zaporedja za ustavitev Največ 4, ločena z vejicami.
response_format Mora biti eden od tistih, ki jih izbrani model sprejema. Pogovor, preklopljen na model brez json_schema ali brez response_format, se zadrži z navedbo razloga.
Slike Odstranjene iz sporočila, ko preklopite na model, ki sprejema samo besedilo, z opombo.

Primerjava dveh modelov

Primerjaj dva modela v meniju Več doda drugi izbirnik modela. Vsako sporočilo nato gre hkrati obema modeloma, z enakimi nastavitvami, oba odgovora pa stojita drug ob drugem, označena z A in B. Eno stran lahko ponovno ustvarite posebej. Kadar ena stran kliče orodje, rezultat, ki ga pošljete, nadaljuje samo to stran.

Deljenje, izvoz in uvoz

  • Kopiraj povezavo za deljenje pogovor zapakira v samo povezavo, v del za #. Nič se ne naloži. Slike, vaš ključ in podrobnosti zadnjega zagona so izpuščeni. Kdor odpre povezavo, dobi pogovor kot nov pogovor v svojem playgroundu.
  • Pogovor, ki je za povezavo predolg, je zavrnjen z opombo. Namesto tega ga prenesite kot JSON.
  • Prenesi JSON pogovora shrani pogovor z nastavitvami kot datoteko. Uvozi JSON na plošči pogovorov odpre tako datoteko.
  • Kopiraj kot cURL kopira trenutni zahtevek kot en ukaz cURL.

Kaj je shranjeno kje

Kaj Kje je shranjeno
Pogovori, shranjena orodja, nedavni modeli, postavitev plošč V tem brskalniku. Ne pošiljajo se Shannon in vam ne sledijo na drugo napravo.
API ključ V pomnilniku odprtega zavihka. Prilepljen ključ izgine, ko se stran osveži ali zavihek zapre. Če ste prijavljeni, se ključ vsakič prebere iz vašega računa.
Dogodki toka, glave in zahtevek zadnjega obrata V odprti strani, dokler se ne osveži.
Zahtevki Poslani iz vašega brskalnika na API z vašim ključem. Štejejo se v vaše stanje kot vsak drug zahtevek API.

Tipkovnica

Tipke Kaj počne
Enter Pošlji sporočilo.
Shift + Enter Začni novo vrstico.
Ctrl + K Odpri paleto ukazov: zamenjaj končno točko ali model, nastavi sistemsko predlogo, začni nov pogovor, preklopi pretakanje, orodja ali primerjavo. Na Macu: ⌘ K.
Esc Ustavi odgovor, ki se piše, ali zapri odprto ploščo na ozkem zaslonu.

Odpri igrišče