API Playground
MifaneraseraAndramo ao amin'ny browser ny model sy endpoint rehetra amin'ny key-nao manokana — output streaming, request inspector, ary kaody noforonina azonao apetraka mivantana ao amin'ny app-nao.
Ny playground dia console chat ho an'ny API ao amin'ny /docs/playground. Miresaka amin'ny model ianao, ary mandefa ny fangatahana mitovy amin'izay alefan'ny kaody-nao ny playground: any amin'ny endpoint telo, miaraka amin'ny model, system prompt, parameter ary tools napetrakao. Ny fangatahana rehetra dia azo vakiana ho kaody sy ho stream event manta.
Fanombohana
- Omeo key — Rehefa tafiditra, ny playground dia mampiasa ny API key an'ny kaontinao ary mampiseho ny balance-nao. Raha tsy tafiditra, safidio ny Add key ary apetaho ny key: tazonina ao amin'ity tab ity ihany izy ary tsy voatahiry mihitsy.
- Misafidiana endpoint sy model — Ny bara etsy ambony dia misy ny endpoint switch sy ny model picker. Ny resaka vaovao dia manomboka amin'ny Chat Completions miaraka amin'ny
shannon-3. - Mandefa hafatra — Manorata eto ambany ary tsindrio Enter. Ny valiny tsirairay dia manampy ny resaka, ka ny hafatra manaraka dia manohy azy. Ny efijery foana dia manolotra prompt fanombohana telo sy ohatra tool-call vonona.
Ny key-nao dia hita sy azo soloina ao amin'ny pejy Keys & usage. Keys & usage
Endpoint sy model
Ny endpoint switch no mamaritra ny endrika fangatahana ataon'ny playground. Azonao ovaina eo afovoan'ny resaka; mijanona ny hafatra.
| Endpoint | Fangatahana alefany | Fanononana |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Anthropic |
Ny model picker dia mitanisa izay averin'ny GET /v1/models. Azo karohina izy, mitazona ny model vao nampiasainao eo ambony, ary mampiseho isaky ny model ny vidiny isaky ny token 1M, ny context window ary marika ho an'ny tools, input sary, reasoning ary structured output.
Ny resaka
- Ny valiny dia stream ao amin'ny thread rehefa soratana izy. Ny reasoning an'ny model dia aseho ao anaty block manokana azonao atopy.
- Eo ambanin'ny valiny tsirairay: ny fotoana hatramin'ny token voalohany, token isan-tsegondra, fotoana lany, input sy output token miaraka amin'ny ampahany cached sy reasoning, tombantombana ny vidin'ny fihodinana, ny finish reason ary ny id valiny.
- Ny hafatrao dia azo ovaina ary alefa indray manomboka amin'io teboka io. Ny valiny dia azo averina atao. Ny hafatra dia azo fafana, ary azo foanana ny famafana mandritra ny segondra vitsivitsy.
- Ny Stop na ny kibo Esc dia mamarana ny valiny izay soratana.
- Ny sary dia ampiarahina amin'ny bokotra sary, amin'ny fametahana na amin'ny fandefasana rakitra, ho an'ny model mandray sary. Ny sary dia ampihenana ho 1,568 pixel eo amin'ny sisiny lava alohan'ny handefasana. Ny rakitra mihoatra ny 30 MB dia lasa.
- Ny composer sy ny system prompt dia mampiseho ny isan'ny token. Ho an'ny model open-weight hosted dia ny isa marina avy amin'ny
POST /v1/tokenizeizany. Ho an'ny model hafa dia tombantombana, asiana marika≈. - Ny fangatahana tsy nahomby dia mampiseho izay tokony atao manaraka: mametraka key rehefa nolavina ny key, mampiditra credit rehefa lany ny balance, ny segondra hiandrasana aorian'ny fangatahana be loatra, na retry aorian'ny hadisoan'ny server.
Setting ny fangatahana
Ny bokotra Settings dia manokatra panel misy tab enina. Ny setting dia an'ny resaka: ny resaka tsirairay dia mitazona ny azy.
| Tab | Izay ao anatiny |
|---|---|
| System | Ny system prompt amin'ny resaka, alefa isaky ny fangatahana. Template dimy no mameno azy, ary aseho ny isan'ny token-ny. |
| Parameter | Max output tokens, temperature, top_p, reasoning effort, stop sequence, seed, ary ny switch ho an'ny streaming sy web search. Ny control tsy manana saha ao amin'ny endpoint voafidy dia atsahatra ary asiana marika. |
| Tools | Famaritana tool alefa miaraka amin'ny fangatahana: preset efatra (get_weather, read_file, run_shell, web_search) na ny famaritanao ho JSON, ary tool_choice (auto, none, required na tool iray araka ny anarana). Rehefa miantso tool ny model, ny thread dia mampiseho ny antso miaraka amin'ny boaty ho an'ny valiny. Rehefa mandeha ny Offer sample results, tsindrio indray mandeha dia feno ny valiny ohatra. Azonao soratana koa ny anao, avy eo alefaso hanohizana ny fihodinana. |
| Structured | response_format: text, json_object na json_schema miaraka amin'ny anaran'ny schema sy JSON schema. Rehefa misy schema, ny valiny farany dia hamarinina aminy ary asiana marika ao amin'ny thread hoe mifanaraka na tsia. Atsahatra ny tab ao amin'ny endpoint Messages, ary ny safidy tsy raisin'ny model voafidy dia tsy atolotra. |
| Kaody | Ny fangatahana amin'ny resaka ankehitriny ho kaody cURL, Python, Node na Go, noforonina avy amin'ny resaka sy ny setting-ny. Ny key dia aseho ho YOUR_API_KEY. Azo adika ny kaody na sokafana amin'ny fijery lehibe. |
| Events | Ny fihodinana farany araka ny nandehanany tamin'ny tamba-jotra: ny stream event rehetra miaraka amin'ny fotoana sy sivana, ny valiny natambatra, ny header valiny (x-request-id, content-type, retry-after, date) ary ny body ny fangatahana. Tazonina ireo mandra-pamerenana ny pejy. |
Fanamarinana ny input
Ny sanda soratanao dia hamarinina alohan'ny handefasana fangatahana. Ny sanda ivelan'ny faribolana dia asiana marika ao amin'ny sahany, ary tazonina ny fandefasana mandra-pahitsiana azy.
| Setting | Fanamarinana |
|---|---|
| Max output tokens | Isa manontolo manomboka amin'ny 1 hatramin'ny max_output_tokens an'ny model. |
| Temperature | Isa manomboka amin'ny 0 hatramin'ny 2. Raha foana dia tsy ampidirina ao amin'ny fangatahana ny saha. |
top_p | Isa manomboka amin'ny 0 hatramin'ny 1. Raha foana dia tsy ampidirina ao amin'ny fangatahana ny saha. |
seed | Isa manontolo. |
| Stop sequence | 4 farafahabetsany, sarahin'ny faingo. |
response_format | Tsy maintsy iray raisin'ny model voafidy. Ny resaka nafindra tamin'ny model tsy manana json_schema na response_format dia tazonina miaraka amin'ny antony. |
| Sary | Esorina amin'ny hafatra rehefa mifindra amin'ny model mandray soratra ihany, miaraka amin'ny fanamarihana. |
Fampitahana model roa
Ny Compare two models ao amin'ny menu More dia manampy model picker faharoa. Ny hafatra tsirairay dia mandeha amin'ny model roa miaraka, miaraka amin'ny setting mitovy, ary ny valiny roa dia eo akaikin'ny iray, misy marika A sy B. Azonao averina atao ny iray ihany. Rehefa miantso tool ny iray, ny valiny alefanao dia manohy an'io lafiny io ihany.
Fizarana, export ary import
- Ny Copy share link dia mametaka ny resaka ao anaty rohy mihitsy, ao amin'ny ampahany aorian'ny
#. Tsy misy alefa ho any amin'ny server. Ny sary, ny key-nao ary ny antsipirian'ny fampandehanana farany dia tsy ampidirina. Izay mamoha ny rohy dia mahazo ny resaka ho resaka vaovao ao amin'ny playground-ny. - Ny resaka lava loatra ho an'ny rohy dia lavina miaraka amin'ny fanamarihana. Ampidino ho JSON fa tsy izany.
- Ny Download conversation JSON dia mitahiry ny resaka miaraka amin'ny setting-ny ho rakitra. Ny Import JSON ao amin'ny panel resaka dia manokatra rakitra toy izany.
- Ny Copy as cURL dia mandika ny fangatahana ankehitriny ho baiko cURL iray.
Izay voatahiry any amin'ny toerana
| Inona | Izay itahirizana azy |
|---|---|
| Resaka, tools voatahiry, model vao nampiasaina, endrika panel | Ao amin'ity browser ity. Tsy alefa any amin'i Shannon ary tsy manaraka anao any amin'ny fitaovana hafa. |
| API key | Ao amin'ny memory an'ny tab misokatra. Ny key nopetaina dia very rehefa averina ny pejy na akatona ny tab. Rehefa tafiditra, ny key dia vakiana avy amin'ny kaontinao isaky ny mandeha. |
| Stream event, header ary fangatahana amin'ny fihodinana farany | Ao amin'ny pejy misokatra, mandra-pamerenana azy. |
| Fangatahana | Alefa avy amin'ny browser-nao mankany amin'ny API miaraka amin'ny key-nao. Kajina amin'ny balance-nao tahaka ny fangatahana API hafa. |
Kibo
| Bokotra | Izay ataony |
|---|---|
Enter | Alefaso ny hafatra. |
Shift + Enter | Manomboka andalana vaovao. |
Ctrl + K | Sokafy ny command palette: manova endpoint na model, mametraka system template, manomboka resaka vaovao, mamadika streaming, tools na compare. Amin'ny Mac: ⌘ K. |
Esc | Atsaharo ny valiny izay soratana, na akaty ny panel misokatra amin'ny efijery tery. |