Mine sisu juurde
API mänguväljak

API mänguväljak

Interaktiivne

Proovi iga mudelit ja lõpp-punkti brauseris oma võtmega — voogväljund, päringuinspektor ja genereeritud kood, mille saad otse oma rakendusse kleepida.

Ava mänguväljak

Playground on API vestluskonsool aadressil /docs/playground. Sa räägid mudeliga ja playground saadab samu päringuid, mida sinu kood saadaks: ühte kolmest lõpp-punktist, sinu määratud mudeli, süsteemiprompti, parameetrite ja tööriistadega. Iga päringut saab tagasi lugeda koodina ja toorete voosündmustena.

Alustamine

  • Anna sellele võti — Sisse logituna kasutab playground sinu konto API võtit ja näitab sinu saldot. Sisse logimata vali Lisa võti ja kleebi võti: seda hoitakse ainult selles vahelehes ja seda ei salvestata kunagi.
  • Vali lõpp-punkt ja mudel — Ülariba sisaldab lõpp-punkti lülitit ja mudelivalijat. Uus vestlus algab lõpp-punktis Chat Completions mudeliga shannon-3.
  • Saada sõnum — Kirjuta allpool ja vajuta Enterit. Iga vastus liitub vestlusega, seega järgmine sõnum jätkab seda. Tühi ekraan pakub kolme algprompti ja valmis tööriistakutse näidet.

Oma võtme leiad ja vahetad lehel Võtmed ja kasutus. Võtmed ja kasutus

Lõpp-punktid ja mudelid

Lõpp-punkti lüliti otsustab, millist päringu formaati playground koostab. Seda võid vestluse keskel muuta; sõnumid jäävad.

Lõpp-punkt Päring, mille see saadab Viide
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic

Mudelivalija loetleb selle, mida GET /v1/models tagastab. Selles saab otsida, see hoiab sinu hiljutised mudelid üleval ja näitab iga mudeli kohta hinda 1M tokeni kohta, kontekstiakent ning tähiseid tööriistade, pildisisendi, arutluse ja struktureeritud väljundi kohta.

Vestlus

  • Vastused voolavad vestlusse nii, nagu neid kirjutatakse. Mudeli arutlust näidatakse oma plokis, mida saad kokku voltida.
  • Iga vastuse all: aeg esimese tokenini, tokenit sekundis, kulunud aeg, sisend- ja väljundtokenid koos vahemälus ja arutluse osadega, vahetuse hinna hinnang, lõpetamise põhjus ja vastuse id.
  • Sinu sõnumit saab muuta ja sellest punktist uuesti saata. Vastust saab uuesti genereerida. Sõnumi saab kustutada ja kustutamist saab mõne sekundi jooksul tagasi võtta.
  • Peata või klahv Esc lõpetab vastuse, mida kirjutatakse.
  • Pilte lisatakse pildinupuga, kleepimise või faili lohistamisega mudelitele, mis pilte võtavad. Pilt skaleeritakse enne saatmist pikemal servalt 1,568 pikslini. Üle 30 MB fail jäetakse vahele.
  • Sõnumiredaktor ja süsteemiprompt näitavad tokenite arvu. Hostitud avatud kaaludega mudelite puhul on see täpne arv päringust POST /v1/tokenize. Teiste mudelite puhul on see hinnang, märgitud ≈.
  • Ebaõnnestunud päring näitab, mida edasi teha: määra võti, kui võti lükati tagasi, täienda, kui saldo on kasutatud, sekundid, mida oodata pärast liiga paljusid päringuid, või kordus pärast serveri viga.

Päringu sätted

Nupp Seaded avab paneeli kuue vahelehega. Sätted kuuluvad vestlusele: iga vestlus hoiab oma.

Vaheleht Mida see sisaldab
Süsteem Vestluse süsteemiprompt, saadetakse iga päringuga. Viis malli täidavad selle ja selle tokenite arv on näidatud.
Parameetrid Maksimaalsed väljundtokenid, temperatuur, top_p, arutluse pingutus, stopp-jadad, seed ning voogedastuse ja veebiotsingu lülitid. Juhtelement, millele valitud lõpp-punktil välja ei ole, lülitatakse välja ja märgitakse.
Tööriistad Päringuga saadetavad tööriistade definitsioonid: neli eelseadet (get_weather, read_file, run_shell, web_search) või sinu enda definitsioon JSON-ina ning tool_choice (auto, none, required või üks tööriist nime järgi). Kui mudel kutsub tööriista, näitab vestlus kutset koos tulemuse kastiga. Kui Paku näidistulemusi on sees, täidab üks klõps näidistulemuse. Võid sisestada ka enda oma ja saata selle vahetuse jätkamiseks.
Struktureeritud response_format: text, json_object või json_schema koos skeemi nime ja JSON schemaga. Skeemi määramisel kontrollitakse viimast vastust selle vastu ja märgitakse vestluses sobivaks või mitte. Vaheleht on lõpp-punktis Messages välja lülitatud ning valikut, mida valitud mudel ei võta, ei pakuta.
Kood Praeguse vestluse päring cURL-i, Pythoni, Node'i või Go koodina, koostatud vestlusest ja selle sätetest. Võti trükitakse kui YOUR_API_KEY. Koodi saab kopeerida või avada suures vaates.
Sündmused Viimane vahetus nii, nagu see üle ühenduse läks: iga voosündmus oma ajanihke ja filtriga, kokku pandud vastus, vastuse päised (x-request-id, content-type, retry-after, date) ja päringu sisu. Neid hoitakse, kuni leht uuesti laetakse.

Sisendi kontrollid

Sinu sisestatud väärtusi kontrollitakse enne päringu saatmist. Vahemikust väljas olev väärtus märgitakse oma väljal ja saatmine peatatakse, kuni see on parandatud.

Säte Kontroll
Maksimaalsed väljundtokenid Täisarv vahemikus 1 kuni mudeli max_output_tokens.
Temperatuur Arv vahemikus 0 kuni 2. Tühi jätab välja päringust välja.
top_p Arv vahemikus 0 kuni 1. Tühi jätab välja päringust välja.
seed Täisarv.
Stopp-jadad Kuni 4, komadega eraldatud.
response_format Peab olema selline, mida valitud mudel võtab. Vestlus, mis viidi mudelile ilma json_schema või ilma response_format, peatatakse põhjendusega.
Pildid Eemaldatakse sõnumist märkusega, kui vahetad mudelile, mis võtab ainult teksti.

Võrdle kahte mudelit

Võrdle kahte mudelit menüüs Rohkem lisab teise mudelivalija. Iga sõnum läheb siis mõlemale mudelile samal ajal, samade sätetega, ja kaks vastust on kõrvuti, märgitud A ja B. Ühe poole võid uuesti genereerida eraldi. Kui üks pool kutsub tööriista, jätkab sinu saadetud tulemus ainult seda poolt.

Jagamine, eksport ja import

  • Kopeeri jagamislink pakib vestluse lingi enda sisse, osasse pärast #. Midagi ei laadita üles. Pildid, sinu võti ja viimase käivituse üksikasjad jäetakse välja. Kes lingi avab, saab vestluse uuena oma playgroundis.
  • Lingi jaoks liiga pikk vestlus lükatakse märkusega tagasi. Laadi see selle asemel alla JSON-ina.
  • Laadi alla vestluse JSON salvestab vestluse koos sätetega failina. Impordi JSON vestluste paneelis avab sellise faili.
  • Kopeeri cURL-ina kopeerib praeguse päringu ühe cURL käsuna.

Mida kus hoitakse

Mis Kus seda hoitakse
Vestlused, salvestatud tööriistad, hiljutised mudelid, paneeli paigutus Selles brauseris. Neid ei saadeta Shannonile ja need ei järgne sulle teise seadmesse.
API võti Avatud vahelehe mälus. Kleebitud võti kaob, kui leht uuesti laetakse või vaheleht suletakse. Sisse logituna loetakse võti iga kord sinu kontolt.
Viimase vahetuse voosündmused, päised ja päring Avatud lehel, kuni see uuesti laetakse.
Päringud Saadetakse sinu brauserist API-le sinu võtmega. Neid loetakse sinu saldo vastu nagu iga teist API päringut.

Klaviatuur

Klahvid Mida see teeb
Enter Saada sõnum.
Shift + Enter Alusta uut rida.
Ctrl + K Ava käskude paneel: vaheta lõpp-punkti või mudelit, määra süsteemi mall, alusta uut vestlust, lülita voogedastust, tööriistu või võrdlust. Macis: ⌘ K.
Esc Peata vastus, mida kirjutatakse, või sulge avatud paneel kitsal ekraanil.

Ava mänguväljak