Yiya kumxholo
Ibala lokudlala le-API

Ibala lokudlala le-API

Iyasebenzisana

Zama yonke imodeli ne-endpoint kwibrawuza ngesitshixo sakho — i-output ye-streaming, umhloli wezicelo, nekhowudi eyenziweyo onokuyipeyista ngqo kwi-app yakho.

Qalisa i-Playground

I-playground yikhonsoli yencoko ye-API ekwi-/docs/playground. Uthetha nemodeli, kwaye i-playground ithumela izicelo ezifanayo nezo ikhowudi yakho ingazithumela: kwenye yee-endpoint ezintathu, ngemodeli, i-system prompt, iiparameter kunye nee-tool ozimiseleyo. Isicelo ngasinye sinokufundwa kwakhona njengekhowudi nanjengemisitho ye-stream ekrwada.

Qala

  • Yinike isitshixo — Ukuba ungene, i-playground isebenzisa i-API key yeakhawunti yakho kwaye ibonisa ibhalansi yakho. Ukuba awungenanga, khetha Yongeza isitshixo kwaye unamathelise isitshixo: sigcinwa kule thebhu kuphela kwaye asigcinwa ngonaphakade.
  • Khetha i-endpoint kunye nemodeli — Ibha ephezulu iqulathe iswitshi ye-endpoint kunye nesikhethi semodeli. Incoko entsha iqala kwi-Chat Completions nge-shannon-3.
  • Thumela umyalezo — Bhala ngezantsi kwaye ucinezele u-Enter. Yonke impendulo ijoyina incoko, ngoko umyalezo olandelayo uyiqhubela phambili. Isikrini esingenanto sinika ii-prompt ezintathu zokuqala kunye nomzekelo ozilungeleyo wobizo lwe-tool.

Ufumana kwaye utshintshe isitshixo sakho kwiphepha leKeys & usage. Izitshixo nokusetyenziswa

Ii-endpoint neemodeli

Iswitshi ye-endpoint isigqibela ukuba yeyiphi ifomathi yesicelo eyakhiwa yi-playground. Unokuyitshintsha phakathi kwincoko; imiyalezo iyahlala.

Endpoint Isicelo esisithumelayo Isalathiso
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses I-Responses API
Messages POST /v1/messages Ubume beAnthropic

Isikhethi semodeli sidwelisa oko GET /v1/models ikubuyisayo. Sinokukhangelwa, sigcina iimodeli zakho zamva nje ngaphezulu, kwaye sibonisa kwimodeli nganye ixabiso kwii-token ezingu-1M, ifestile ye-context kunye neempawu zee-tool, igalelo lemifanekiso, ukuqiqa nokuphuma okucwangcisiweyo.

Incoko

  • Iimpendulo zi-stream kwincoko njengoko zibhalwa. Ukuqiqa kwemodeli kubonisiwe kwibhloko yako onokuyisonga.
  • Phantsi kwempendulo nganye: ixesha ukuya kwi-token yokuqala, ii-token ngomzuzwana, ixesha eligqithileyo, ii-token zokufaka nezokuphuma kunye neenxalenye ze-cache nezokuqiqa, ingqikelelo yentlawulo yomjikelo, isizathu sokuphela kunye ne-id yempendulo.
  • Umyalezo wakho unokuhlelwa kwaye uthunyelwe kwakhona ukusuka kuloo ndawo. Impendulo inokuvelisa kwakhona. Umyalezo unokucinywa, kwaye ukucima kunokuphindiswa kwimizuzwana embalwa.
  • Yeka okanye iqhosha le-Esc siphelisa impendulo ebhalwayo.
  • Imifanekiso incanyathiselwa ngeqhosha lomfanekiso, ngokunamathelisa okanye ngokuwisa ifayile, kwiimodeli ezamkela imifanekiso. Umfanekiso uncitshiswa ube yi-1,568 yeepikseli emphethweni wawo omde phambi kokuba uthunyelwe. Ifayile engaphezu kwe-30 MB iyatsitywa.
  • I-composer kunye ne-system prompt zibonisa inani lee-token. Kwiimodeli ze-open-weight ezisingathiweyo yinani elichanekileyo elivela kwi-POST /v1/tokenize. Kwezinye iimodeli yingqikelelo, ephawulwe nge-≈.
  • Isicelo esisilelekileyo sibonisa into emayenziwe emva koko: misela isitshixo xa isitshixo sale, yongeza xa ibhalansi isetyenzisiwe, imizuzwana yokulinda emva kwezicelo ezininzi kakhulu, okanye uzame kwakhona emva kwempazamo ye-server.

Iiseto zesicelo

Iqhosha elithi Iiseto livula iphanele enamathebhu amathandathu. Iiseto zezencoko: incoko nganye igcina eyayo.

Ithebhu Okuqulathileyo
System I-system prompt yencoko, ethunyelwa kunye nesicelo ngasinye. Iitemplate ezintlanu ziyizalisa, kwaye inani layo lee-token liyabonisa.
Iiparameter Ii-token ezininzi zokuphuma, ubushushu, i-top_p, ubunzulu bokuqiqa, ii-stop sequence, i-seed, kunye neeswitshi ze-streaming nokukhangela kwiwebhu. Ulawulo i-endpoint ekhethiweyo engenantsimi yalo luvalwa kwaye luphawulwe.
Ii-tool Uchazo lwee-tool oluthunyelwe kunye nesicelo: ii-preset ezine (get_weather, read_file, run_shell, web_search) okanye uchazo lwakho njenge-JSON, kunye ne-tool_choice (auto, none, required okanye i-tool enye ngegama). Xa imodeli ibiza i-tool, incoko ibonisa ubizo kunye nebhokisi yesiphumo. Xa Nikela iziphumo zesampulu ivuliwe, ukucofa kwesinye kuzalisa isiphumo sesampulu. Unokubhala eyakho, uze uyithumele ukuqhubela phambili umjikelo.
Ocwangcisiweyo I-response_format: i-text, i-json_object okanye i-json_schema kunye negama le-schema ne-JSON schema. Xa i-schema imiselwe, impendulo yokugqibela iyahlolwa ngokuchasene nayo kwaye iphawulwe kwincoko njengehambelana okanye ayihambelani. Ithebhu ivaliwe kwi-endpoint ye-Messages, kwaye inketho imodeli ekhethiweyo engayamkeliyo ayinikezelwa.
Ikhowudi Isicelo sencoko yangoku njengekhowudi ye-cURL, Python, Node okanye Go, yakhiwe ukusuka kwincoko neeseto zayo. Isitshixo siprintwa njenge-YOUR_API_KEY. Ikhowudi inokukopwa okanye ivulwe kujongo olukhulu.
Imisitho Umjikelo wokugqibela njengoko uhambe ngocingo: yonke imisitho ye-stream kunye nexesha layo lokuhlukana kunye nesihluzi, impendulo ehlanganisiweyo, ii-header zempendulo (x-request-id, content-type, retry-after, date) kunye nomzimba wesicelo. Zigcinwa de iphepha lilayishwe kwakhona.

Uhlolo lwegalelo

Amaxabiso owabhalayo ayahlolwa phambi kokuba isicelo sithunyelwe. Ixabiso elingaphandle koluhlu liphawulwa kwintsimi yalo, kwaye ukuthumela kubanjiswa de lilungiswe.

Useto Uhlolo
Ii-token ezininzi zokuphuma Inani eliphelele ukusuka kwi-1 ukuya kwi-max_output_tokens yemodeli.
Ubushushu Inani ukusuka kwi-0 ukuya kwi-2. Ukuyishiya ingenanto kushiya intsimi ngaphandle kwesicelo.
top_p Inani ukusuka kwi-0 ukuya kwi-1. Ukuyishiya ingenanto kushiya intsimi ngaphandle kwesicelo.
seed Inani eliphelele.
Ii-stop sequence Ubuninzi be-4, zahlulwe ngamakoma.
response_format Kufuneka ibe leyo imodeli ekhethiweyo iyamkelayo. Incoko ehanjiselwe kwimodeli engenayo i-json_schema okanye engenayo i-response_format iyabanjiswa kunye nesizathu.
Imifanekiso Isuswa kumyalezo xa utshintshela kwimodeli yamkela umbhalo kuphela, kunye nenqaku.

Linganisa iimodeli ezimbini

Linganisa iimodeli ezimbini kwimenyu ethi Okunye yongeza isikhethi sesibini semodeli. Umyalezo ngamnye uya kuzo zombini iimodeli ngaxeshanye, ngeeseto ezifanayo, kwaye iimpendulo ezimbini zimi macala, ziphawulwe nge-A ne-B. Unokuyivelisa kwakhona into yelinye icala kuphela. Xa elinye icala libiza i-tool, isiphumo oyithumelayo siqhubeka nelo cala kuphela.

Yabelana, thumela ngaphandle kwaye ngenisa

  • Kopa ilinki yokwabelana ipakisha incoko kwilinki ngokwayo, kwinxalenye emva kwe-#. Akukho nto ilayishwayo. Imifanekiso, isitshixo sakho kunye neenkcukacha zokugqibela kokuqhuba zishiyiwe ngaphandle. Nabani na ovula ilinki ufumana incoko njengentsha kwi-playground yakhe.
  • Incoko ende kakhulu kwilinki iyaliwa kunye nenqaku. Ikhuphele njenge-JSON endaweni yoko.
  • Khuphela i-JSON yencoko igcina incoko kunye neeseto zayo njengefayile. Ngenisa i-JSON kwiphanele yeencoko ivula ifayile enjalo.
  • Kopa njenge-cURL ikopa isicelo sangoku njengomyalelo omnye we-cURL.

Okugcinwe phi

Yintoni Apho igcinwe khona
Iincoko, ii-tool ezigcinwe, iimodeli zamva nje, uhlengahlengiso lweephanele Kwesi sikhangeli. Azithunyelwa kwiShannon kwaye azikulandeli kwenye ikhompyuter.
I-API key Kwimemori yethebhu evulekileyo. Isitshixo esinamathelisiweyo siyanyamalala xa iphepha lilayishwa kwakhona okanye ithebhu ivalwa. Ukuba ungene, isitshixo sifundwa kwiakhawunti yakho ngalo lonke ixesha.
Imisitho ye-stream, ii-header kunye nesicelo somjikelo wokugqibela Kwiphepha elivulekileyo, de lilayishwe kwakhona.
Izicelo Zithunyelwa kwisikhangeli sakho kwi-API ngesitshixo sakho. Zibalwa kwibhalansi yakho njengaso nasiphi na esinye isicelo se-API.

Ikhibhodi

Izitshixo Okwenzayo
Enter Thumela umyalezo.
Shift + Enter Qala umgca omtsha.
Ctrl + K Vula i-command palette: tshintsha i-endpoint okanye imodeli, misela itemplate ye-system, qala incoko entsha, vula okanye vala i-streaming, ii-tool okanye uthelekiso. Kwi-Mac: ⌘ K.
Esc Yeka impendulo ebhalwayo, okanye vala iphanele evulekileyo kwisikrini esimxinwa.

Qalisa i-Playground