Ir para o conteúdo
Playground da API

Playground da API

Interativo

Teste todos os modelos e endpoints no navegador com sua própria chave — saída em streaming, inspetor de requisições e código gerado que você pode colar direto no seu app.

Abrir o Playground

O playground é um console de chat para a API em /docs/playground. Você conversa com um modelo, e o playground envia as mesmas requisições que o seu código enviaria: para um dos três endpoints, com o modelo, o system prompt, os parâmetros e as ferramentas que você definiu. Cada requisição pode ser lida de volta como código e como eventos brutos do stream.

Início

  • Informe uma chave — Com login feito, o playground usa a chave de API da sua conta e mostra o seu saldo. Sem login, escolha Adicionar chave e cole uma chave: ela fica apenas nesta aba e nunca é salva.
  • Escolha um endpoint e um modelo — A barra superior contém o seletor de endpoint e o seletor de modelo. Uma nova conversa começa em Chat Completions com shannon-3.
  • Envie uma mensagem — Digite abaixo e pressione Enter. Cada resposta entra na conversa, de modo que a próxima mensagem a continua. A tela vazia oferece três prompts iniciais e um exemplo pronto de chamada de ferramenta.

Você encontra e rotaciona a sua chave na página Chaves e uso. Chaves e uso

Endpoints e modelos

O seletor de endpoint decide qual formato de requisição o playground monta. Você pode trocá-lo no meio de uma conversa; as mensagens permanecem.

Endpoint Requisição que envia Referência
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses API Responses
Messages POST /v1/messages Formato Anthropic

O seletor de modelo lista o que GET /v1/models retorna. Ele permite busca, mantém seus modelos recentes no topo e mostra, para cada modelo, o preço por 1M de tokens, a janela de contexto e marcas para ferramentas, entrada de imagem, raciocínio e saída estruturada.

A conversa

  • As respostas chegam à conversa em stream, conforme são escritas. O raciocínio do modelo aparece em um bloco próprio, que você pode recolher.
  • Sob cada resposta: tempo até o primeiro token, tokens por segundo, tempo decorrido, tokens de entrada e de saída com as partes em cache e de raciocínio, uma estimativa do custo do turno, o motivo de término e o id da resposta.
  • Uma mensagem sua pode ser editada e enviada de novo a partir daquele ponto. Uma resposta pode ser regenerada. Uma mensagem pode ser excluída, e a exclusão pode ser desfeita por alguns segundos.
  • Parar ou a tecla Esc encerra uma resposta que está sendo escrita.
  • As imagens são anexadas com o botão de imagem, colando ou soltando um arquivo, para modelos que aceitam imagens. Uma imagem é reduzida a 1,568 pixels no lado maior antes de ser enviada. Um arquivo acima de 30 MB é ignorado.
  • O campo de mensagem e o system prompt mostram uma contagem de tokens. Para os modelos open-weight hospedados, é a contagem exata de POST /v1/tokenize. Para os outros modelos, é uma estimativa, marcada com ≈.
  • Uma requisição com falha mostra o que fazer em seguida: informar uma chave quando a chave foi rejeitada, recarregar quando o saldo acabou, os segundos de espera após requisições demais, ou uma nova tentativa após um erro do servidor.

Configurações da requisição

O botão Configurações abre um painel com seis abas. As configurações pertencem à conversa: cada conversa mantém as suas.

Aba O que contém
Sistema O system prompt da conversa, enviado a cada requisição. Cinco modelos o preenchem, e a contagem de tokens é exibida.
Parâmetros Máximo de tokens de saída, temperatura, top_p, esforço de raciocínio, sequências de parada, seed e as chaves de streaming e de busca na web. Um controle para o qual o endpoint selecionado não tem campo fica desativado e marcado.
Ferramentas Definições de ferramenta enviadas com a requisição: quatro predefinições (get_weather, read_file, run_shell, web_search) ou a sua própria definição em JSON, e tool_choice (auto, none, required ou uma ferramenta pelo nome). Quando o modelo chama uma ferramenta, a conversa mostra a chamada com uma caixa para o resultado. Com Oferecer resultados de exemplo ativado, um clique preenche um resultado de exemplo. Você também pode digitar o seu e enviá-lo para continuar o turno.
Estruturado response_format: text, json_object ou json_schema com um nome de schema e um JSON schema. Com um schema definido, a última resposta é verificada em relação a ele e marcada na conversa como conforme ou não. A aba fica desativada no endpoint Messages, e uma opção que o modelo selecionado não aceita não é oferecida.
Código A requisição da conversa atual como código cURL, Python, Node ou Go, montado a partir da conversa e de suas configurações. A chave aparece como YOUR_API_KEY. O código pode ser copiado ou aberto em uma visualização ampliada.
Eventos O último turno como trafegou pela rede: cada evento do stream com seu deslocamento de tempo e um filtro, a resposta montada, os cabeçalhos da resposta (x-request-id, content-type, retry-after, date) e o corpo da requisição. Eles ficam guardados até a página ser recarregada.

Verificações de entrada

Os valores que você digita são verificados antes de uma requisição ser enviada. Um valor fora do intervalo é marcado no próprio campo, e o envio fica retido até que seja corrigido.

Configuração Verificação
Máximo de tokens de saída Um número inteiro de 1 até o max_output_tokens do modelo.
Temperatura Um número de 0 a 2. Vazio, o campo fica fora da requisição.
top_p Um número de 0 a 1. Vazio, o campo fica fora da requisição.
seed Um número inteiro.
Sequências de parada No máximo 4, separadas por vírgulas.
response_format Deve ser um formato aceito pelo modelo selecionado. Uma conversa movida para um modelo sem json_schema ou sem response_format fica retida, com o motivo.
Imagens Removidas da mensagem quando você troca para um modelo que aceita apenas texto, com um aviso.

Comparar dois modelos

Comparar dois modelos no menu Mais adiciona um segundo seletor de modelo. Cada mensagem passa a ir para os dois modelos ao mesmo tempo, com as mesmas configurações, e as duas respostas aparecem lado a lado, marcadas como A e B. Você pode regenerar apenas um dos lados. Quando um lado chama uma ferramenta, o resultado que você envia continua somente esse lado.

Compartilhar, exportar e importar

  • Copiar link de compartilhamento empacota a conversa no próprio link, na parte depois de #. Nada é enviado para um servidor. Imagens, sua chave e os detalhes da última execução ficam de fora. Quem abre o link recebe a conversa como uma nova conversa no próprio playground.
  • Uma conversa longa demais para um link é recusada, com um aviso. Baixe-a como JSON.
  • Baixar JSON da conversa salva a conversa com suas configurações em um arquivo. Importar JSON no painel de conversas abre esse arquivo.
  • Copiar como cURL copia a requisição atual como um único comando cURL.

O que fica guardado e onde

O quê Onde fica guardado
Conversas, ferramentas salvas, modelos recentes, layout dos painéis Neste navegador. Elas não são enviadas à Shannon e não acompanham você em outro dispositivo.
Chave de API Na memória da aba aberta. Uma chave colada desaparece quando a página é recarregada ou a aba é fechada. Com login feito, a chave é lida da sua conta a cada vez.
Eventos do stream, cabeçalhos e requisição do último turno Na página aberta, até ela ser recarregada.
Requisições Enviadas do seu navegador para a API com a sua chave. Elas são descontadas do seu saldo como qualquer outra requisição da API.

Teclado

Teclas O que faz
Enter Envia a mensagem.
Shift + Enter Inicia uma nova linha.
Ctrl + K Abre a paleta de comandos: trocar de endpoint ou de modelo, definir um modelo de system prompt, iniciar uma nova conversa, ativar ou desativar streaming, ferramentas ou comparação. No Mac: ⌘ K.
Esc Interrompe a resposta que está sendo escrita ou fecha um painel aberto em tela estreita.

Abrir o Playground