Joan edukira
API jolasgunea

API jolasgunea

Interaktiboa

Probatu modelo eta endpoint guztiak nabigatzailean zure gakoarekin — streaming irteera, eskaera-ikuskatzailea eta zure aplikazioan zuzenean itsats dezakezun kode sortua.

Abiarazi Playground-a

Playground-a APIaren txat-kontsola bat da, /docs/playground helbidean. Modelo batekin hitz egiten duzu, eta playground-ak zure kodeak bidaliko lituzkeen eskaera berberak bidaltzen ditu: hiru endpoint-etako batera, zuk ezarritako modelo, system prompt, parametro eta tresnekin. Eskaera bakoitza kode gisa eta stream-gertaera gordin gisa irakur daiteke berriro.

Hasi

  • Eman gako bat — Saioa hasita, playground-ak zure kontuaren API gakoa erabiltzen du eta zure saldoa erakusten du. Saioa hasi gabe, aukeratu Gehitu gakoa eta itsatsi gako bat: fitxa honetan bakarrik gordetzen da eta ez da inoiz gordetzen.
  • Aukeratu endpoint bat eta modelo bat — Goiko barran endpoint-aren aldatzailea eta modelo-hautatzailea daude. Elkarrizketa berri bat Chat Completions-en hasten da shannon-3 modeloarekin.
  • Bidali mezu bat — Idatzi behean eta sakatu Enter. Erantzun bakoitza elkarrizketan sartzen da, beraz hurrengo mezuak jarraitzen du. Pantaila hutsak hiru hasierako prompt eta tresna-dei adibide prest bat eskaintzen ditu.

Zure gakoa Gakoak eta erabilera orrialdean aurkitu eta birsor dezakezu. Gakoak eta erabilera

Endpoint-ak eta modeloak

Endpoint-aren aldatzaileak erabakitzen du playground-ak zein eskaera-formatu eraikitzen duen. Elkarrizketaren erdian alda dezakezu; mezuak mantentzen dira.

Endpoint-a Bidaltzen duen eskaera Erreferentzia
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API-a
Messages POST /v1/messages Anthropic

Modelo-hautatzaileak GET /v1/models-ek itzultzen duena zerrendatzen du. Bila daiteke, zure azken modeloak goian mantentzen ditu, eta modelo bakoitzeko 1M tokeneko prezioa, testuinguru-leihoa eta tresnen, irudi-sarreraren, arrazonamenduaren eta irteera egituratuaren markak erakusten ditu.

Elkarrizketa

  • Erantzunak elkarrizketan streamean sartzen dira idazten diren heinean. Modeloaren arrazonamendua bloke propio batean erakusten da, tolestu dezakezuna.
  • Erantzun bakoitzaren azpian: lehen tokenerako denbora, token segundoko, igarotako denbora, sarrera- eta irteera-tokenak cacheko eta arrazonamenduko zatiekin, txandaren kostuaren zenbatespena, amaiera-arrazoia eta erantzun-id-a.
  • Zure mezu bat editatu eta puntu horretatik berriro bidal daiteke. Erantzun bat birsor daiteke. Mezu bat ezabatu daiteke, eta ezabatzea segundo batzuetan desegin daiteke.
  • Gelditu edo Esc teklak idazten ari den erantzuna amaitzen du.
  • Irudiak irudi-botoiarekin, itsatsiz edo fitxategi bat jaregiz erantsten dira, irudiak hartzen dituzten modeloentzat. Irudi bat 1,568 pixelera eskalatzen da bere alde luzean bidali aurretik. 30 MB-tik gorako fitxategi bat saltatzen da.
  • Idazlekuak eta system prompt-ak token-kopurua erakusten dute. Pisu irekiko modelo ostatatuetan POST /v1/tokenize-ren kopuru zehatza da. Beste modeloetan zenbatespen bat da, ≈ ikurrez markatua.
  • Huts egindako eskaerak zer egin hurrengo erakusten du: ezarri gako bat gakoa ukatu denean, gehitu kreditua saldoa agortu denean, eskaera gehiegiren ondoren itxaron beharreko segundoak, edo berriz saiatzea zerbitzari-errore baten ondoren.

Eskaera-ezarpenak

Ezarpenak botoiak sei fitxa dituen panel bat irekitzen du. Ezarpenak elkarrizketarenak dira: elkarrizketa bakoitzak berea mantentzen du.

Fitxa Zer duen
System Elkarrizketaren system prompt-a, eskaera guztiekin bidaltzen dena. Bost txantiloik betetzen dute, eta bere token-kopurua erakusten da.
Parametroak Irteera-token gehienez, tenperatura, top_p, arrazonamendu-esfortzua, gelditze-sekuentziak, seed, eta streamingaren eta web bilaketaren etengailuak. Hautatutako endpoint-ak eremurik ez duen kontrol bat desaktibatuta eta markatuta dago.
Tresnak Eskaerarekin bidalitako tresna-definizioak: lau aurrezarpen (get_weather, read_file, run_shell, web_search) edo zure definizio propioa JSON gisa, eta tool_choice (auto, none, required edo tresna bat izenez). Modeloak tresna bati deitzen dionean, elkarrizketak deia erakusten du emaitzarako kutxa batekin. Eskaini lagin-emaitzak aktibatuta, klik batek lagin-emaitza bat betetzen du. Zurea ere idatz dezakezu, eta gero bidali txandak jarrai dezan.
Egituratua response_format: text, json_object edo json_schema eskema-izen eta JSON eskema batekin. Eskema bat ezarrita, azken erantzuna haren aurka egiaztatzen da eta elkarrizketan bat datorren ala ez markatzen da. Fitxa desaktibatuta dago Messages endpoint-ean, eta hautatutako modeloak hartzen ez duen aukera ez da eskaintzen.
Kodea Uneko elkarrizketaren eskaera cURL, Python, Node edo Go kode gisa, elkarrizketatik eta bere ezarpenetatik eraikia. Gakoa YOUR_API_KEY gisa inprimatzen da. Kodea kopiatu edo ikuspegi handi batean ireki daiteke.
Gertaerak Azken txanda hari gainetik joan zen bezala: stream-gertaera bakoitza bere denbora-desplazamenduarekin eta iragazki batekin, erantzun osatua, erantzun-goiburuak (x-request-id, content-type, retry-after, date) eta eskaera-gorputza. Hauek orrialdea birkargatu arte gordetzen dira.

Sarrera-egiaztapenak

Idazten dituzun balioak egiaztatzen dira eskaera bidali aurretik. Tartetik kanpoko balioa bere eremuan markatzen da, eta bidalketa atzeratzen da zuzendu arte.

Ezarpena Egiaztapena
Irteera-token gehienez 1etik modeloaren max_output_tokens-era bitarteko zenbaki oso bat.
Tenperatura 0tik 2ra bitarteko zenbaki bat. Hutsik utziz gero eremua eskaeratik kanpo geratzen da.
top_p 0tik 1era bitarteko zenbaki bat. Hutsik utziz gero eremua eskaeratik kanpo geratzen da.
seed Zenbaki oso bat.
Gelditze-sekuentziak 4 gehienez, komaz bereiziak.
response_format Hautatutako modeloak hartzen duen bat izan behar da. json_schema edo response_format ez duen modelo batera eramandako elkarrizketa atzeratu egiten da, arrazoiarekin.
Irudiak Mezutik kentzen dira testua bakarrik hartzen duen modelo batera aldatzen duzunean, ohar batekin.

Bi modelo alderatzea

Moldatu bi modelo Gehiago menuan bigarren modelo-hautatzaile bat gehitzen du. Mezu bakoitza orduan bi modeloetara doa aldi berean, ezarpen berberekin, eta bi erantzunak aldamenean daude, A eta B bezala markatuta. Alde bat bakarrik birsor dezakezu. Alde batek tresna bati deitzen dionean, bidaltzen duzun emaitzak alde hori bakarrik jarraitzen du.

Partekatu, esportatu eta inportatu

  • Kopiatu partekatzeko esteka elkarrizketa estekan bertan sartzen du, # ondorengo zatian. Ez da ezer igotzen. Irudiak, zure gakoa eta azken exekuzioaren xehetasunak kanpoan uzten dira. Esteka irekitzen duenak elkarrizketa berri gisa jasotzen du bere playground-ean.
  • Esteka baterako luzeegia den elkarrizketa ohar batekin ukatzen da. Deskargatu JSON gisa horren ordez.
  • Deskargatu elkarrizketaren JSON-a elkarrizketa bere ezarpenekin fitxategi gisa gordetzen du. Elkarrizketen paneleko Inportatu JSON aukerak halako fitxategi bat irekitzen du.
  • Kopiatu cURL gisa uneko eskaera cURL komando bakar gisa kopiatzen du.

Zer non gordetzen den

Zer Non gordetzen den
Elkarrizketak, gordetako tresnak, azken modeloak, panelaren diseinua Nabigatzaile honetan. Ez dira Shannon-era bidaltzen eta ez zaituzte beste gailu batera jarraitzen.
API gakoa Irekitako fitxaren memorian. Itsatsitako gakoa desagertzen da orrialdea birkargatzean edo fitxa ixtean. Saioa hasita, gakoa zure kontutik irakurtzen da aldi bakoitzean.
Azken txandako stream-gertaerak, goiburuak eta eskaera Irekitako orrian, birkargatu arte.
Eskaerak Zure nabigatzailetik APIra bidaliak zure gakoarekin. Zure saldoaren kontura kontatzen dira beste edozein API eskaera bezala.

Teklatua

Teklak Zer egiten duen
Enter Bidali mezua.
Shift + Enter Hasi lerro berri bat.
Ctrl + K Ireki komando-paleta: aldatu endpoint-a edo modeloa, ezarri system txantiloi bat, hasi elkarrizketa berri bat, aktibatu streaminga, tresnak edo alderaketa. Mac-en: ⌘ K.
Esc Gelditu idazten ari den erantzuna, edo itxi irekitako panel bat pantaila estuan.

Abiarazi Playground-a