API Playground
E sebetsangLeka model e 'ngoe le e 'ngoe le endpoint ho browser ka senotlolo sa hau — output ea streaming, request inspector, le code e hlahisitsoeng eo u ka e kopanyang ka ho toba ho app ea hau.
Playground ke chat console ea API ho /docs/playground. U bua le model, mme playground e romela likopo tse tšoanang le tseo code ea hau e li romelang: ho e 'ngoe ea li-endpoint tse tharo, le model, system prompt, parameters le tools tseo u li behileng. Kopo e 'ngoe le e 'ngoe e ka baloa hape e le code le e le li-event tsa stream tse tala.
Qala
- Fa senotlolo — Ha u kene, playground e sebelisa senotlolo sa API sa akhaonte ea hau mme e bontša balance ea hau. Ha u sa kene, khetha Add key mme u kopitse senotlolo: se bolokoa tab-eng ena feela mme ha se bolokoe le ka mohla.
- Khetha endpoint le model — Bar e holimo e na le switch ea endpoint le model picker. Moqoqo o mocha o qala ho Chat Completions le
shannon-3. - Romela molaetsa — Ngola ka tlase mme u tobetse Enter. Karabo e 'ngoe le e 'ngoe e kenella moqoqong, kahoo molaetsa o latelang o o tsoela pele. Skrine se se nang letho se fana ka li-prompt tse tharo tsa ho qala le mohlala o loketseng oa kopo ea tool.
U fumana mme u fetola senotlolo sa hau leqepheng la Keys & usage. Keys & usage
Li-endpoint le li-model
Switch ea endpoint e etsa qeto ea hore na playground e haha sebopeho sefe sa kopo. U ka e fetola bohareng ba moqoqo; melaetsa e lula.
| Endpoint | Kopo eo e e romelang | Tšupiso |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Anthropic |
Model picker e thathamisa seo GET /v1/models e se khutlisang. E ka batloa, e boloka li-model tsa hau tsa morao-rao holimo, mme e bontša bakeng sa model e 'ngoe le e 'ngoe theko ka 1M tokens, context window le matšoao a tools, input ea setšoantšo, reasoning le structured output.
Moqoqo
- Likarabo li tsoela moqoqong ha li ntse li ngoloa. Reasoning ea model e bontšoa block ea eona eo u ka e kobehang.
- Ka tlase ho karabo e 'ngoe le e 'ngoe: nako ho token ea pele, tokens ka motsotsoana, nako e fetileng, input le output tokens le likarolo tsa cached le reasoning, khakanyo ea theko ea turn, lebaka la ho fela le id ea karabo.
- Molaetsa oa hau o ka fetoloa mme oa romeloa hape ho tloha sebakeng seo. Karabo e ka hlahisoa hape. Molaetsa o ka hlakoloa, mme ho hlakola ho ka sokolloa ka metsotsoana e seng mekae.
- Stop kapa konopo ea Esc e felisa karabo e ntseng e ngoloa.
- Litšoantšo li kenngoa ka konopo ea setšoantšo, ka ho paste kapa ka ho akhela faele, bakeng sa li-model tse amohelang litšoantšo. Setšoantšo se fokotsoa ho pixel tse 1,568 lehlakoreng la sona le lelelele pele se romeloa. Faele e fetang 30 MB e tlolloa.
- Composer le system prompt li bontša palo ea tokens. Bakeng sa li-model tse hosted tsa open-weight ke palo e nepahetseng ho tsoa ho
POST /v1/tokenize. Bakeng sa li-model tse ling ke khakanyo, e tšoailoeng ka≈. - Kopo e hlolehileng e bontša seo u lokelang ho se etsa ka mor'a moo: beha senotlolo ha senotlolo se hanoe, eketsa ha balance e felile, metsotsoana ea ho ema ka mor'a likopo tse ngata haholo, kapa leka hape ka mor'a phoso ea server.
Litlhophiso tsa kopo
Konopo ea Settings e bula panel e nang le li-tab tse tšeletseng. Litlhophiso ke tsa moqoqo: moqoqo o mong le o mong o boloka tsa ona.
| Tab | Seo e se tšoereng |
|---|---|
| System | System prompt ea moqoqo, e romeloang le kopo e 'ngoe le e 'ngoe. Li-template tse hlano lia e tlatsa, mme palo ea eona ea tokens e a bontšoa. |
| Parameters | Max output tokens, temperature, top_p, reasoning effort, stop sequences, seed, le li-switch tsa streaming le web search. Taolo eo endpoint e khethiloeng e se nang field bakeng sa eona e koaloa mme e tšoauoa. |
| Tools | Litlhaloso tsa tool tse romeloang le kopo: li-preset tse nne (get_weather, read_file, run_shell, web_search) kapa tlhaloso ea hau e le JSON, le tool_choice (auto, none, required kapa tool e le 'ngoe ka lebitso). Ha model e bitsa tool, moqoqo o bontša kopo le lebokose la sephetho. Ha Offer sample results e behiloe on, click e le 'ngoe e tlatsa sephetho sa mohlala. U ka boela oa ikngolle ea hau, ebe u e romela ho tsoela pele ka turn. |
| Structured | response_format: text, json_object kapa json_schema e nang le lebitso la schema le JSON schema. Ha schema e behiloe, karabo ea ho qetela e hlahlojoa khahlano le eona mme e tšoauoa moqoqong e le e lumellanang kapa che. Tab e koaletsoe ho endpoint ea Messages, mme khetho eo model e khethiloeng e sa e amoheleng ha e fuoe. |
| Code | Kopo ea moqoqo oa hajoale e le code ea cURL, Python, Node kapa Go, e hahiloeng ho tsoa moqoqong le litlhophisong tsa oona. Senotlolo se gatisoa e le YOUR_API_KEY. Code e ka kopitsoa kapa ea buloa ka pono e kholo. |
| Li-event | Turn ea ho qetela joalo ka ha e ile ea tsamaea ka thapo: li-event tsohle tsa stream le nako ea tsona le filter, karabo e kopantsoeng, li-header tsa karabo (x-request-id, content-type, retry-after, date) le body ea kopo. Tsena li bolokoa ho fihlela leqephe le re-load. |
Liphatlalatso tsa input
Litekanyo tseo u li ngolang li hlahlojoa pele kopo e romeloa. Boleng bo kantle ho sebaka bo tšoauoa ho field ea bona, mme ho romela ho tšoaroa ho fihlela bo lokisoa.
| Setting | Hlahlobo |
|---|---|
| Max output tokens | Palo e feletseng ho tloha ho 1 ho isa ho max_output_tokens ea model. |
| Temperature | Palo ho tloha ho 0 ho isa ho 2. Ha e se na letho e siea field ka ntle ho kopo. |
top_p | Palo ho tloha ho 0 ho isa ho 1. Ha e se na letho e siea field ka ntle ho kopo. |
seed | Palo e feletseng. |
| Stop sequences | Bonyane ba 4, li aroloa ka li-comma. |
response_format | E tlameha ho ba e 'ngoe eo model e khethiloeng e e amohelang. Moqoqo o fetisetsoang ho model e se nang json_schema kapa e se nang response_format o tšoaroa ka lebaka. |
| Litšoantšo | Li tlosoa molaetsing ha u fetohela ho model e amohelang mongolo feela, le tlhokomeliso. |
Bapisa li-model tse peli
Compare two models ho menu ea More e eketsa model picker ea bobeli. Molaetsa o mong le o mong o ntan o ea ho li-model ka bobeli ka nako e le 'ngoe, ka litlhophiso tse tšoanang, mme likarabo tse peli li eme lehlakoreng le leng, li tšoailoe A le B. U ka hlahisa lehlakore le le leng feela hape. Ha lehlakore le le leng le bitsa tool, sephetho seo u se romelang se tsoela pele lehlakoreng leo feela.
Arolelana, export le import
- Copy share link e paka moqoqo ka hare ho link ka boeona, karolong e ka mor'a
#. Ha ho letho le upload-oang. Litšoantšo, senotlolo sa hau le lintlha tsa run ea ho qetela lia siuoa. Ea buleng link o fumana moqoqo e le o mocha ho playground ea hae. - Moqoqo o telele haholo bakeng sa link oa hanoa le tlhokomeliso. Download-e e le JSON ho e-na le moo.
- Download conversation JSON e boloka moqoqo le litlhophiso tsa oona e le faele. Import JSON ho panel ea moqoqo e bula faele e joalo.
- Copy as cURL e kopitsa kopo ea hajoale e le taelo e le 'ngoe ea cURL.
Seo se bolokoang kae
| Eng | Moo e bolokoang teng |
|---|---|
| Lipoqoqo, lisebelisoa tse bolokiloeng, li-model tsa morao-rao, sebopeho sa panel | Ho browser ena. Ha li romelloe ho Shannon mme ha li u latele ho sesebelisoa se seng. |
| Senotlolo sa API | Mohopolong oa tab e bulehileng. Senotlolo se kentsoeng se nyamela ha leqephe le re-load kapa tab e koaloa. Ha u kene, senotlolo se baloa ho akhaonte ea hau nako e 'ngoe le e 'ngoe. |
| Li-event tsa stream, li-header le kopo ea turn ea ho qetela | Leqepheng le bulehileng, ho fihlela le re-load. |
| Likopo | Li romeloa ho tsoa ho browser ea hau ho API le senotlolo sa hau. Li baloa khahlano le balance ea hau joalo ka kopo e 'ngoe le e 'ngoe ea API. |
Keyboard
| Likhiye | Seo e se etsang |
|---|---|
Enter | Romela molaetsa. |
Shift + Enter | Qala mohala o mocha. |
Ctrl + K | Bula command palette: fetola endpoint kapa model, beha system template, qala moqoqo o mocha, kenyetsa streaming, tools kapa compare. Ho Mac: ⌘ K. |
Esc | Emisa karabo e ntseng e ngoloa, kapa koala panel e bulehileng skrineng se moqotetsane. |