Tsallake zuwa abun ciki
Filin Wasan API

Filin Wasan API

Ma'amala

Ku gwada kowane model da endpoint a cikin browser da maɓallinku — streaming output, request inspector, da code da aka samar wanda za ku iya liƙawa kai tsaye a app ɗinku.

Buɗe Playground

Playground na'urar taɗi ce ta API a /docs/playground. Kuna magana da model, kuma playground yana aika requests iri ɗaya da code ɗinku zai aika: zuwa ɗaya daga endpoints uku, da model, system prompt, parameters da tools da kuka saita. Ana iya karanta kowace request a matsayin code da kuma raw stream events.

Farawa

  • Ba shi maɓalli — Idan kun shiga, playground yana amfani da maɓallin API na asusunku kuma yana nuna balance ɗinku. Idan ba ku shiga ba, ku zaɓi Ƙara maɓalli ku liƙa maɓalli: ana ajiye shi a wannan tab ɗin kaɗai kuma ba a taɓa adana shi ba.
  • Zaɓi endpoint da model — Sandar sama tana ɗauke da maɓallin sauya endpoint da model picker. Sabuwar tattaunawa tana farawa a Chat Completions da shannon-3.
  • Aika saƙo — Ku rubuta a ƙasa ku danna Enter. Kowace amsa tana shiga tattaunawar, don haka saƙo na gaba yana ci gaba da ita. Allo mara komai yana ba da prompts uku na farawa da misalin kiran tool a shirye.

Kuna samun da canza maɓallinku a shafin Maɓallai & amfani. Maɓallai & amfani

Endpoints da models

Maɓallin sauya endpoint yana yanke shawarar tsarin request da playground ke ginawa. Kuna iya canza shi a tsakiyar tattaunawa; saƙonni suna nan.

Endpoint Request da yake aikawa Bayani
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Tsarin Anthropic

Model picker yana lissafa abin da GET /v1/models ke mayarwa. Ana iya bincika shi, yana riƙe models ɗinku na kwanan nan a sama, kuma yana nuna ga kowane model farashi kowace tokens 1M, context window da alamomin tools, image input, reasoning da structured output.

Tattaunawar

  • Amsoshi suna shiga thread ta streaming yayin da ake rubuta su. Ana nuna reasoning na model a block na kansa wanda za ku iya naɗewa.
  • A ƙarƙashin kowace amsa: lokaci zuwa token na farko, tokens a daƙiƙa, lokacin da ya wuce, input da output tokens tare da sassan cached da reasoning, kimantawar kuɗin turn, dalilin ƙarewa da response id.
  • Ana iya gyara saƙonku a sake aikawa daga wannan wuri. Ana iya sake samar da amsa. Ana iya share saƙo, kuma ana iya warware sharewar cikin ƴan daƙiƙu.
  • Tsaya ko maɓallin Esc yana kawo ƙarshen amsar da ake rubutawa.
  • Ana haɗa hotuna da maɓallin hoto, ta liƙawa ko ta jefa fayil, ga models da ke karɓar hotuna. Ana rage hoto zuwa pixels 1,568 a dogon gefensa kafin a aika. Ana tsallake fayil da ya wuce 30 MB.
  • Composer da system prompt suna nuna adadin tokens. Ga hosted open-weight models shi ne ainihin ƙirgi daga POST /v1/tokenize. Ga sauran models kimantawa ce, an alamta da ≈.
  • Request da ya gaza yana nuna abin da za a yi na gaba: saita maɓalli idan an ƙi maɓallin, ƙara credit idan balance ya ƙare, daƙiƙun jira bayan requests da yawa, ko sake gwadawa bayan kuskuren server.

Saitunan request

Maɓallin Saituna yana buɗe panel mai tabs shida. Saituna na tattaunawa ne: kowace tattaunawa tana riƙe nata.

Tab Abin da yake ɗauka
System System prompt na tattaunawar, ana aika shi da kowace request. Templates biyar suna cika shi, kuma ana nuna adadin tokens ɗinsa.
Parameters Max output tokens, temperature, top_p, reasoning effort, stop sequences, seed, da maɓallan kunnawa na streaming da binciken yanar gizo. Ikon da endpoint da aka zaɓa ba shi da field a gare shi ana kashe shi kuma a alamta shi.
Tools Ma'anar tools da ake aikawa da request: presets huɗu (get_weather, read_file, run_shell, web_search) ko ma'anarku a matsayin JSON, da tool_choice (auto, none, required ko tool ɗaya da suna). Idan model ya kira tool, thread yana nuna kiran tare da akwati don sakamakon. Da Bayar da samfurin sakamako a kunne, danna ɗaya yana cika samfurin sakamako. Kuna iya rubuta naku ma, sannan ku aika shi don ci gaba da turn.
Structured response_format: text, json_object ko json_schema tare da sunan schema da JSON schema. Idan an saita schema, ana duba amsa ta ƙarshe da ita kuma a alamta a thread ko ta dace ko a'a. An kashe tab ɗin a endpoint na Messages, kuma zaɓin da model da aka zaɓa ba ya karɓa ba a bayar da shi.
Code Request na tattaunawar yanzu a matsayin code na cURL, Python, Node ko Go, wanda aka gina daga tattaunawar da saitunanta. Ana buga maɓalli a matsayin YOUR_API_KEY. Ana iya kwafar code ko buɗe shi a babban gani.
Events Turn na ƙarshe yadda ya bi hanya: kowane stream event tare da lokacin offset ɗinsa da tace, amsar da aka haɗa, headers na amsa (x-request-id, content-type, retry-after, date) da jikin request. Ana ajiye waɗannan har sai shafin ya sake lodawa.

Duba input

Ana duba ƙimomin da kuka rubuta kafin a aika request. Ƙimar da ta wuce kewaye ana alamta ta a field ɗinta, kuma ana riƙe aikawa har sai an gyara ta.

Saiti Dubawa
Max output tokens Cikakkiyar lamba daga 1 zuwa max_output_tokens na model.
Temperature Lamba daga 0 zuwa 2. Idan babu komai ana bar field ɗin daga request.
top_p Lamba daga 0 zuwa 1. Idan babu komai ana bar field ɗin daga request.
seed Cikakkiyar lamba.
Stop sequences Mafi yawa 4, an raba su da waƙafi.
response_format Dole ya zama wanda model da aka zaɓa yake karɓa. Tattaunawar da aka mayar zuwa model ba tare da json_schema ko ba tare da response_format ba ana riƙe ta da dalili.
Hotuna Ana cire su daga saƙon idan kun sauya zuwa model da ke karɓar rubutu kaɗai, tare da bayani.

Kwatanta models biyu

Kwatanta models biyu a menu na Ƙari yana ƙara model picker na biyu. Kowane saƙo sai ya tafi zuwa duka models a lokaci guda, da saituna iri ɗaya, kuma amsoshin biyu suna gefe da gefe, an alamta su A da B. Kuna iya sake samar da gefe ɗaya kaɗai. Idan gefe ɗaya ya kira tool, sakamakon da kuka aika yana ci gaba da wannan gefen kaɗai.

Rabawa, fitarwa da shigo da

  • Kwafa hanyar rabawa yana cusa tattaunawar cikin hanyar da kanta, a sashen bayan #. Ba a loda komai ba. Ana bar hotuna, maɓallinku da cikakkun bayanan gudu na ƙarshe. Duk wanda ya buɗe hanyar yana samun tattaunawar a matsayin sabuwa a playground ɗinsa.
  • Tattaunawar da ta yi tsawo da yawa ga hanya ana ƙin ta tare da bayani. Ku zazzage ta a matsayin JSON maimakon haka.
  • Zazzage JSON na tattaunawa yana adana tattaunawar tare da saitunanta a matsayin fayil. Shigo da JSON a panel na tattaunawa yana buɗe irin wannan fayil.
  • Kwafa a matsayin cURL yana kwafar request na yanzu a matsayin umarnin cURL ɗaya.

Abin da ake ajiyewa a ina

Menene Inda ake ajiye shi
Tattaunawa, tools da aka adana, models na kwanan nan, tsarin panel A wannan browser ɗin. Ba a aika su zuwa Shannon ba kuma ba sa bin ku zuwa wata na'ura.
Maɓallin API A ƙwaƙwalwar buɗaɗɗen tab. Maɓallin da aka liƙa yana ɓacewa idan shafin ya sake lodawa ko tab ɗin ya rufe. Idan kun shiga, ana karanta maɓallin daga asusunku kowane lokaci.
Stream events, headers da request na turn na ƙarshe A buɗaɗɗen shafi, har sai ya sake lodawa.
Requests Ana aika su daga browser ɗinku zuwa API da maɓallinku. Ana ƙirga su a balance ɗinku kamar kowace request ta API.

Keyboard

Maɓallai Abin da yake yi
Enter Aika saƙon.
Shift + Enter Fara sabon layi.
Ctrl + K Buɗe command palette: sauya endpoint ko model, saita system template, fara sabuwar tattaunawa, kunna ko kashe streaming, tools ko kwatanta. A Mac: ⌘ K.
Esc Dakatar da amsar da ake rubutawa, ko rufe buɗaɗɗen panel a ƙaramin allo.

Buɗe Playground