Salti al la enhavo
API Ludejo

API Ludejo

Interaga

Provu ĉiun modelon kaj endpoint en la retumilo per via propra ŝlosilo — streaming-eligo, inspektilo de petoj kaj generita kodo, kiun vi povas rekte alglui en vian aplikaĵon.

Lanĉi Playground

La playground estas babila konzolo por la API ĉe /docs/playground. Vi parolas kun modelo, kaj la playground sendas la samajn petojn, kiujn sendus via kodo: al unu el tri endpoints, kun la modelo, sistema prompt, parametroj kaj iloj, kiujn vi agordas. Ĉiu peto povas esti relegata kiel kodo kaj kiel krudaj eventoj de fluo.

Komenco

  • Donu al ĝi ŝlosilon — Ensalutinta, la playground uzas la API-ŝlosilon de via konto kaj montras vian saldon. Ne ensalutinta, elektu Aldoni ŝlosilon kaj algluu ŝlosilon: ĝi estas konservata nur en ĉi tiu langeto kaj neniam estas savata.
  • Elektu endpoint kaj modelon — La supra stango enhavas la ŝaltilon de endpoint kaj la modelelektilon. Nova konversacio komenciĝas ĉe Chat Completions kun shannon-3.
  • Sendu mesaĝon — Tajpu malsupre kaj premu Enter. Ĉiu respondo aliĝas al la konversacio, do la sekva mesaĝo daŭrigas ĝin. La malplena ekrano proponas tri komencajn promptojn kaj pretan ekzemplon de voko de ilo.

Vi trovas kaj rotacias vian ŝlosilon en la paĝo Keys & usage. Ŝlosiloj kaj uzado

Endpoints kaj modeloj

La ŝaltilo de endpoint decidas kiun formaton de peto la playground konstruas. Vi povas ŝanĝi ĝin meze de konversacio; la mesaĝoj restas.

Endpoint Peto, kiun ĝi sendas Referenco
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Anthropic

La modelelektilo listigas tion, kion redonas GET /v1/models. Oni povas serĉi en ĝi, ĝi tenas viajn lastatempajn modelojn supre, kaj montras por ĉiu modelo la prezon por 1M tokenoj, la kuntekstan fenestron kaj markojn por iloj, bilda enigo, rezonado kaj strukturita eligo.

La konversacio

  • Respondoj fluas en la konversacion dum ili estas skribataj. La rezonado de la modelo estas montrata en propra bloko, kiun vi povas faldi.
  • Sub ĉiu respondo: tempo ĝis la unua tokeno, tokenoj por sekundo, pasinta tempo, enigaj kaj eligaj tokenoj kun la kaŝmemoritaj kaj raciumaj partoj, takso de la kosto de la vico, la kialo de fino kaj la id de respondo.
  • Via mesaĝo povas esti redaktata kaj resendata ekde tiu punkto. Respondo povas esti regenerata. Mesaĝo povas esti forigata, kaj la forigo povas esti malfarata dum kelkaj sekundoj.
  • Ĉesi aŭ la klavo Esc finas respondon, kiu estas skribata.
  • Bildoj estas almetataj per la bildobutono, per algluo aŭ per demeto de dosiero, por modeloj, kiuj akceptas bildojn. Bildo estas skalata al 1,568 pikseloj ĉe sia longa rando antaŭ ol ĝi estas sendata. Dosiero super 30 MB estas preterlasata.
  • La skribilo kaj la sistema prompt montras nombron de tokenoj. Ĉe la gastigitaj malfermpezaj modeloj ĝi estas la preciza nombro el POST /v1/tokenize. Ĉe la aliaj modeloj ĝi estas takso, markita per ≈.
  • Malsukcesa peto montras kion fari poste: agordi ŝlosilon kiam la ŝlosilo estis rifuzita, replenigi kiam la saldo estas uzita, la sekundojn por atendi post tro multaj petoj, aŭ reprovon post servila eraro.

Agordoj de peto

La butono Agordoj malfermas panelon kun ses langetoj. Agordoj apartenas al la konversacio: ĉiu konversacio tenas siajn proprajn.

Langeto Kion ĝi tenas
Sistemo La sistema prompt de la konversacio, sendata kun ĉiu peto. Kvin ŝablonoj plenigas ĝin, kaj ĝia nombro de tokenoj estas montrata.
Parametroj Maksimumaj eligaj tokenoj, temperaturo, top_p, raciuma peno, haltaj sekvencoj, seed, kaj la ŝaltiloj por streaming kaj retserĉo. Kontrolo, por kiu la elektita endpoint ne havas kampon, estas malŝaltita kaj markita.
Iloj Difinoj de iloj senditaj kun la peto: kvar antaŭdifinoj (get_weather, read_file, run_shell, web_search) aŭ via propra difino kiel JSON, kaj tool_choice (auto, none, required aŭ unu ilo laŭ nomo). Kiam la modelo vokas ilon, la konversacio montras la vokon kun skatolo por la rezulto. Kun Proponi ekzemplajn rezultojn ŝaltita, unu klako plenigas ekzemplan rezulton. Vi povas ankaŭ tajpi propran, poste sendi ĝin por daŭrigi la vicon.
Strukturita response_format: text, json_object aŭ json_schema kun nomo de skemo kaj JSON-skemo. Kun skemo agordita, la lasta respondo estas kontrolata kontraŭ ĝi kaj markata en la konversacio kiel kongrua aŭ ne. La langeto estas malŝaltita ĉe la endpoint Messages, kaj opcio, kiun la elektita modelo ne akceptas, ne estas proponata.
Kodo La peto de la nuna konversacio kiel kodo cURL, Python, Node aŭ Go, konstruita el la konversacio kaj ĝiaj agordoj. La ŝlosilo estas presita kiel YOUR_API_KEY. La kodo povas esti kopiita aŭ malfermita en granda vido.
Eventoj La lasta vico tia, kia ĝi iris tra la drato: ĉiu evento de fluo kun sia tempodiferenco kaj filtrilo, la kunmetita respondo, la kapoj de respondo (x-request-id, content-type, retry-after, date) kaj la korpo de peto. Ili estas konservataj ĝis la paĝo reŝargiĝas.

Kontroloj de enigo

Valoroj, kiujn vi tajpas, estas kontrolataj antaŭ ol peto estas sendata. Valoro ekster la intervalo estas markita ĉe sia kampo, kaj sendado estas retenita ĝis ĝi estas korektita.

Agordo Kontrolo
Maksimumaj eligaj tokenoj Tuta nombro de 1 ĝis la max_output_tokens de la modelo.
Temperaturo Nombro de 0 ĝis 2. Malplena lasas la kampon ekster la peto.
top_p Nombro de 0 ĝis 1. Malplena lasas la kampon ekster la peto.
seed Tuta nombro.
Haltaj sekvencoj Maksimume 4, apartigitaj per komoj.
response_format Devas esti unu, kiun la elektita modelo akceptas. Konversacio transigita al modelo sen json_schema aŭ sen response_format estas retenita kun la kialo.
Bildoj Forigitaj el la mesaĝo kiam vi ŝaltas al modelo, kiu akceptas nur tekston, kun noto.

Kompari du modelojn

Kompari du modelojn en la menuo Pli aldonas duan modelelektilon. Ĉiu mesaĝo tiam iras al ambaŭ modeloj samtempe, kun la samaj agordoj, kaj la du respondoj staras flank-al-flanke, markitaj A kaj B. Vi povas regeneri unu flankon sole. Kiam unu flanko vokas ilon, la rezulto, kiun vi sendas, daŭrigas nur tiun flankon.

Kundivido, eksporto kaj importo

  • Kopii kunhavig-ligilon pakas la konversacion en la ligilon mem, en la parto post #. Nenio estas alŝutata. Bildoj, via ŝlosilo kaj la detaloj de la lasta rulo estas lasitaj ekster. Kiu ajn malfermas la ligilon, ricevas la konversacion kiel novan en sia propra playground.
  • Konversacio tro longa por ligilo estas rifuzata kun noto. Elŝutu ĝin anstataŭe kiel JSON.
  • Elŝuti konversacion kiel JSON konservas la konversacion kun ĝiaj agordoj kiel dosieron. Importi JSON en la panelo de konversacioj malfermas tian dosieron.
  • Kopii kiel cURL kopias la nunan peton kiel unu komandon cURL.

Kio estas konservata kie

Kio Kie ĝi estas konservata
Konversacioj, konservitaj iloj, lastatempaj modeloj, aranĝo de paneloj En ĉi tiu retumilo. Ili ne estas senditaj al Shannon kaj ne sekvas vin al alia aparato.
API-ŝlosilo En la memoro de la malfermita langeto. Algluita ŝlosilo malaperas kiam la paĝo reŝargiĝas aŭ la langeto fermiĝas. Ensalutinta, la ŝlosilo estas legata el via konto ĉiufoje.
Eventoj de fluo, kapoj kaj peto de la lasta vico En la malfermita paĝo, ĝis ĝi reŝargiĝas.
Petoj Senditaj el via retumilo al la API kun via ŝlosilo. Ili estas kalkulataj kontraŭ via saldo kiel ajna alia API-peto.

Klavaro

Klavoj Kion ĝi faras
Enter Sendi la mesaĝon.
Shift + Enter Komenci novan linion.
Ctrl + K Malfermi la komandan paletron: ŝanĝi endpoint aŭ modelon, agordi sisteman ŝablonon, komenci novan konversacion, baskuli streaming, ilojn aŭ komparon. Ĉe Mac: ⌘ K.
Esc Haltigi la respondon, kiu estas skribata, aŭ fermi malfermitan panelon sur mallarĝa ekrano.

Lanĉi Playground