Kalo te përmbajtja
API Playground

API Playground

Interaktiv

Provoni çdo model dhe endpoint në shfletues me çelësin tuaj — dalje me streaming, inspektor kërkesash dhe kod i gjeneruar që mund ta ngjitni drejt në aplikacionin tuaj.

Hap Playground

Playground është një konsolë bisede për API-n te /docs/playground. Bisedoni me një model, dhe playground dërgon të njëjtat kërkesa që do t'i dërgonte kodi juaj: te një nga tri endpoint-et, me modelin, system prompt-in, parametrat dhe mjetet që caktoni. Çdo kërkesë mund të lexohet mbrapsht si kod dhe si ngjarje të papërpunuara stream-i.

Fillimi

  • Jepini një çelës — Kur keni hyrë, playground përdor çelësin API të llogarisë suaj dhe tregon bilancin tuaj. Pa hyrë, zgjidhni Shto çelës dhe ngjitni një çelës: mbahet vetëm në këtë skedë dhe nuk ruhet kurrë.
  • Zgjidhni një endpoint dhe një model — Shiriti i sipërm mban çelësin e endpoint-it dhe zgjedhësin e modelit. Një bisedë e re fillon te Chat Completions me shannon-3.
  • Dërgoni një mesazh — Shkruani më poshtë dhe shtypni Enter. Çdo përgjigje bashkohet me bisedën, kështu që mesazhi tjetër e vazhdon. Ekrani bosh ofron tri prompt-e fillestare dhe një shembull të gatshëm thirrjeje mjeti.

Çelësin tuaj e gjeni dhe e rrotulloni në faqen Çelësat dhe përdorimi. Çelësat dhe përdorimi

Endpoint-e dhe modele

Çelësi i endpoint-it vendos cilin format kërkese ndërton playground. Mund ta ndryshoni në mes të një bisede; mesazhet mbeten.

Endpoint Kërkesa që dërgon Referenca
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Formati Anthropic

Zgjedhësi i modelit liston atë që kthen GET /v1/models. Mund të kërkohet, i mban modelet tuaja të fundit në krye, dhe për çdo model tregon çmimin për 1M tokens, dritaren e kontekstit dhe shenja për mjetet, hyrjen e imazheve, arsyetimin dhe daljen e strukturuar.

Biseda

  • Përgjigjet rrjedhin në bisedë ndërsa shkruhen. Arsyetimi i modelit shfaqet në një bllok më vete që mund ta palosni.
  • Nën çdo përgjigje: koha deri te tokeni i parë, tokens për sekondë, koha e kaluar, tokens hyrje dhe dalje me pjesët e cache-it dhe të arsyetimit, një vlerësim i kostos së radhës, arsyeja e mbarimit dhe id-ja e përgjigjes.
  • Një mesazh i juaji mund të editohet dhe të dërgohet përsëri nga ajo pikë. Një përgjigje mund të rigjenerohet. Një mesazh mund të fshihet, dhe fshirja mund të zhbëhet për disa sekonda.
  • Ndalo ose tasti Esc e mbyll një përgjigje që po shkruhet.
  • Imazhet bashkëngjiten me butonin e imazhit, duke ngjitur ose duke lëshuar një skedar, për modelet që pranojnë imazhe. Një imazh shkallëzohet në 1,568 pikselë në anën e gjatë para dërgimit. Një skedar mbi 30 MB kapërcehet.
  • Fusha e shkrimit dhe system prompt-i tregojnë një numër tokens-ash. Për modelet open-weight të hostuara është numri i saktë nga POST /v1/tokenize. Për modelet e tjera është vlerësim, i shënuar me ≈.
  • Një kërkesë e dështuar tregon çfarë të bëni më tej: vendosni një çelës kur çelësi u refuzua, shtoni kredi kur bilanci është shterur, sekondat e pritjes pas shumë kërkesash, ose një riprovim pas një gabimi serveri.

Cilësimet e kërkesës

Butoni Cilësimet hap një panel me gjashtë skeda. Cilësimet i përkasin bisedës: çdo bisedë mban të vetat.

Skeda Çfarë mban
Sistemi System prompt-i i bisedës, i dërguar me çdo kërkesë. Pesë shabllone e plotësojnë, dhe tregohet numri i tokens-ave të tij.
Parametrat Tokens maksimalë të daljes, temperatura, top_p, përpjekja e arsyetimit, stop sequences, seed, dhe çelësat për streaming dhe kërkim në ueb. Një kontroll për të cilin endpoint-i i zgjedhur nuk ka fushë çaktivizohet dhe shënohet.
Mjetet Përkufizimet e mjeteve të dërguara me kërkesën: katër preset-e (get_weather, read_file, run_shell, web_search) ose përkufizimi juaj si JSON, dhe tool_choice (auto, none, required ose një mjet sipas emrit). Kur modeli thërret një mjet, biseda e tregon thirrjen me një kuti për rezultatin. Me Ofro rezultate shembull të aktivizuar, një klikim plotëson një rezultat shembull. Mund të shkruani edhe vetë një, pastaj ta dërgoni për të vazhduar radhën.
Strukturuar response_format: text, json_object ose json_schema me një emër skeme dhe një skemë JSON. Me një skemë të caktuar, përgjigjja e fundit kontrollohet kundrejt saj dhe shënohet në bisedë si e përputhur ose jo. Skeda çaktivizohet në endpoint-in Messages, dhe një opsion që modeli i zgjedhur nuk e pranon nuk ofrohet.
Kodi Kërkesa e bisedës aktuale si kod cURL, Python, Node ose Go, e ndërtuar nga biseda dhe cilësimet e saj. Çelësi shtypet si YOUR_API_KEY. Kodi mund të kopjohet ose të hapet në pamje të madhe.
Ngjarjet Radha e fundit siç shkoi në linjë: çdo ngjarje stream-i me zhvendosjen e kohës dhe një filtër, përgjigjja e montuar, header-at e përgjigjes (x-request-id, content-type, retry-after, date) dhe trupi i kërkesës. Këto mbahen derisa faqja të ringarkohet.

Kontrollet e hyrjes

Vlerat që shkruani kontrollohen para se të dërgohet një kërkesë. Një vlerë jashtë intervalit shënohet te fusha e saj, dhe dërgimi mbahet pas derisa të rregullohet.

Cilësimi Kontrolli
Tokens maksimalë të daljes Një numër i plotë nga 1 deri te max_output_tokens i modelit.
Temperatura Një numër nga 0 deri 2. Bosh e lë fushën jashtë kërkesës.
top_p Një numër nga 0 deri 1. Bosh e lë fushën jashtë kërkesës.
seed Një numër i plotë.
Stop sequences Më së shumti 4, të ndara me presje.
response_format Duhet të jetë një që e pranon modeli i zgjedhur. Një bisedë e kaluar te një model pa json_schema ose pa response_format mbahet pas me arsyen.
Imazhet Hiqen nga mesazhi kur kaloni te një model që pranon vetëm tekst, me një shënim.

Krahasoni dy modele

Krahaso dy modele te menyja Më shumë shton një zgjedhës të dytë modeli. Çdo mesazh pastaj shkon te të dy modelet në të njëjtën kohë, me të njëjtat cilësime, dhe dy përgjigjet qëndrojnë krah për krah, të shënuara A dhe B. Mund ta rigjeneroni vetëm njërën anë. Kur njëra anë thërret një mjet, rezultati që dërgoni vazhdon vetëm atë anë.

Shpërndarja, eksporti dhe importi

  • Kopjo linkun e shpërndarjes e paketon bisedën në vetë linkun, në pjesën pas #. Nuk ngarkohet asgjë. Imazhet, çelësi juaj dhe detajet e ekzekutimit të fundit lihen jashtë. Kushdo që e hap linkun e merr bisedën si të re në playground-in e vet.
  • Një bisedë shumë e gjatë për një link refuzohet me një shënim. Shkarkojeni si JSON.
  • Shkarko JSON-in e bisedës e ruan bisedën me cilësimet e saj si skedar. Importo JSON te paneli i bisedave e hap një skedar të tillë.
  • Kopjo si cURL e kopjon kërkesën aktuale si një komandë cURL.

Çfarë ruhet ku

Çfarë Ku ruhet
Bisedat, mjetet e ruajtura, modelet e fundit, shtrirja e paneleve Në këtë shfletues. Nuk dërgohen te Shannon dhe nuk ju ndjekin në një pajisje tjetër.
Çelësi API Në memorien e skedës së hapur. Një çelës i ngjitur zhduket kur faqja ringarkohet ose skeda mbyllet. Kur keni hyrë, çelësi lexohet nga llogaria juaj çdo herë.
Ngjarjet e stream-it, header-at dhe kërkesa e radhës së fundit Në faqen e hapur, derisa të ringarkohet.
Kërkesat Dërgohen nga shfletuesi juaj te API me çelësin tuaj. Numërohen kundrejt bilancit tuaj si çdo kërkesë tjetër API.

Tastiera

Tastet Çfarë bën
Enter Dërgo mesazhin.
Shift + Enter Fillo një rresht të ri.
Ctrl + K Hap paletën e komandave: ndërro endpoint ose model, vendos një shabllon sistemi, fillo një bisedë të re, kalo streaming, mjetet ose krahasimin. Në Mac: ⌘ K.
Esc Ndalo përgjigjen që po shkruhet, ose mbyll një panel të hapur në ekran të ngushtë.

Hap Playground