Pāriet uz saturu
API spēļlaukums

API spēļlaukums

Interaktīvs

Izmēģiniet katru modeli un galapunktu pārlūkā ar savu atslēgu — straumēta izvade, pieprasījumu inspektors un ģenerēts kods, ko varat ielīmēt tieši savā lietotnē.

Palaist rotaļu laukumu

Playground ir API čata konsole adresē /docs/playground. Jūs runājat ar modeli, un playground sūta tos pašus pieprasījumus, ko sūtītu jūsu kods: uz vienu no trim galapunktiem ar modeli, sistēmas uzvedni, parametriem un rīkiem, ko iestatāt. Katru pieprasījumu var pārlasīt kā kodu un kā neapstrādātus straumes notikumus.

Sākums

  • Norādiet atslēgu — Pierakstījies playground izmanto jūsu konta API atslēgu un rāda jūsu atlikumu. Ja neesat pierakstījies, izvēlieties Pievienot atslēgu un ielīmējiet atslēgu: tā tiek glabāta tikai šajā cilnē un nekad netiek saglabāta.
  • Izvēlieties galapunktu un modeli — Augšējā joslā ir galapunkta slēdzis un modeļa izvēle. Jauna saruna sākas ar Chat Completions un shannon-3.
  • Nosūtiet ziņojumu — Rakstiet zemāk un nospiediet Enter. Katra atbilde pievienojas sarunai, tāpēc nākamais ziņojums to turpina. Tukšais ekrāns piedāvā trīs sākuma uzvednes un gatavu rīka izsaukuma piemēru.

Savu atslēgu atradīsiet un nomainīsiet lapā Atslēgas un izmantošana. Atslēgas un izmantošana

Galapunkti un modeļi

Galapunkta slēdzis nosaka, kādu pieprasījuma formātu playground veido. To var mainīt sarunas vidū; ziņojumi paliek.

Galapunkts Pieprasījums, ko tas sūta Atsauce
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic

Modeļa izvēle uzskaita to, ko atgriež GET /v1/models. To var meklēt, tā patur jūsu nesenos modeļus augšā un katram modelim rāda cenu par 1M tokenu, konteksta logu un atzīmes rīkiem, attēlu ievadei, spriešanai un strukturētai izvadei.

Saruna

  • Atbildes straumējas sarunā, kamēr tiek rakstītas. Modeļa spriešana tiek rādīta savā blokā, ko var sakļaut.
  • Zem katras atbildes: laiks līdz pirmajam tokenam, tokeni sekundē, pagājušais laiks, ievades un izvades tokeni ar kešētajām un spriešanas daļām, gājiena izmaksu novērtējums, beigu iemesls un atbildes id.
  • Savu ziņojumu var rediģēt un nosūtīt vēlreiz no šī punkta. Atbildi var ģenerēt atkārtoti. Ziņojumu var dzēst, un dzēšanu dažas sekundes var atcelt.
  • Apturēt vai taustiņš Esc beidz atbildi, kas tiek rakstīta.
  • Attēlus pievieno ar attēla pogu, ielīmējot vai ievelkot failu, modeļiem, kas pieņem attēlus. Pirms nosūtīšanas attēls tiek samazināts līdz 1,568 pikseļiem pa garāko malu. Fails, kas lielāks par 30 MB, tiek izlaists.
  • Ziņojuma lodziņš un sistēmas uzvedne rāda tokenu skaitu. Hostētajiem atvērto svaru modeļiem tas ir precīzs skaits no POST /v1/tokenize. Pārējiem modeļiem tas ir novērtējums, atzīmēts ar ≈.
  • Neizdevies pieprasījums parāda, ko darīt tālāk: iestatīt atslēgu, ja atslēga tika noraidīta, papildināt, ja atlikums ir izlietots, sekundes, cik gaidīt pēc pārāk daudziem pieprasījumiem, vai atkārtot pēc servera kļūdas.

Pieprasījuma iestatījumi

Poga Iestatījumi atver paneli ar sešām cilnēm. Iestatījumi pieder sarunai: katra saruna patur savus.

Cilne Ko tas satur
Sistēma Sarunas sistēmas uzvedne, kas tiek sūtīta ar katru pieprasījumu. To var aizpildīt ar vienu no piecām veidnēm, un tiek rādīts tās tokenu skaits.
Parametri Maksimālie izvades tokeni, temperatūra, top_p, spriešanas piepūle, apturēšanas secības, seed un slēdži straumēšanai un tīmekļa meklēšanai. Vadīklu, kurai izvēlētajam galapunktam nav lauka, izslēdz un atzīmē.
Rīki Rīku definīcijas, kas tiek sūtītas ar pieprasījumu: četras sagataves (get_weather, read_file, run_shell, web_search) vai jūsu pašu definīcija kā JSON, un tool_choice (auto, none, required vai viens rīks pēc nosaukuma). Kad modelis izsauc rīku, sarunā redzams izsaukums ar lodziņu rezultātam. Ar ieslēgtu Piedāvāt parauga rezultātus viens klikšķis ieraksta parauga rezultātu. Varat arī ierakstīt savu un nosūtīt to, lai turpinātu gājienu.
Strukturēts response_format: text, json_object vai json_schema ar shēmas nosaukumu un JSON shēmu. Ja shēma ir iestatīta, pēdējā atbilde tiek pārbaudīta pret to un sarunā atzīmēta kā atbilstoša vai neatbilstoša. Galapunktā Messages cilne ir izslēgta, un opcija, ko izvēlētais modelis nepieņem, netiek piedāvāta.
Kods Pašreizējās sarunas pieprasījums kā cURL, Python, Node vai Go kods, veidots no sarunas un tās iestatījumiem. Atslēga tiek izdrukāta kā YOUR_API_KEY. Kodu var nokopēt vai atvērt lielā skatā.
Notikumi Pēdējais gājiens tā, kā tas gāja pa vadu: katrs straumes notikums ar laika nobīdi un filtru, salikta atbilde, atbildes galvenes (x-request-id, content-type, retry-after, date) un pieprasījuma pamatteksts. Tie tiek glabāti, līdz lapa tiek pārlādēta.

Ievades pārbaudes

Jūsu ievadītās vērtības tiek pārbaudītas pirms pieprasījuma nosūtīšanas. Vērtība ārpus diapazona tiek atzīmēta pie sava lauka, un sūtīšana tiek aizturēta, līdz tā ir labota.

Iestatījums Pārbaude
Maksimālie izvades tokeni Vesels skaitlis no 1 līdz modeļa max_output_tokens.
Temperatūra Skaitlis no 0 līdz 2. Tukšs lauks tiek izlaists no pieprasījuma.
top_p Skaitlis no 0 līdz 1. Tukšs lauks tiek izlaists no pieprasījuma.
seed Vesels skaitlis.
Apturēšanas secības Ne vairāk kā 4, atdalītas ar komatiem.
response_format Jābūt tādam, ko izvēlētais modelis pieņem. Saruna, kas pārcelta uz modeli bez json_schema vai bez response_format, tiek aizturēta, norādot iemeslu.
Attēli Tiek izņemti no ziņojuma, kad pārslēdzaties uz modeli, kas pieņem tikai tekstu, ar piezīmi.

Salīdzināt divus modeļus

Salīdzināt divus modeļus izvēlnē Vairāk pievieno otru modeļa izvēli. Katrs ziņojums tad tiek sūtīts abiem modeļiem vienlaikus ar tiem pašiem iestatījumiem, un abas atbildes tiek rādītas blakus, atzīmētas ar A un B. Vienu pusi var ģenerēt atkārtoti atsevišķi. Kad viena puse izsauc rīku, jūsu nosūtītais rezultāts turpina tikai šo pusi.

Kopīgošana, eksports un imports

  • Kopēt kopīgošanas saiti ieliek sarunu pašā saitē, daļā aiz #. Nekas netiek augšupielādēts. Attēli, jūsu atslēga un pēdējās palaišanas dati tiek izlaisti. Kas atver saiti, saņem sarunu kā jaunu sarunu savā playground.
  • Saitei pārāk garu sarunu noraida ar piezīmi. Tā vietā lejupielādējiet to kā JSON.
  • Lejupielādēt sarunas JSON saglabā sarunu kopā ar tās iestatījumiem kā failu. Importēt JSON sarunu panelī atver šādu failu.
  • Kopēt kā cURL nokopē pašreizējo pieprasījumu kā vienu cURL komandu.

Kas kur tiek glabāts

Kas Kur tas tiek glabāts
Sarunas, saglabātie rīki, nesenie modeļi, paneļu izkārtojums Šajā pārlūkā. Tās netiek sūtītas Shannon un neseko jums uz citu ierīci.
API atslēga Atvērtās cilnes atmiņā. Ielīmēta atslēga pazūd, kad lapa tiek pārlādēta vai cilne aizvērta. Pierakstījušamies atslēga katru reizi tiek nolasīta no jūsu konta.
Pēdējā gājiena straumes notikumi, galvenes un pieprasījums Atvērtajā lapā, līdz tā tiek pārlādēta.
Pieprasījumi Tiek sūtīti no jūsu pārlūka uz API ar jūsu atslēgu. Tie tiek ieskaitīti jūsu atlikumā tāpat kā jebkurš cits API pieprasījums.

Tastatūra

Taustiņi Ko tas dara
Enter Nosūtīt ziņojumu.
Shift + Enter Sākt jaunu rindu.
Ctrl + K Atvērt komandu paleti: pārslēgt galapunktu vai modeli, iestatīt sistēmas veidni, sākt jaunu sarunu, ieslēgt vai izslēgt straumēšanu, rīkus vai salīdzināšanu. Uz Mac: ⌘ K.
Esc Apturēt atbildi, kas tiek rakstīta, vai aizvērt atvērtu paneli šaurā ekrānā.

Palaist rotaļu laukumu