Pereiti prie turinio
API žaidimų aikštelė

API žaidimų aikštelė

Interaktyvus

Išbandykite kiekvieną modelį ir galinį tašką naršyklėje su savo raktu: srautinė išvestis, užklausų tikrintuvas ir sugeneruotas kodas, kurį galite tiesiai įklijuoti į savo programą.

Paleisti Playground

Playground yra API pokalbių konsolė adresu /docs/playground. Jūs kalbatės su modeliu, o playground siunčia tas pačias užklausas, kokias siųstų jūsų kodas: į vieną iš trijų galinių taškų, su jūsų nustatytu modeliu, sistemos nurodymu, parametrais ir įrankiais. Kiekvieną užklausą galima perskaityti kaip kodą ir kaip neapdorotus srauto įvykius.

Pradžia

  • Duokite jam raktą — Prisijungus, playground naudoja jūsų paskyros API raktą ir rodo jūsų balansą. Neprisijungus, pasirinkite Pridėti raktą ir įklijuokite raktą: jis laikomas tik šiame skirtuke ir niekada neišsaugomas.
  • Pasirinkite galinį tašką ir modelį — Viršutinėje juostoje yra galinio taško jungiklis ir modelio parinkiklis. Naujas pokalbis prasideda kelyje Chat Completions su shannon-3.
  • Siųskite pranešimą — Įveskite tekstą žemiau ir paspauskite Enter. Kiekvienas atsakymas tampa pokalbio dalimi, todėl kitas pranešimas jį tęsia. Tuščiame ekrane siūlomi trys pradiniai užklausų pavyzdžiai ir paruoštas įrankio kreipinio pavyzdys.

Savo raktą rasite ir pakeisite puslapyje Raktai ir naudojimas. Raktai ir naudojimas

Galiniai taškai ir modeliai

Galinio taško jungiklis nusprendžia, kokį užklausos formatą kuria playground. Jį galite keisti pokalbio viduryje; pranešimai lieka.

Galinis taškas Siunčiama užklausa Nuoroda
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic

Modelio parinkiklis rodo tai, ką grąžina GET /v1/models. Jame galima ieškoti, naujausi jūsų modeliai laikomi viršuje, o prie kiekvieno modelio rodoma kaina už 1M tokenų, konteksto langas ir žymės apie įrankius, vaizdų įvestį, mąstymą ir struktūruotą išvestį.

Pokalbis

  • Atsakymai į pokalbį srautu keliasi, kai tik rašomi. Modelio mąstymas rodomas atskirame bloke, kurį galite suskleisti.
  • Po kiekvienu atsakymu: laikas iki pirmo tokeno, tokenai per sekundę, praėjęs laikas, įvesties ir išvesties tokenai su kešuota ir mąstymo dalimis, ėjimo kainos įvertis, baigimo priežastis ir atsakymo id.
  • Savo pranešimą galima redaguoti ir siųsti iš naujo nuo tos vietos. Atsakymą galima sugeneruoti iš naujo. Pranešimą galima ištrinti, o ištrynimą kelias sekundes galima atšaukti.
  • Stabdyti arba klavišas Esc nutraukia rašomą atsakymą.
  • Vaizdai pridedami vaizdo mygtuku, įklijuojant arba nutempiant failą, modeliams, kurie priima vaizdus. Prieš siunčiant vaizdas sumažinamas iki 1,568 pikselių ilgesniuoju kraštu. Failas, didesnis nei 30 MB, praleidžiamas.
  • Rašymo laukas ir sistemos nurodymas rodo tokenų skaičių. Talpinamiems atvirų svorių modeliams tai tikslus skaičius iš POST /v1/tokenize. Kitiems modeliams tai įvertis, pažymėtas ≈.
  • Nepavykusi užklausa parodo, ką daryti toliau: nustatyti raktą, kai raktas atmestas, papildyti, kai balansas išnaudotas, kiek sekundžių laukti po per didelio užklausų skaičiaus, arba bandyti dar kartą po serverio klaidos.

Užklausos nustatymai

Mygtukas Nustatymai atidaro skydelį su šešiais skirtukais. Nustatymai priklauso pokalbiui: kiekvienas pokalbis turi savo.

Skirtukas Ką talpina
Sistema Pokalbio sistemos nurodymas, siunčiamas su kiekviena užklausa. Jį užpildo penki šablonai, o rodomas jo tokenų skaičius.
Parametrai Didžiausias išvesties tokenų skaičius, temperatūra, top_p, mąstymo pastangos, sustojimo sekos, seed ir srautinio perdavimo bei paieškos internete jungikliai. Valdiklis, kuriam pasirinktas galinis taškas lauko neturi, išjungiamas ir pažymimas.
Įrankiai Su užklausa siunčiami įrankių apibrėžimai: keturi šablonai (get_weather, read_file, run_shell, web_search) arba jūsų pačių apibrėžimas kaip JSON, ir tool_choice (auto, none, required arba vienas įrankis pagal pavadinimą). Kai modelis kviečia įrankį, pokalbyje rodomas kreipinys su laukeliu rezultatui. Įjungus Siūlyti pavyzdinius rezultatus, vienu paspaudimu įrašomas pavyzdinis rezultatas. Galite įvesti ir savo, tada išsiųsti, kad ėjimas tęstųsi.
Struktūruota response_format: text, json_object arba json_schema su schemos pavadinimu ir JSON schema. Nustačius schemą, paskutinis atsakymas tikrinamas pagal ją ir pokalbyje pažymimas kaip atitinkantis arba ne. Skirtukas išjungtas galiniame taške Messages, o parinktis, kurios pasirinktas modelis nepriima, nesiūloma.
Kodas Dabartinio pokalbio užklausa kaip cURL, Python, Node ar Go kodas, sukurtas iš pokalbio ir jo nustatymų. Raktas rodomas kaip YOUR_API_KEY. Kodą galima nukopijuoti arba atidaryti dideliame vaizde.
Įvykiai Paskutinis ėjimas taip, kaip jis ėjo laidu: kiekvienas srauto įvykis su laiko poslinkiu ir filtras, surinktas atsakymas, atsakymo antraštės (x-request-id, content-type, retry-after, date) ir užklausos turinys. Jie saugomi, kol puslapis neperkraunamas.

Įvesties patikros

Jūsų įvesti dydžiai tikrinami prieš siunčiant užklausą. Reikšmė už ribų pažymima savo lauke, o siuntimas sulaikomas, kol ji neištaisyta.

Nustatymas Patikra
Didžiausias išvesties tokenų skaičius Sveikasis skaičius nuo 1 iki modelio max_output_tokens.
Temperatūra Skaičius nuo 0 iki 2. Tuščias laukas iš užklausos pašalinamas.
top_p Skaičius nuo 0 iki 1. Tuščias laukas iš užklausos pašalinamas.
seed Sveikasis skaičius.
Sustojimo sekos Ne daugiau kaip 4, atskirtos kableliais.
response_format Turi būti toks, kokį priima pasirinktas modelis. Pokalbis, perkeltas į modelį be json_schema arba be response_format, sulaikomas nurodant priežastį.
Vaizdai Perjungus į modelį, priimantį tik tekstą, pašalinami iš pranešimo, pateikiant pastabą.

Dviejų modelių palyginimas

Palyginti du modelius meniu Daugiau prideda antrą modelio parinkiklį. Tada kiekvienas pranešimas siunčiamas abiem modeliams vienu metu, su tais pačiais nustatymais, ir abu atsakymai rodomi greta, pažymėti A ir B. Vieną pusę galite sugeneruoti iš naujo atskirai. Kai viena pusė kviečia įrankį, jūsų siunčiamas rezultatas tęsia tik tą pusę.

Bendrinimas, eksportas ir importas

  • Kopijuoti bendrinimo nuorodą supakuoja pokalbį į pačią nuorodą, dalyje po #. Niekas neįkeliamas. Vaizdai, jūsų raktas ir paskutinio paleidimo duomenys nepaliekami. Kas atidaro nuorodą, gauna pokalbį kaip naują savo playground.
  • Per ilgas nuorodai pokalbis atmetamas su pastaba. Vietoj to atsisiųskite jį kaip JSON.
  • Atsisiųsti pokalbio JSON išsaugo pokalbį su nustatymais kaip failą. Importuoti JSON pokalbių skydelyje atidaro tokį failą.
  • Kopijuoti kaip cURL nukopijuoja dabartinę užklausą kaip vieną cURL komandą.

Kas kur saugoma

Kas Kur saugoma
Pokalbiai, išsaugoti įrankiai, neseni modeliai, skydelių išdėstymas Šioje naršyklėje. Jie nesiunčiami Shannon ir nesekioja jūsų į kitą įrenginį.
API raktas Atviro skirtuko atmintyje. Įklijuotas raktas dingsta, kai puslapis perkraunamas arba skirtukas uždaromas. Prisijungus, raktas kaskart nuskaitomas iš jūsų paskyros.
Paskutinio ėjimo srauto įvykiai, antraštės ir užklausa Atviame puslapyje, kol jis neperkraunamas.
Užklausos Siunčiamos iš jūsų naršyklės į API su jūsų raktu. Jos skaičiuojamos nuo jūsų balanso kaip ir bet kuri kita API užklausa.

Klaviatūra

Klavišai Ką daro
Enter Siųsti pranešimą.
Shift + Enter Pradėti naują eilutę.
Ctrl + K Atidaryti komandų skydelį: perjungti galinį tašką ar modelį, nustatyti sistemos šabloną, pradėti naują pokalbį, perjungti srautinį perdavimą, įrankius ar palyginimą. Mac kompiuteryje: ⌘ K.
Esc Sustabdyti rašomą atsakymą arba uždaryti atvirą skydelį siaurame ekrane.

Paleisti Playground