Saltar ao contido
Playground da API

Playground da API

Interactivo

Proba todos os modelos e endpoints no navegador coa túa propia clave — saída en streaming, inspector de solicitudes e código xerado que podes pegar directamente na túa aplicación.

Abrir o Playground

O playground é unha consola de chat para a API en /docs/playground. Falas cun modelo, e o playground envía as mesmas solicitudes que enviaría o teu código: a un dos tres endpoints, co modelo, o system prompt, os parámetros e as ferramentas que definas. Cada solicitude pode lerse de novo como código e como eventos de stream sen procesar.

Comezar

  • Dálle unha clave — Coa sesión iniciada, o playground usa a clave API da túa conta e mostra o teu saldo. Sen iniciar sesión, escolle Engadir clave e pega unha clave: consérvase só nesta pestana e nunca se garda.
  • Escolle un endpoint e un modelo — A barra superior contén o selector de endpoint e o selector de modelo. Unha conversa nova comeza en Chat Completions con shannon-3.
  • Enviar unha mensaxe — Escribe abaixo e preme Enter. Cada resposta únese á conversa, así que a seguinte mensaxe a continúa. A pantalla baleira ofrece tres prompts iniciais e un exemplo listo de chamada a unha ferramenta.

Podes atopar e rotar a túa clave na páxina Claves e uso. Claves e uso

Endpoints e modelos

O selector de endpoint decide que formato de solicitude constrúe o playground. Podes cambialo no medio dunha conversa; as mensaxes quedan.

Endpoint Solicitude que envía Referencia
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses API Responses
Messages POST /v1/messages Anthropic

O selector de modelos lista o que devolve GET /v1/models. Pódese buscar nel, mantén os teus modelos recentes arriba e mostra para cada modelo o prezo por 1M de tokens, a ventá de contexto e marcas para ferramentas, entrada de imaxe, razoamento e saída estruturada.

A conversa

  • As respostas chegan ao fío en stream a medida que se escriben. O razoamento do modelo móstrase nun bloque propio que podes pregar.
  • Debaixo de cada resposta: tempo ata o primeiro token, tokens por segundo, tempo transcorrido, tokens de entrada e de saída coas partes en caché e de razoamento, unha estimación do custo do turno, o motivo de finalización e o id da resposta.
  • Unha mensaxe túa pode editarse e enviarse de novo desde ese punto. Unha resposta pode rexenerarse. Unha mensaxe pode eliminarse, e a eliminación pode desfacerse durante uns segundos.
  • Deter ou a tecla Esc remata unha resposta que se está escribindo.
  • As imaxes anéxanse co botón de imaxe, pegando ou soltando un ficheiro, para os modelos que aceptan imaxes. Unha imaxe redúcese a 1,568 píxeles no seu lado máis longo antes de enviarse. Omítese un ficheiro de máis de 30 MB.
  • O compositor e o system prompt mostran un reconto de tokens. Para os modelos open-weight alojados é o reconto exacto de POST /v1/tokenize. Para os demais modelos é unha estimación, marcada con ≈.
  • Unha solicitude fallida mostra que facer a continuación: definir unha clave se a clave foi rexeitada, recargar se o saldo está esgotado, os segundos de espera despois de demasiadas solicitudes, ou un reintento despois dun erro do servidor.

Axustes da solicitude

O botón Axustes abre un panel con seis pestanas. Os axustes pertencen á conversa: cada conversa garda os seus.

Pestana Que contén
Sistema O system prompt da conversa, enviado con cada solicitude. Cinco modelos axúdanche a cubrilo, e móstrase o seu reconto de tokens.
Parámetros Máximo de tokens de saída, temperatura, top_p, esforzo de razoamento, secuencias de parada, seed e os interruptores de streaming e busca web. Un control para o que o endpoint seleccionado non ten campo queda desactivado e marcado.
Ferramentas Definicións de ferramentas enviadas coa solicitude: catro predefinidas (get_weather, read_file, run_shell, web_search) ou a túa propia definición como JSON, e tool_choice (auto, none, required ou unha ferramenta polo nome). Cando o modelo chama a unha ferramenta, o fío mostra a chamada cunha caixa para o resultado. Con Ofrecer resultados de exemplo activado, un clic enche un resultado de exemplo. Tamén podes escribir o teu propio e despois envialo para continuar o turno.
Estruturado response_format: text, json_object ou json_schema cun nome de esquema e un esquema JSON. Con un esquema definido, a última resposta compróbase contra el e márcase no fío como conforme ou non. A pestana está desactivada no endpoint Messages, e unha opción que o modelo seleccionado non acepta non se ofrece.
Código A solicitude da conversa actual como código cURL, Python, Node ou Go, construído a partir da conversa e dos seus axustes. A clave imprímese como YOUR_API_KEY. O código pódese copiar ou abrir nunha vista ampla.
Eventos O último turno tal como viaxou pola rede: cada evento do stream co seu desfase de tempo e un filtro, a resposta ensamblada, as cabeceiras da resposta (x-request-id, content-type, retry-after, date) e o corpo da solicitude. Consérvanse ata que se recarga a páxina.

Comprobacións de entrada

Os valores que escribes compróbanse antes de enviar unha solicitude. Un valor fóra do intervalo márcase no seu campo e o envío queda retido ata que o corrixas.

Axuste Comprobación
Máximo de tokens de saída Un número enteiro de 1 ao max_output_tokens do modelo.
Temperatura Un número de 0 a 2. Se está baleiro, o campo omítese na solicitude.
top_p Un número de 0 a 1. Se está baleiro, o campo omítese na solicitude.
seed Un número enteiro.
Secuencias de parada Como máximo 4, separadas por comas.
response_format Debe ser un que acepte o modelo seleccionado. Unha conversa pasada a un modelo sen json_schema ou sen response_format queda retida co motivo.
Imaxes Elimínanse da mensaxe cando cambias a un modelo que só acepta texto, cunha nota.

Comparar dous modelos

Comparar dous modelos no menú Máis engade un segundo selector de modelo. Cada mensaxe vai entón aos dous modelos á vez, cos mesmos axustes, e as dúas respostas aparecen lado a lado, marcadas como A e B. Podes rexenerar só un lado. Cando un lado chama a unha ferramenta, o resultado que envías continúa só ese lado.

Compartir, exportar e importar

  • Copiar ligazón para compartir empaqueta a conversa na propia ligazón, na parte despois de #. Non se sube nada. As imaxes, a túa clave e os detalles da última execución quedan fóra. Quen abre a ligazón recibe a conversa como unha nova no seu propio playground.
  • Unha conversa demasiado longa para unha ligazón rexéitase cunha nota. Descárgaa como JSON.
  • Descargar JSON da conversa garda a conversa cos seus axustes nun ficheiro. Importar JSON no panel de conversas abre ese ficheiro.
  • Copiar como cURL copia a solicitude actual como un único comando cURL.

Que se garda e onde

Que Onde se garda
Conversas, ferramentas gardadas, modelos recentes, disposición dos paneis Neste navegador. Non se envían a Shannon e non te seguen a outro dispositivo.
Clave API Na memoria da pestana aberta. Unha clave pegada desaparece cando se recarga a páxina ou se pecha a pestana. Coa sesión iniciada, a clave lese da túa conta cada vez.
Eventos do stream, cabeceiras e solicitude do último turno Na páxina aberta, ata que se recarga.
Solicitudes Envíanse desde o teu navegador á API coa túa clave. Cóntanse no teu saldo como calquera outra solicitude da API.

Teclado

Teclas Que fai
Enter Enviar a mensaxe.
Shift + Enter Comezar unha nova liña.
Ctrl + K Abrir a paleta de comandos: cambiar de endpoint ou de modelo, definir un modelo de system prompt, comezar unha nova conversa, alternar streaming, ferramentas ou comparación. En Mac: ⌘ K.
Esc Deter a resposta que se está escribindo, ou pechar un panel aberto nunha pantalla estreita.

Abrir o Playground