Vai al contenuto
Playground API

Playground API

Interattivo

Prova ogni modello ed endpoint nel browser con la tua chiave: output in streaming, ispettore delle richieste e codice generato da incollare direttamente nella tua app.

Apri il Playground

Il playground è una console di chat per l'API, disponibile su /docs/playground. Parli con un modello, e il playground invia le stesse richieste che invierebbe il tuo codice: a uno dei tre endpoint, con il modello, il system prompt, i parametri e i tool che hai impostato. Ogni richiesta può essere riletta come codice e come eventi grezzi dello stream.

Inizio

  • Fornisci una chiave — Con l'accesso effettuato, il playground usa la chiave API del tuo account e mostra il tuo saldo. Senza accesso, scegli Aggiungi chiave e incolla una chiave: resta solo in questa scheda e non viene mai salvata.
  • Scegli un endpoint e un modello — La barra in alto contiene il selettore dell'endpoint e quello del modello. Una nuova conversazione parte su Chat Completions con shannon-3.
  • Invia un messaggio — Scrivi qui sotto e premi Invio. Ogni risposta entra nella conversazione, quindi il messaggio successivo la prosegue. La schermata vuota offre tre prompt di partenza e un esempio pronto di chiamata di tool.

Trovi e ruoti la tua chiave nella pagina Chiavi e utilizzo. Chiavi e utilizzo

Endpoint e modelli

Il selettore dell'endpoint decide quale formato di richiesta costruisce il playground. Puoi cambiarlo nel mezzo di una conversazione; i messaggi restano.

Endpoint Richiesta che invia Riferimento
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses Responses API
Messages POST /v1/messages Formato Anthropic

Il selettore dei modelli elenca ciò che restituisce GET /v1/models. Si può cercare, tiene in cima i tuoi modelli recenti e mostra per ogni modello il prezzo per 1M token, la finestra di contesto e i contrassegni per tool, input di immagini, ragionamento e output strutturato.

La conversazione

  • Le risposte arrivano nella conversazione in streaming man mano che vengono scritte. Il ragionamento del modello è mostrato in un blocco a parte che puoi comprimere.
  • Sotto ogni risposta: tempo al primo token, token al secondo, tempo trascorso, token di input e di output con le parti cached e di ragionamento, una stima del costo del turno, il motivo di fine e l'id della risposta.
  • Un tuo messaggio può essere modificato e inviato di nuovo da quel punto. Una risposta può essere rigenerata. Un messaggio può essere eliminato, e l'eliminazione può essere annullata per qualche secondo.
  • Interrompi o il tasto Esc interrompe una risposta in corso di scrittura.
  • Le immagini si allegano con il pulsante immagine, incollandole o trascinando un file, per i modelli che accettano immagini. Un'immagine viene ridimensionata a 1,568 pixel sul lato lungo prima dell'invio. Un file oltre 30 MB viene saltato.
  • Il composer e il system prompt mostrano un conteggio dei token. Per i modelli open-weight ospitati è il conteggio esatto di POST /v1/tokenize. Per gli altri modelli è una stima, contrassegnata da ≈.
  • Una richiesta fallita indica cosa fare dopo: impostare una chiave se la chiave è stata rifiutata, ricaricare se il saldo è esaurito, i secondi da attendere dopo troppe richieste, oppure un nuovo tentativo dopo un errore del server.

Impostazioni della richiesta

Il pulsante Impostazioni apre un pannello con sei schede. Le impostazioni appartengono alla conversazione: ogni conversazione conserva le proprie.

Scheda Cosa contiene
Sistema Il system prompt della conversazione, inviato con ogni richiesta. Cinque template lo compilano, e ne viene mostrato il conteggio dei token.
Parametri Token massimi in output, temperatura, top_p, livello di ragionamento, sequenze di stop, seed e gli interruttori per streaming e ricerca web. Un controllo per cui l'endpoint selezionato non ha un campo viene disattivato e contrassegnato.
Tool Le definizioni dei tool inviate con la richiesta: quattro preset (get_weather, read_file, run_shell, web_search) oppure una tua definizione come JSON, e tool_choice (auto, none, required oppure un tool per nome). Quando il modello chiama un tool, la conversazione mostra la chiamata con un riquadro per il risultato. Con Offri risultati di esempio attivo, un clic inserisce un risultato di esempio. Puoi anche digitare il tuo, poi inviarlo per proseguire il turno.
Strutturato response_format: text, json_object oppure json_schema con un nome di schema e uno schema JSON. Con uno schema impostato, l'ultima risposta viene verificata rispetto a esso e contrassegnata nella conversazione come conforme o non conforme. La scheda è disattivata sull'endpoint Messages, e un'opzione che il modello selezionato non accetta non viene offerta.
Codice La richiesta della conversazione corrente come codice cURL, Python, Node o Go, costruito dalla conversazione e dalle sue impostazioni. La chiave viene stampata come YOUR_API_KEY. Il codice può essere copiato o aperto in una vista ampia.
Eventi L'ultimo turno così come è passato sulla rete: ogni evento dello stream con il suo scostamento temporale e un filtro, la risposta assemblata, gli header della risposta (x-request-id, content-type, retry-after, date) e il corpo della richiesta. Restano conservati fino al ricaricamento della pagina.

Controlli sull'input

I valori che digiti vengono controllati prima dell'invio di una richiesta. Un valore fuori intervallo viene segnalato sul suo campo, e l'invio resta bloccato finché non lo correggi.

Impostazione Controllo
Token massimi in output Un numero intero da 1 a max_output_tokens del modello.
Temperatura Un numero da 0 a 2. Se vuoto, il campo viene omesso dalla richiesta.
top_p Un numero da 0 a 1. Se vuoto, il campo viene omesso dalla richiesta.
seed Un numero intero.
Sequenze di stop Al massimo 4, separate da virgole.
response_format Deve essere un valore accettato dal modello selezionato. Una conversazione spostata su un modello senza json_schema o senza response_format viene trattenuta, con il motivo.
Immagini Rimosse dal messaggio quando passi a un modello che accetta solo testo, con una nota.

Confronta due modelli

Confronta due modelli nel menu Altro aggiunge un secondo selettore di modello. Ogni messaggio va poi a entrambi i modelli nello stesso momento, con le stesse impostazioni, e le due risposte compaiono affiancate, contrassegnate A e B. Puoi rigenerare un solo lato. Quando un lato chiama un tool, il risultato che invii prosegue solo quel lato.

Condividi, esporta e importa

  • Copia link di condivisione comprime la conversazione nel link stesso, nella parte dopo #. Non viene caricato nulla. Le immagini, la tua chiave e i dettagli dell'ultima esecuzione sono esclusi. Chi apre il link riceve la conversazione come nuova conversazione nel proprio playground.
  • Una conversazione troppo lunga per un link viene rifiutata con una nota. Scaricala invece come JSON.
  • Scarica JSON conversazione salva la conversazione con le sue impostazioni in un file. Importa JSON nel pannello delle conversazioni apre un file di questo tipo.
  • Copia come cURL copia la richiesta corrente come un unico comando cURL.

Cosa è conservato dove

Cosa Dove è conservato
Conversazioni, tool salvati, modelli recenti, disposizione dei pannelli In questo browser. Non vengono inviate a Shannon e non ti seguono su un altro dispositivo.
Chiave API Nella memoria della scheda aperta. Una chiave incollata scompare quando la pagina viene ricaricata o la scheda viene chiusa. Con l'accesso effettuato, la chiave viene letta ogni volta dal tuo account.
Eventi dello stream, header e richiesta dell'ultimo turno Nella pagina aperta, fino al ricaricamento.
Richieste Inviate dal tuo browser all'API con la tua chiave. Vengono conteggiate sul tuo saldo come qualsiasi altra richiesta API.

Tastiera

Tasti Cosa fa
Enter Invia il messaggio.
Shift + Enter Va a capo.
Ctrl + K Apre la command palette: cambia endpoint o modello, imposta un template di sistema, avvia una nuova conversazione, attiva o disattiva streaming, tool o confronto. Su Mac: ⌘ K.
Esc Interrompe la risposta in corso di scrittura, oppure chiude un pannello aperto su uno schermo stretto.

Apri il Playground