Playground API
InteractivÎncearcă fiecare model și endpoint în browser, cu propria cheie — ieșire în streaming, inspector de cereri și cod generat pe care îl poți lipi direct în aplicația ta.
Playground-ul este o consolă de chat pentru API, la /docs/playground. Vorbești cu un model, iar playground-ul trimite aceleași cereri pe care le-ar trimite codul tău: către unul dintre cele trei endpoint-uri, cu modelul, system prompt-ul, parametrii și instrumentele pe care le setezi. Fiecare cerere poate fi citită înapoi ca cod și ca evenimente brute de stream.
Început
- Dă-i o cheie — Autentificat, playground-ul folosește cheia API a contului tău și îți arată soldul. Neautentificat, alege Adaugă cheie și lipește o cheie: se păstrează doar în acest tab și nu este salvată niciodată.
- Alege un endpoint și un model — Bara de sus conține comutatorul de endpoint și selectorul de modele. O conversație nouă începe pe Chat Completions cu
shannon-3. - Trimite un mesaj — Tastează mai jos și apasă Enter. Fiecare răspuns se adaugă la conversație, deci următorul mesaj o continuă. Ecranul gol oferă trei prompturi de start și un exemplu gata de apel de instrument.
Îți găsești și îți schimbi cheia pe pagina Keys & usage. Chei și utilizare
Endpoint-uri și modele
Comutatorul de endpoint stabilește ce format de cerere construiește playground-ul. Îl poți schimba în mijlocul unei conversații; mesajele rămân.
| Endpoint | Cererea pe care o trimite | Referință |
|---|---|---|
| Chat Completions | POST /v1/chat/completions | Chat Completions |
| Responses | POST /v1/responses | Responses API |
| Messages | POST /v1/messages | Format Anthropic |
Selectorul de modele listează ce returnează GET /v1/models. Poate fi căutat, ține modelele tale recente deasupra și arată pentru fiecare model prețul per 1M token-uri, fereastra de context și marcaje pentru instrumente, intrare de imagini, raționament și ieșire structurată.
Conversația
- Răspunsurile curg în conversație pe măsură ce sunt scrise. Raționamentul modelului este afișat într-un bloc separat, pe care îl poți strânge.
- Sub fiecare răspuns: timpul până la primul token, token-uri pe secundă, timpul scurs, token-uri de intrare și de ieșire cu părțile din cache și de raționament, o estimare a costului rundei, motivul de finalizare și id-ul răspunsului.
- Un mesaj al tău poate fi editat și trimis din nou din acel punct. Un răspuns poate fi regenerat. Un mesaj poate fi șters, iar ștergerea poate fi anulată câteva secunde.
- Oprește sau tasta Esc oprește un răspuns care se scrie.
- Imaginile se atașează cu butonul de imagine, prin lipire sau prin glisarea unui fișier, pentru modelele care acceptă imagini. O imagine este redusă la 1,568 de pixeli pe latura lungă înainte de trimitere. Un fișier peste 30 MB este omis.
- Compozitorul și system prompt-ul arată un număr de token-uri. Pentru modelele open-weight găzduite este numărul exact din
POST /v1/tokenize. Pentru celelalte modele este o estimare, marcată cu≈. - O cerere eșuată arată ce să faci în continuare: setează o cheie când cheia a fost respinsă, reîncarcă când soldul este epuizat, secundele de așteptat după prea multe cereri sau o reîncercare după o eroare de server.
Setări cerere
Butonul Setări deschide un panou cu șase tab-uri. Setările aparțin conversației: fiecare conversație le păstrează pe ale ei.
| Tab | Ce conține |
|---|---|
| Sistem | System prompt-ul conversației, trimis cu fiecare cerere. Cinci șabloane îl completează, iar numărul lui de token-uri este afișat. |
| Parametri | Max tokens de ieșire, temperatură, top_p, efort de raționament, secvențe de oprire, seed și comutatoarele pentru streaming și căutare web. Un control pentru care endpoint-ul selectat nu are câmp este dezactivat și marcat. |
| Instrumente | Definițiile instrumentelor trimise cu cererea: patru presetări (get_weather, read_file, run_shell, web_search) sau propria ta definiție ca JSON, și tool_choice (auto, none, required sau un instrument după nume). Când modelul apelează un instrument, conversația arată apelul cu o casetă pentru rezultat. Cu Oferă rezultate de exemplu pornit, un clic completează un rezultat de exemplu. Poți și să scrii rezultatul tău, apoi să îl trimiți pentru a continua runda. |
| Structurat | response_format: text, json_object sau json_schema cu un nume de schemă și o schemă JSON. Cu o schemă setată, ultimul răspuns este verificat în raport cu ea și marcat în conversație ca potrivit sau nu. Tab-ul este dezactivat pe endpoint-ul Messages, iar o opțiune pe care modelul selectat nu o acceptă nu este oferită. |
| Cod | Cererea conversației curente ca cod cURL, Python, Node sau Go, construit din conversație și setările ei. Cheia este afișată ca YOUR_API_KEY. Codul poate fi copiat sau deschis într-o vedere mare. |
| Evenimente | Ultima rundă așa cum a circulat pe rețea: fiecare eveniment al stream-ului cu decalajul de timp și un filtru, răspunsul asamblat, header-ele răspunsului (x-request-id, content-type, retry-after, date) și corpul cererii. Acestea se păstrează până la reîncărcarea paginii. |
Verificări ale intrării
Valorile pe care le tastezi sunt verificate înainte de trimiterea unei cereri. O valoare în afara intervalului este marcată la câmpul ei, iar trimiterea este oprită până la corectare.
| Setare | Verificare |
|---|---|
| Max tokens de ieșire | Un număr întreg de la 1 până la max_output_tokens al modelului. |
| Temperatură | Un număr de la 0 la 2. Gol, câmpul este omis din cerere. |
top_p | Un număr de la 0 la 1. Gol, câmpul este omis din cerere. |
seed | Un număr întreg. |
| Secvențe de oprire | Cel mult 4, separate prin virgulă. |
response_format | Trebuie să fie unul pe care îl acceptă modelul selectat. O conversație mutată la un model fără json_schema sau fără response_format este reținută, cu motivul. |
| Imagini | Eliminate din mesaj când treci la un model care acceptă doar text, cu o notă. |
Compararea a două modele
Compară două modele din meniul Mai mult adaugă un al doilea selector de model. Fiecare mesaj merge apoi la ambele modele în același timp, cu aceleași setări, iar cele două răspunsuri stau unul lângă altul, marcate A și B. Poți regenera o singură parte. Când o parte apelează un instrument, rezultatul pe care îl trimiți continuă doar acea parte.
Partajare, export și import
- Copiază link-ul de partajare împachetează conversația în link-ul însuși, în partea de după
#. Nu se încarcă nimic. Imaginile, cheia ta și detaliile ultimei rulări sunt omise. Cine deschide link-ul primește conversația ca una nouă, în propriul playground. - O conversație prea lungă pentru un link este refuzată, cu o notă. Descarcă-o în schimb ca JSON.
- Descarcă JSON-ul conversației salvează conversația cu setările ei ca fișier. Importă JSON din panoul de conversații deschide un astfel de fișier.
- Copiază ca cURL copiază cererea curentă ca o singură comandă cURL.
Ce se păstrează și unde
| Ce | Unde este păstrat |
|---|---|
| Conversații, instrumente salvate, modele recente, aspectul panourilor | În acest browser. Nu sunt trimise la Shannon și nu te urmează pe alt dispozitiv. |
| Cheie API | În memoria tab-ului deschis. O cheie lipită dispare când pagina se reîncarcă sau tab-ul se închide. Autentificat, cheia este citită din contul tău de fiecare dată. |
| Evenimentele stream-ului, header-ele și cererea ultimei runde | În pagina deschisă, până la reîncărcare. |
| Cereri | Trimise din browserul tău către API cu cheia ta. Se numără din soldul tău ca orice altă cerere API. |
Tastatură
| Taste | Ce face |
|---|---|
Enter | Trimite mesajul. |
Shift + Enter | Începe un rând nou. |
Ctrl + K | Deschide paleta de comenzi: schimbă endpoint-ul sau modelul, setează un șablon de system prompt, începe o conversație nouă, comută streaming, instrumente sau comparare. Pe Mac: ⌘ K. |
Esc | Oprește răspunsul care se scrie sau închide un panou deschis pe un ecran îngust. |