Neidio i'r cynnwys
Playground API

Playground API

Rhyngweithiol

Rhowch gynnig ar bob model a phwynt terfyn yn y porwr gyda'ch allwedd eich hun — allbwn wedi'i ffrydio, arolygydd ceisiadau, a chod a gynhyrchir y gallwch ei ludo'n syth i'ch ap.

Lansio'r Playground

Mae'r playground yn gonsol sgwrs ar gyfer yr API yn /docs/playground. Rydych yn siarad â model, ac mae'r playground yn anfon yr un ceisiadau ag y byddai eich cod yn eu hanfon: i un o dri phwynt terfyn, gyda'r model, y system prompt, y paramedrau a'r offer a osodwch. Gellir darllen pob cais yn ôl fel cod ac fel digwyddiadau ffrwd crai.

Dechrau

  • Rhowch allwedd iddo — Wedi mewngofnodi, mae'r playground yn defnyddio allwedd API eich cyfrif ac yn dangos eich balans. Heb fewngofnodi, dewiswch Ychwanegu allwedd a gludwch allwedd: fe'i cedwir yn y tab hwn yn unig ac ni chaiff ei chadw byth.
  • Dewiswch bwynt terfyn a model — Mae'r bar uchaf yn dal switsh y pwynt terfyn a'r dewisydd model. Mae sgwrs newydd yn dechrau ar Chat Completions gyda shannon-3.
  • Anfon neges — Teipiwch isod a gwasgwch Enter. Mae pob ateb yn ymuno â'r sgwrs, felly mae'r neges nesaf yn ei pharhau. Mae'r sgrin wag yn cynnig tri prompt cychwynnol ac enghraifft galwad offeryn barod.

Gallwch ddod o hyd i'ch allwedd a'i chylchdroi ar y dudalen Keys & usage. Allweddi a defnydd

Pwyntiau terfyn a modelau

Mae switsh y pwynt terfyn yn penderfynu pa fformat cais y mae'r playground yn ei adeiladu. Gallwch ei newid yng nghanol sgwrs; mae'r negeseuon yn aros.

Pwynt terfyn Y cais mae'n ei anfon Cyfeirnod
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic

Mae'r dewisydd model yn rhestru'r hyn y mae GET /v1/models yn ei ddychwelyd. Gellir chwilio ynddo, mae'n cadw eich modelau diweddar ar y brig, ac yn dangos ar gyfer pob model y pris am bob 1M o docenau, y ffenestr cyd-destun a marciau ar gyfer offer, mewnbwn delwedd, rhesymu ac allbwn strwythuredig.

Y sgwrs

  • Mae atebion yn ffrydio i'r sgwrs wrth iddynt gael eu hysgrifennu. Dangosir rhesymu'r model mewn bloc ei hun y gallwch ei blygu.
  • O dan bob ateb: yr amser i'r tocen cyntaf, tokenau yr eiliad, yr amser a aeth heibio, tokenau mewnbwn ac allbwn gyda'r rhannau cached a rhesymu, amcangyfrif o gost y tro, y rheswm gorffen ac id yr ymateb.
  • Gellir golygu un o'ch negeseuon a'i hanfon eto o'r pwynt hwnnw. Gellir adfywio ateb. Gellir dileu neges, a gellir dadwneud y dileu am ychydig eiliadau.
  • Mae Stopio neu'r fysell Esc yn dod ag ateb sy'n cael ei ysgrifennu i ben.
  • Atodir delweddau gyda'r botwm delwedd, drwy ludo neu drwy ollwng ffeil, ar gyfer modelau sy'n cymryd delweddau. Graddir delwedd i 1,568 picsel ar ei hymyl hir cyn ei hanfon. Hepgorir ffeil dros 30 MB.
  • Mae'r cyfansoddwr a'r system prompt yn dangos nifer o docenau. Ar gyfer y modelau pwysau agored a gynhelir dyma'r union gyfrif o POST /v1/tokenize. Ar gyfer y modelau eraill amcangyfrif ydyw, wedi'i farcio â ≈.
  • Mae cais a fethodd yn dangos beth i'w wneud nesaf: gosod allwedd pan wrthodwyd yr allwedd, ychwanegu credyd pan fo'r balans wedi'i ddefnyddio, yr eiliadau i aros ar ôl gormod o geisiadau, neu ailgeisio ar ôl gwall gweinydd.

Gosodiadau cais

Mae'r botwm Gosodiadau yn agor panel gyda chwe thab. Mae gosodiadau'n perthyn i'r sgwrs: mae pob sgwrs yn cadw ei rhai ei hun.

Tab Beth mae'n ei ddal
System System prompt y sgwrs, a anfonir gyda phob cais. Mae pum templed yn ei lenwi, a dangosir ei nifer o docenau.
Paramedrau Uchafswm tokenau allbwn, tymheredd, top_p, ymdrech resymu, dilyniannau stop, seed, a'r switshis ar gyfer ffrydio a chwilio'r we. Mae rheolydd nad oes maes iddo ar y pwynt terfyn a ddewiswyd wedi'i ddiffodd a'i farcio.
Offer Diffiniadau offer a anfonir gyda'r cais: pedwar rhagosodiad (get_weather, read_file, run_shell, web_search) neu eich diffiniad eich hun fel JSON, a tool_choice (auto, none, required neu un offeryn yn ôl enw). Pan fo'r model yn galw offeryn, mae'r sgwrs yn dangos yr alwad gyda blwch ar gyfer y canlyniad. Gyda Cynnig canlyniadau enghreifftiol ymlaen, mae un clic yn llenwi canlyniad enghreifftiol. Gallwch hefyd deipio eich un eich hun, yna ei anfon i barhau'r tro.
Strwythuredig response_format: text, json_object neu json_schema gydag enw sgema a sgema JSON. Gyda sgema wedi'i osod, gwirir yr ateb diwethaf yn ei erbyn a'i farcio yn y sgwrs fel un sy'n cyfateb ai peidio. Mae'r tab wedi'i ddiffodd ar y pwynt terfyn Messages, ac ni chynigir dewis nad yw'r model a ddewiswyd yn ei gymryd.
Cod Cais y sgwrs gyfredol fel cod cURL, Python, Node neu Go, wedi'i adeiladu o'r sgwrs a'i gosodiadau. Argraffir yr allwedd fel YOUR_API_KEY. Gellir copïo'r cod neu ei agor mewn golwg fawr.
Digwyddiadau Y tro diwethaf fel yr aeth dros y wifren: pob digwyddiad ffrwd gyda'i wrthbwyso amser a hidlydd, yr ateb wedi'i gydosod, penawdau'r ateb (x-request-id, content-type, retry-after, date) a chorff y cais. Cedwir y rhain nes i'r dudalen ail-lwytho.

Gwiriadau mewnbwn

Gwirir gwerthoedd a deipiwch cyn anfon cais. Marcir gwerth y tu allan i'r ystod ar ei faes, a chedwir yr anfon yn ôl nes ei fod wedi'i gywiro.

Gosodiad Gwiriad
Uchafswm tokenau allbwn Cyfanrif o 1 hyd at max_output_tokens y model.
Tymheredd Rhif o 0 i 2. Mae gwag yn gadael y maes allan o'r cais.
top_p Rhif o 0 i 1. Mae gwag yn gadael y maes allan o'r cais.
seed Cyfanrif.
Dilyniannau stop 4 ar y mwyaf, wedi'u gwahanu gan goma.
response_format Rhaid iddo fod yn un y mae'r model a ddewiswyd yn ei gymryd. Cedwir sgwrs a symudwyd i fodel heb json_schema neu heb response_format yn ôl, gyda'r rheswm.
Delweddau Tynnir hwy o'r neges pan newidiwch i fodel sy'n cymryd testun yn unig, gyda nodyn.

Cymharu dau fodel

Mae Cymharu dau fodel yn y ddewislen Mwy yn ychwanegu ail ddewisydd model. Mae pob neges wedyn yn mynd i'r ddau fodel ar yr un pryd, gyda'r un gosodiadau, ac mae'r ddau ateb yn sefyll ochr yn ochr, wedi'u marcio A a B. Gallwch adfywio un ochr yn unig. Pan fo un ochr yn galw offeryn, mae'r canlyniad a anfonwch yn parhau'r ochr honno yn unig.

Rhannu, allforio a mewnforio

  • Mae Copïo dolen rannu yn pacio'r sgwrs i'r ddolen ei hun, yn y rhan ar ôl #. Ni uwchlwythir dim. Gadewir delweddau, eich allwedd a manylion y rhediad diwethaf allan. Mae pwy bynnag sy'n agor y ddolen yn cael y sgwrs fel un newydd yn ei playground ei hun.
  • Gwrthodir sgwrs sy'n rhy hir i ddolen, gyda nodyn. Lawrlwythwch hi fel JSON yn lle hynny.
  • Mae Lawrlwytho JSON y sgwrs yn cadw'r sgwrs gyda'i gosodiadau fel ffeil. Mae Mewnforio JSON ym mhanel y sgyrsiau yn agor ffeil o'r fath.
  • Mae Copïo fel cURL yn copïo'r cais cyfredol fel un gorchymyn cURL.

Beth sy'n cael ei gadw ble

Beth Ble y caiff ei gadw
Sgyrsiau, offer wedi'u cadw, modelau diweddar, cynllun paneli Yn y porwr hwn. Nid ydynt yn cael eu hanfon i Shannon ac nid ydynt yn eich dilyn i ddyfais arall.
Allwedd API Yng nghof y tab agored. Mae allwedd a gludwyd wedi mynd pan fo'r dudalen yn ail-lwytho neu'r tab yn cau. Wedi mewngofnodi, darllenir yr allwedd o'ch cyfrif bob tro.
Digwyddiadau ffrwd, penawdau a chais y tro diwethaf Yn y dudalen agored, nes iddi ail-lwytho.
Ceisiadau Anfonir hwy o'ch porwr i'r API gyda'ch allwedd. Cânt eu cyfrif yn erbyn eich balans fel unrhyw gais API arall.

Bysellfwrdd

Bysellau Beth mae'n ei wneud
Enter Anfon y neges.
Shift + Enter Dechrau llinell newydd.
Ctrl + K Agor y palet gorchmynion: newid pwynt terfyn neu fodel, gosod templed system, dechrau sgwrs newydd, toglo ffrydio, offer neu gymharu. Ar Mac: ⌘ K.
Esc Stopio'r ateb sy'n cael ei ysgrifennu, neu gau panel agored ar sgrin gul.

Lansio'r Playground