Salta al contingut
Playground de l’API

Playground de l’API

Interactiu

Prova cada model i endpoint al navegador amb la teva pròpia clau — sortida en streaming, inspector de sol·licituds i codi generat que pots enganxar directament a la teva aplicació.

Obre el Playground

El playground és una consola de xat per a l'API a /docs/playground. Parles amb un model, i el playground envia les mateixes sol·licituds que enviaria el teu codi: a un dels tres endpoints, amb el model, el prompt de sistema, els paràmetres i les eines que defineixes. Cada sol·licitud es pot tornar a llegir com a codi i com a esdeveniments de stream en brut.

Comença

  • Dona-li una clau — Amb la sessió iniciada, el playground fa servir la clau API del teu compte i mostra el teu saldo. Sense sessió, tria Afegeix una clau i enganxa'n una: només es manté en aquesta pestanya i mai no es desa.
  • Tria un endpoint i un model — La barra superior conté el commutador d'endpoint i el selector de model. Una conversa nova comença a Chat Completions amb shannon-3.
  • Envia un missatge — Escriu a sota i prem Enter. Cada resposta s'afegeix a la conversa, així que el missatge següent la continua. La pantalla buida ofereix tres prompts per començar i un exemple de crida d'eina a punt.

Trobes i rotes la teva clau a la pàgina Keys & usage. Keys & usage

Endpoints i models

El commutador d'endpoint decideix quin format de sol·licitud construeix el playground. El pots canviar enmig d'una conversa; els missatges es mantenen.

Endpoint Sol·licitud que envia Referència
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses API Responses
Messages POST /v1/messages Anthropic

El selector de model llista el que retorna GET /v1/models. Es pot cercar, manté a dalt els teus models recents i mostra per a cada model el preu per 1M de tokens, la finestra de context i marques per a eines, entrada d'imatges, raonament i sortida estructurada.

La conversa

  • Les respostes arriben a la conversa en streaming a mesura que s'escriuen. El raonament del model es mostra en un bloc propi que pots plegar.
  • Sota cada resposta: temps fins al primer token, tokens per segon, temps transcorregut, tokens d'entrada i de sortida amb les parts en cache i de raonament, una estimació del cost del torn, el motiu de finalització i l'id de la resposta.
  • Un missatge teu es pot editar i tornar a enviar des d'aquell punt. Una resposta es pot regenerar. Un missatge es pot suprimir, i la supressió es pot desfer durant uns segons.
  • Atura o la tecla Esc finalitza una resposta que s'està escrivint.
  • Les imatges s'adjunten amb el botó d'imatge, enganxant-les o deixant-hi anar un fitxer, per als models que accepten imatges. Una imatge s'escala a 1,568 píxels al costat llarg abans d'enviar-se. Un fitxer de més de 30 MB s'omet.
  • El compositor i el prompt de sistema mostren un recompte de tokens. Per als models open-weight hostejats és el recompte exacte de POST /v1/tokenize. Per als altres models és una estimació, marcada amb ≈.
  • Una sol·licitud fallida mostra què cal fer després: definir una clau quan s'ha rebutjat la clau, recarregar quan s'ha esgotat el saldo, els segons d'espera després de massa sol·licituds, o un reintent després d'un error del servidor.

Ajustos de la sol·licitud

El botó Ajustos obre un panell amb sis pestanyes. Els ajustos pertanyen a la conversa: cada conversa conserva els seus.

Pestanya Què conté
Sistema El prompt de sistema de la conversa, enviat amb cada sol·licitud. Cinc plantilles l'omplen, i se'n mostra el recompte de tokens.
Paràmetres Màx. tokens de sortida, temperatura, top_p, esforç de raonament, seqüències d'aturada, seed, i els interruptors del streaming i de la cerca web. Un control per al qual l'endpoint seleccionat no té camp queda desactivat i marcat.
Eines Definicions d'eines enviades amb la sol·licitud: quatre preajustos (get_weather, read_file, run_shell, web_search) o la teva pròpia definició com a JSON, i tool_choice (auto, none, required o una eina pel nom). Quan el model crida una eina, la conversa mostra la crida amb una caixa per al resultat. Amb Ofereix resultats d'exemple activat, un clic omple un resultat d'exemple. També en pots escriure un de propi i enviar-lo per continuar el torn.
Estructurat response_format: text, json_object o json_schema amb un nom d'esquema i un esquema JSON. Amb un esquema definit, l'última resposta es comprova contra ell i es marca a la conversa com a conforme o no. La pestanya queda desactivada a l'endpoint Messages, i una opció que el model seleccionat no accepta no s'ofereix.
Codi La sol·licitud de la conversa actual com a codi cURL, Python, Node o Go, construït a partir de la conversa i els seus ajustos. La clau s'imprimeix com a YOUR_API_KEY. El codi es pot copiar o obrir en una vista gran.
Esdeveniments L'últim torn tal com va passar pel cable: cada esdeveniment del stream amb el seu desplaçament de temps i un filtre, la resposta reconstruïda, les capçaleres de la resposta (x-request-id, content-type, retry-after, date) i el cos de la sol·licitud. Es conserven fins que es recarrega la pàgina.

Comprovacions d'entrada

Els valors que escrius es comproven abans d'enviar una sol·licitud. Un valor fora de l'interval es marca al seu camp, i l'enviament queda retingut fins que es corregeix.

Ajust Comprovació
Màx. tokens de sortida Un nombre enter d'1 fins al max_output_tokens del model.
Temperatura Un nombre de 0 a 2. Si és buit, el camp no s'inclou a la sol·licitud.
top_p Un nombre de 0 a 1. Si és buit, el camp no s'inclou a la sol·licitud.
seed Un nombre enter.
Seqüències d'aturada Com a màxim 4, separades per comes.
response_format Ha de ser un que accepti el model seleccionat. Una conversa que es passa a un model sense json_schema o sense response_format queda retinguda, amb el motiu.
Imatges S'eliminen del missatge quan canvies a un model que només accepta text, amb una nota.

Compara dos models

Compara dos models al menú Més afegeix un segon selector de model. Cada missatge va llavors als dos models alhora, amb els mateixos ajustos, i les dues respostes queden una al costat de l'altra, marcades A i B. Pots regenerar un sol costat. Quan un costat crida una eina, el resultat que envies continua només aquell costat.

Comparteix, exporta i importa

  • Copia l'enllaç per compartir empaqueta la conversa dins del mateix enllaç, a la part després de #. No es puja res. Les imatges, la teva clau i els detalls de l'última execució no s'hi inclouen. Qui obre l'enllaç rep la conversa com una de nova al seu propi playground.
  • Una conversa massa llarga per a un enllaç es refusa amb una nota. Baixa-la com a JSON.
  • Baixa el JSON de la conversa desa la conversa amb els seus ajustos en un fitxer. Importa JSON al panell de converses obre un fitxer d'aquest tipus.
  • Copia com a cURL copia la sol·licitud actual com una sola ordre cURL.

Què es guarda i on

Què On es guarda
Converses, eines desades, models recents, disposició dels panells En aquest navegador. No s'envien a Shannon i no et segueixen a un altre dispositiu.
Clau API A la memòria de la pestanya oberta. Una clau enganxada desapareix quan es recarrega la pàgina o es tanca la pestanya. Amb la sessió iniciada, la clau es llegeix del teu compte cada vegada.
Esdeveniments de stream, capçaleres i sol·licitud de l'últim torn A la pàgina oberta, fins que es recarrega.
Sol·licituds Enviades des del teu navegador a l'API amb la teva clau. Es compten contra el teu saldo com qualsevol altra sol·licitud a l'API.

Teclat

Tecles Què fa
Enter Envia el missatge.
Shift + Enter Comença una línia nova.
Ctrl + K Obre la paleta d'ordres: canvia d'endpoint o de model, defineix una plantilla de sistema, comença una conversa nova, activa o desactiva el streaming, les eines o la comparació. En un Mac: ⌘ K.
Esc Atura la resposta que s'està escrivint, o tanca un panell obert en una pantalla estreta.

Obre el Playground