Leum gun t-susbaint
Raon-cluiche API

Raon-cluiche API

Eadar-ghnìomhach

Feuch gach modail is endpoint sa bhrabhsair le d’ iuchair fhèin — toradh streaming, sgrùdaire iarrtais, agus còd air a ghineadh a ghabhas cur dìreach dhan app agad.

Fosgail am Playground

Is e console còmhraidh airson an API aig /docs/playground a th’ anns a’ playground. Bruidhnidh tu ri modail, agus cuiridh am playground na h-aon iarrtasan a chuireadh do chòd: gu aon de thrì endpoints, leis a’ mhodail, an system prompt, na paramadairean agus na h-innealan a shuidhich thu. Gabhaidh gach iarrtas a leughadh air ais mar chòd agus mar thachartasan stream amh.

Tòisich

  • Thoir iuchair dha — Nuair a tha thu air do chlàradh a-steach, cleachdaidh am playground iuchair API a’ chunntais agad agus seallaidh e do balance. Mura h-eil thu air do chlàradh a-steach, tagh Add key agus cuir a-steach iuchair: thèid a chumail san taba seo a-mhàin agus cha tèid a shàbhaladh a-chaoidh.
  • Tagh endpoint agus modail — Anns a’ bhàr àrd tha an suidse endpoint agus roghnaiche nam modailean. Tòisichidh còmhradh ùr air Chat Completions le shannon-3.
  • Cuir teachdaireachd — Sgrìobh gu h-ìosal agus brùth Enter. Tha gach freagairt a’ tighinn a-steach dhan chòmhradh, agus mar sin lean an ath theachdaireachd air. Tha an sgrìon fhalamh a’ tabhann trì prompts tòiseachaidh agus eisimpleir ullaichte de ghairm inneil.

Lorgaidh tu agus ùraichidh tu d’ iuchair air an duilleag Keys & usage. Iuchraichean & cleachdadh

Endpoints agus modailean

Co-dhùnaidh an suidse endpoint dè an cruth iarrtais a thogas am playground. Faodaidh tu atharrachadh ann am meadhan còmhraidh; fuirichidh na teachdaireachdan.

Endpoint An t-iarrtas a chuireas e Iomradh
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Cruth anthropic

Bidh roghnaiche nam modailean a’ liostadh na thilleas GET /v1/models. Gabhaidh a rannsachadh, cumaidh e na modailean as ùire agad aig a’ mhullach, agus seallaidh e airson gach modail a’ phrìs gach 1M tokens, uinneag a’ cho-theacsa agus comharran airson innealan, cuir-a-steach dhealbhan, reasoning agus toradh structaraichte.

An còmhradh

  • Bidh freagairtean a’ sruthadh dhan t-snàithlean fhad ’s a thèid an sgrìobhadh. Tha reasoning a’ mhodail air a shealltainn ann am bloc dheth fhèin as urrainn dhut a phasgadh.
  • Fo gach freagairt: an ùine chun a’ chiad token, tokens gach diog, an ùine a dh’fhalbh, tokens cuir-a-steach is cuir-a-mach leis na pàirtean cached is reasoning, tuairmse air cosgais an turn, an adhbhar crìochnachaidh agus id an fhreagairt.
  • Faodar teachdaireachd dhìot a dheasachadh agus a chur a-rithist on phuing sin. Gabhaidh freagairt a ghineadh às ùr. Gabhaidh teachdaireachd a sguabadh às, agus gabhaidh an sguabadh às a thoirt air ais fad beagan diogan.
  • Cuiridh Stop no an iuchair Esc crìoch air freagairt a tha ga sgrìobhadh.
  • Thèid dealbhan a cheangal leis a’ phutan dealbh, le pasgadh no le bhith a’ leigeil faidhle sìos, airson modailean a ghabhas dealbhan. Thèid dealbh a sgèileadh gu 1,568 piogsail air an oir fhada mus tèid a chur. Thèid faidhle os cionn 30 MB a leum thairis.
  • Seallaidh an composer agus an system prompt cunntas tokens. Airson na modailean open-weight hosted, is e an cunntas ceart o POST /v1/tokenize a th’ ann. Airson na modailean eile, is e tuairmse a th’ ann, comharraichte le ≈.
  • Seallaidh iarrtas a dh’fhàillig dè a nì thu an uair sin: suidhich iuchair nuair a chaidh an iuchair a dhiùltadh, cuir creideas ris nuair a tha am balance air a chleachdadh, na diogan ri feitheamh às dèidh cus iarrtasan, no feuch a-rithist às dèidh mearachd an fhrithealaiche.

Roghainnean iarrtais

Fosglaidh am putan Settings panal le sia tabaichean. Buinidh na roghainnean dhan chòmhradh: cumaidh gach còmhradh a chuid fhèin.

Taba Dè a th’ ann
Siostam An system prompt dhen chòmhradh, air a chur le gach iarrtas. Lìonaidh còig teamplaidean e, agus thèid cunntas nan tokens aige a shealltainn.
Paramadairean Tokens cuir-a-mach as motha, temperature, top_p, oidhirp reasoning, sreathan stad, seed, agus na suidsichean airson streaming agus rannsachadh lìn. Thèid smachd aig nach eil raon aig an endpoint taghte a chur dheth agus a chomharrachadh.
Innealan Mìneachaidhean innealan air an cur leis an iarrtas: ceithir ro-shuidheachaidhean (get_weather, read_file, run_shell, web_search) no do mhìneachadh fhèin mar JSON, agus tool_choice (auto, none, required no aon inneal air ainm). Nuair a ghairmeas am modail inneal, seallaidh an t-snàithlean a’ ghairm le bogsa airson an toraidh. Le Offer sample results air, lìonaidh aon bhrùthadh toradh sampall. Faodaidh tu cuideachd do thoradh fhèin a sgrìobhadh, agus an uair sin a chur gus an turn a leantainn.
Structaraichte response_format: text, json_object no json_schema le ainm sgeama agus sgeama JSON. Le sgeama suidhichte, thèid am freagairt mu dheireadh a sgrùdadh na aghaidh agus a chomharrachadh anns an t-snàithlean mar a tha e a’ freagairt no nach eil. Tha an taba dheth air endpoint Messages, agus chan eilear a’ tabhann roghainn nach gabh am modail taghte.
Còd Iarrtas a’ chòmhraidh làithrich mar chòd cURL, Python, Node no Go, air a thogail on chòmhradh agus na roghainnean aige. Tha an iuchair air a chlò-bhualadh mar YOUR_API_KEY. Gabhaidh an còd lethbhreac a dhèanamh dheth no fhosgladh ann an sealladh mòr.
Tachartasan An turn mu dheireadh mar a chaidh air an uèir: gach tachartas stream le a dheireadh-ama agus criathrag, am freagairt cruinnichte, headers an fhreagairt (x-request-id, content-type, retry-after, date) agus bodhaig an iarrtais. Tha iad sin air an cumail gus an ath-luchdaich an duilleag.

Sgrùdaidhean cuir-a-steach

Thèid na luachan a sgrìobhas tu a sgrùdadh mus tèid iarrtas a chur. Thèid luach taobh a-muigh na rainse a chomharrachadh aig an raon aige, agus thèid cur a chumail air ais gus an tèid a cheartachadh.

Roghainn Sgrùdadh
Tokens cuir-a-mach as motha Àireamh slàn bho 1 gu max_output_tokens a’ mhodail.
Temperature Àireamh bho 0 gu 2. Ma tha e falamh, thèid an raon fhàgail às an iarrtas.
top_p Àireamh bho 0 gu 1. Ma tha e falamh, thèid an raon fhàgail às an iarrtas.
seed Àireamh slàn.
Sreathan stad 4 aig a’ char as motha, air an sgaradh le cromagan.
response_format Feumaidh e a bhith fear a ghabhas am modail taghte. Thèid còmhradh a ghluaiseadh gu modail às aonais json_schema no às aonais response_format a chumail air ais còmhla ris an adhbhar.
Dealbhan Thèid an toirt às an teachdaireachd nuair a dh’atharraicheas tu gu modail nach gabh ach teacsa, le nòta.

Dèan coimeas eadar dà mhodail

Cuiridh Compare two models ann am clàr-taice More dàrna roghnaiche modail ris. Thèid gach teachdaireachd an uair sin chun an dà mhodail aig an aon àm, leis na h-aon roghainnean, agus bidh an dà fhreagairt ri taobh a chèile, air an comharrachadh A agus B. Faodaidh tu aon taobh a ghineadh às ùr leis fhèin. Nuair a ghairmeas aon taobh inneal, cumaidh an toradh a chuireas tu air adhart an taobh sin a-mhàin.

Co-roinn, às-phortaich agus in-phortaich

  • Pacaidhidh Copy share link an còmhradh dhan cheangal fhèin, anns a’ phàirt às dèidh #. Chan eil dad air a luchdadh suas. Thèid dealbhan, d’ iuchair agus mion-fhiosrachadh an run mu dheireadh fhàgail a-mach. Gheibh ge b’ e cò a dh’fhosglas an ceangal an còmhradh mar fhear ùr anns a’ playground aige fhèin.
  • Thèid còmhradh ro fhada airson ceangail a dhiùltadh le nòta. Luchdaich a-nuas e mar JSON na àite.
  • Sàbhailidh Download conversation JSON an còmhradh le na roghainnean aige mar fhaidhle. Fosglaidh Import JSON ann am panal nan còmhraidhean faidhle mar sin.
  • Dèanaidh Copy as cURL lethbhreac dhen iarrtas làithreach mar aon àithne cURL.

Dè a tha air a chumail càite

Dè Càite a bheil e air a chumail
Còmhraidhean, innealan sàbhailte, modailean o chionn ghoirid, co-dhealbhadh phanalan Anns a’ bhrobhsair seo. Chan eil iad air an cur gu Shannon agus chan lean iad thu gu inneal eile.
Iuchair API Ann an cuimhne an taba fhosgailte. Tha iuchair a chaidh a chur a-steach air falbh nuair a dh’ath-luchdaicheas an duilleag no nuair a dhùineas an taba. Nuair a tha thu air do chlàradh a-steach, thèid an iuchair a leughadh bhon chunntas agad gach turas.
Tachartasan stream, headers agus iarrtas an turn mu dheireadh Anns an duilleag fhosgailte, gus an ath-luchdaich i.
Iarrtasan Air an cur on bhrobhsair agad dhan API le d’ iuchair. Thèid an cunntadh an aghaidh do balance coltach ri iarrtas API sam bith eile.

Meur-chlàr

Iuchraichean Dè a nì e
Enter Cuir an teachdaireachd.
Shift + Enter Tòisich loidhne ùr.
Ctrl + K Fosgail pailead nan àitheantan: atharraich endpoint no modail, suidhich teamplaid shiostaim, tòisich còmhradh ùr, toglaich streaming, innealan no coimeas. Air Mac: ⌘ K.
Esc Stad am freagairt a tha ga sgrìobhadh, no dùin panal fosgailte air sgrìon chumhang.

Fosgail am Playground