API Playground
InopindiranaEdza ma-model ese ne-endpoints dzese mu-browser nekey yako — streaming output, request inspector, ne-code yakagadzirwa yaunogona kupasta zvakananga mu-app yako.
Playground i-chat console ye-API pa-/docs/playground. Unotaura ne-model, uye playground inotumira ma-request akafanana neaungatumira ne-code yako: kune imwe yema-endpoint matatu, ne-model, system prompt, parameters ne-tools dzawakaisa. Request imwe neimwe inogona kuverengwa zvakare se-code uye se-raw stream events.
Tanga
- Ipe key — Wapinda, playground inoshandisa API key ye-account yako uye inoratidza balance yako. Usina kupinda, sarudza Add key uye upaste key: inochengetwa mu-tab iyi chete uye haisi kuchengetwa nekusingagumi.
- Sarudza endpoint ne-model — Bar yepamusoro ine endpoint switch ne-model picker. Hurukuro itsva inotanga pa-Chat Completions ne-
shannon-3. - Tumira message — Nyora pazasi ugodzvanya Enter. Mhinduro imwe neimwe inobatana nehurukuro, saka message inotevera inoienderera. Screen isina chinhu inopa starter prompts nhatu ne-tool-call example yakagadzirira.
Unowana nekuchinja key yako papeji reKeys & usage. Keys & usage
Endpoints ne-models
Endpoint switch inosarudza request format yainovaka playground. Unogona kuichinja pakati pehurukuro; messages dzinoramba dziripo.
| Endpoint | Request yainotumira | Reference |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Anthropic |
Model picker inoratidza zvinodzoswa ne-GET /v1/models. Inogona kutsvagwa, inochengeta ma-model ako achangoshandiswa kumusoro, uye inoratidza pa-model imwe neimwe mutengo pa1M tokens, context window nezviratidzo ze-tools, image input, reasoning ne-structured output.
Hurukuro
- Mhinduro dzinopinda muhurukuro dzichiri kunyorwa. Reasoning ye-model inoratidzwa mu-block yayo pachayo yaunogona kupeta.
- Pasi pemhinduro imwe neimwe: nguva kusvika pa-token yekutanga, tokens pasekonzi, nguva yakapfuura, input ne-output tokens ne-cached nema-reasoning parts, estimate yemutengo we-turn, finish reason ne-response id.
- Message yako inogona kugadziriswa ndokutumirwa zvakare kubva pamusoro apo. Mhinduro inogona kugadzirwa zvakare. Message inogona kudzimwa, uye kudzima kunogona kudzoserwa mumasekonzi mashoma.
- Stop kana Esc key inopedza mhinduro iri kunyorwa.
- Mifananidzo inobatanidzwa ne-bhatani remufananidzo, nekupaste kana nekudonhedza file, ye-ma-model anogamuchira mifananidzo. Mufananidzo unoderedzwa kusvika ku-1,568 pixels pamucheto wawo murefu usati watumirwa. File inopfuura 30 MB inosiiwa.
- Composer ne-system prompt zvinoratidza token count. Pa-hosted open-weight models ndiyo nhamba chaiyo kubva ku-
POST /v1/tokenize. Pa-ma-model mamwe i-estimate, inoratidzwa ne-≈. - Request yakakundikana inoratidza zvekuita zvinotevera: isa key kana key yarambwa, wedzera kana balance yapera, masekonzi ekumirira mushure memarequest akawandisa, kana kuedza zvakare mushure me-server error.
Request settings
Bhatani re-Settings rinovhura panel ine ma-tab matanhatu. Settings ndedzehurukuro: hurukuro imwe neimwe inochengeta dzayo.
| Tab | Zvainochengeta |
|---|---|
| System | System prompt yehurukuro, inotumirwa ne-request imwe neimwe. Ma-template mashanu anoizadza, uye token count yayo inoratidzwa. |
| Parameters | Max output tokens, temperature, top_p, reasoning effort, stop sequences, seed, nema-switch e-streaming ne-web search. Control isina field mu-endpoint yakasarudzwa inodzimwa uye inoratidzwa. |
| Tools | Tool definitions dzinotumirwa ne-request: ma-preset mana (get_weather, read_file, run_shell, web_search) kana definition yako pachako se-JSON, ne-tool_choice (auto, none, required kana tool imwe nezita). Kana model ichidanidzira tool, thread inoratidza call ine bhokisi remhedzisiro. Ne-Offer sample results yakavhurika, kudzvanya kamwe kunozadza sample result. Unogonawo kunyora yako, wotoitumira kuti turn irambe ichienderera. |
| Structured | response_format: text, json_object kana json_schema ine schema name ne-JSON schema. Schema yakaiswa, mhinduro yekupedzisira inotariswa pairi uye inoratidzwa muhurukuro seinoenderana kana isingaenderani. Tab inodzimwa pa-Messages endpoint, uye option isingagamuchirwi ne-model yakasarudzwa haipiwi. |
| Code | Request yehurukuro yazvino se-cURL, Python, Node kana Go code, yakavakwa kubva muhurukuro ne-settings dzayo. Key inonyorwa se-YOUR_API_KEY. Code inogona kukopwa kana kuvhurwa mu-large view. |
| Events | Turn yekupedzisira sezvayakafamba pa-wire: stream event imwe neimwe ine time offset yayo ne-filter, mhinduro yakaunganidzwa, reply headers (x-request-id, content-type, retry-after, date) ne-request body. Izvi zvinochengetwa kusvika peji rareloda. |
Input checks
Values dzaunonyora dzinotariswa request isati yatumirwa. Value iri kunze kwe-range inoratidzwa pa-field yayo, uye kutumira kunomiswa kusvika yagadziriswa.
| Setting | Check |
|---|---|
| Max output tokens | Nhamba yakazara kubva ku-1 kusvika ku-max_output_tokens ye-model. |
| Temperature | Nhamba kubva ku-0 kusvika ku-2. Isina chinhu inosiya field kunze kwe-request. |
top_p | Nhamba kubva ku-0 kusvika ku-1. Isina chinhu inosiya field kunze kwe-request. |
seed | Nhamba yakazara. |
| Stop sequences | Zvisingapfuuri 4, dzakaparadzaniswa ne-commas. |
response_format | Inofanira kuva imwe inogamuchirwa ne-model yakasarudzwa. Hurukuro yakaendeswa kune model isina json_schema kana isina response_format inobatwa kusvika yagadziriswa, pamwe chete nechikonzero. |
| Mifananidzo | Inobviswa mu-message kana wachinjira kune model inogamuchira text chete, ine note. |
Enzanisa ma-model maviri
Compare two models mu-menu ye-More inowedzera model picker yechipiri. Message imwe neimwe inobva yaenda kuma-model ese maviri panguva imwe chete, ine settings dzakafanana, uye mhinduro mbiri dzinomira padivi nedivi, dzakanzi A ne-B. Unogona kugadzira zvakare divi rimwe bedzi. Kana divi rimwe radanidzira tool, mhedzisiro yaunotumira inoenderera divi iroro chete.
Govera, export ne-import
- Copy share link inopaka hurukuro mu-link pachayo, muchikamu chiri mushure me-
#. Hapana chinoendeswa (upload). Mifananidzo, key yako nezvakadzama zvekumhanya kwekupedzisira zvinosiiwa. Ani naani anovhura link anowana hurukuro sehuri hutsva mu-playground yake. - Hurukuro yakareba kupfuura link inorambwa ine note. Idounloade se-JSON panzvimbo.
- Download conversation JSON inochengeta hurukuro ne-settings dzayo se-file. Import JSON mu-conversations panel inovhura file yakadaro.
- Copy as cURL inokopa request yazvino sa-cURL command imwe.
Zvinochengetwa kupi
| Chii | Kunochengetwa |
|---|---|
| Hurukuro, tools dzakachengetwa, ma-model achangoshandiswa, panel layout | Mu-browser ino. Hadzitumirwi kuShannon uye hadzikuteveri kune imwe device. |
| API key | Mu-memory ye-tab yakavhurika. Key yakapastwa inoenda peji rarelodwa kana tab yavharwa. Wapinda, key inoverengwa kubva ku-account yako nguva dzese. |
| Stream events, headers ne-request ye-turn yekupedzisira | Mu-peji rakavhurika, kusvika rareloda. |
| Requests | Dzinotumirwa kubva ku-browser yako kuenda ku-API ne-key yako. Dzinoverengwa mu-balance yako semamwe ma-API request ese. |
Keyboard
| Keys | Zvainoita |
|---|---|
Enter | Tumira message. |
Shift + Enter | Tanga mutsara mutsva. |
Ctrl + K | Vhura command palette: chinja endpoint kana model, isa system template, tanga hurukuro itsva, shandura streaming, tools kana compare. Pa-Mac: ⌘ K. |
Esc | Mira mhinduro iri kunyorwa, kana vhara panel yakavhurika pa-screen diki. |