Saltar al contenido
Playground de API

Playground de API

Interactivo

Prueba cada modelo y endpoint en el navegador con tu propia clave: salida en streaming, inspector de solicitudes y código generado que puedes pegar directamente en tu aplicación.

Abrir Playground

El playground es una consola de chat para la API en /docs/playground. Hablas con un modelo, y el playground envía las mismas solicitudes que enviaría tu código: a uno de tres endpoints, con el modelo, el system prompt, los parámetros y las herramientas que configures. Cada solicitud se puede leer como código y como eventos de stream sin procesar.

Primeros pasos

  • Dale una clave — Con la sesión iniciada, el playground usa la clave API de tu cuenta y muestra tu saldo. Sin sesión, elige Añadir clave y pega una clave: se conserva solo en esta pestaña y nunca se guarda.
  • Elige un endpoint y un modelo — La barra superior contiene el selector de endpoint y el selector de modelo. Una conversación nueva empieza en Chat Completions con shannon-3.
  • Envía un mensaje — Escribe abajo y presiona Enter. Cada respuesta se une a la conversación, por lo que el siguiente mensaje la continúa. La pantalla vacía ofrece tres prompts iniciales y un ejemplo de llamada a herramienta listo para usar.

Encuentras y rotas tu clave en la página Claves y uso. Claves y uso

Endpoints y modelos

El selector de endpoint decide qué formato de solicitud construye el playground. Puedes cambiarlo en medio de una conversación; los mensajes se conservan.

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

El selector de modelos lista lo que devuelve GET /v1/models. Se puede buscar, mantiene tus modelos recientes arriba y muestra para cada modelo el precio por 1M de tokens, la ventana de contexto y marcas para herramientas, entrada de imágenes, razonamiento y salida estructurada.

La conversación

  • Las respuestas llegan al hilo en streaming a medida que se escriben. El razonamiento del modelo se muestra en un bloque propio que puedes plegar.
  • Bajo cada respuesta: tiempo hasta el primer token, tokens por segundo, tiempo transcurrido, tokens de entrada y salida con las partes en caché y de razonamiento, una estimación del costo del turno, el motivo de finalización y el id de la respuesta.
  • Un mensaje tuyo se puede editar y reenviar desde ese punto. Una respuesta se puede regenerar. Un mensaje se puede borrar, y el borrado se puede deshacer durante unos segundos.
  • Detener o la tecla Esc termina una respuesta que se está escribiendo.
  • Las imágenes se adjuntan con el botón de imagen, pegándolas o soltando un archivo, para los modelos que aceptan imágenes. Una imagen se escala a 1,568 píxeles en su lado largo antes de enviarse. Un archivo de más de 30 MB se omite.
  • El compositor y el system prompt muestran un recuento de tokens. Para los modelos de pesos abiertos alojados es el recuento exacto de POST /v1/tokenize. Para los demás modelos es una estimación, marcada con ≈.
  • Una solicitud fallida muestra qué hacer a continuación: configurar una clave cuando se rechazó la clave, recargar cuando se agotó el saldo, los segundos de espera tras demasiadas solicitudes, o un reintento tras un error del servidor.

Configuración de solicitud

El botón Configuración abre un panel con seis pestañas. Los ajustes pertenecen a la conversación: cada conversación conserva los suyos.

Pestaña Qué contiene
Sistema El system prompt de la conversación, enviado con cada solicitud. Cinco plantillas lo rellenan, y se muestra su número de tokens.
Parámetros Máximo de tokens de salida, temperatura, top_p, esfuerzo de razonamiento, secuencias de parada, seed y los interruptores de streaming y búsqueda web. Un control para el que el endpoint seleccionado no tiene campo se desactiva y se marca.
Herramientas Definiciones de herramientas enviadas con la solicitud: cuatro preajustes (get_weather, read_file, run_shell, web_search) o tu propia definición como JSON, y tool_choice (auto, none, required o una herramienta por nombre). Cuando el modelo llama a una herramienta, el hilo muestra la llamada con un cuadro para el resultado. Con Ofrecer resultados de ejemplo activado, un clic rellena un resultado de ejemplo. También puedes escribir el tuyo y luego enviarlo para continuar el turno.
Estructurado response_format: text, json_object o json_schema con un nombre de esquema y un esquema JSON. Con un esquema definido, la última respuesta se comprueba contra él y se marca en el hilo si coincide o no. La pestaña está desactivada en el endpoint Messages, y una opción que el modelo seleccionado no acepta no se ofrece.
Código La solicitud de la conversación actual como código cURL, Python, Node o Go, construido a partir de la conversación y sus ajustes. La clave se muestra como YOUR_API_KEY. El código se puede copiar o abrir en una vista grande.
Eventos El último turno tal como viajó por la red: cada evento de stream con su desfase de tiempo y un filtro, la respuesta ensamblada, los headers de la respuesta (x-request-id, content-type, retry-after, date) y el cuerpo de la solicitud. Se conservan hasta que se recarga la página.

Comprobaciones de entrada

Los valores que escribes se comprueban antes de enviar una solicitud. Un valor fuera de rango se marca en su campo, y el envío queda retenido hasta que se corrija.

Ajuste Comprobación
Máximo de tokens de salida Un número entero de 1 al max_output_tokens del modelo.
Temperatura Un número de 0 a 2. Si está vacío, el campo se omite de la solicitud.
top_p Un número de 0 a 1. Si está vacío, el campo se omite de la solicitud.
seed Un número entero.
Secuencias de parada Como máximo 4, separadas por comas.
response_format Debe ser uno que acepte el modelo seleccionado. Una conversación movida a un modelo sin json_schema o sin response_format se retiene con el motivo.
Imágenes Se quitan del mensaje cuando cambias a un modelo que solo acepta texto, con una nota.

Comparar dos modelos

Comparar dos modelos en el menú Más añade un segundo selector de modelo. Cada mensaje va entonces a ambos modelos al mismo tiempo, con los mismos ajustes, y las dos respuestas quedan una al lado de la otra, marcadas A y B. Puedes regenerar un solo lado. Cuando un lado llama a una herramienta, el resultado que envías continúa solo ese lado.

Compartir, exportar e importar

  • Copiar enlace para compartir empaqueta la conversación en el propio enlace, en la parte posterior a #. No se sube nada. Se omiten las imágenes, tu clave y los detalles de la última ejecución. Quien abra el enlace recibe la conversación como una nueva en su propio playground.
  • Una conversación demasiado larga para un enlace se rechaza con una nota. Descárgala como JSON en su lugar.
  • Descargar JSON de la conversación guarda la conversación con sus ajustes como un archivo. Importar JSON en el panel de conversaciones abre un archivo así.
  • Copiar como cURL copia la solicitud actual como un único comando cURL.

Qué se guarda y dónde

Qué Dónde se guarda
Conversaciones, herramientas guardadas, modelos recientes, disposición de los paneles En este navegador. No se envían a Shannon y no te siguen a otro dispositivo.
Clave API En la memoria de la pestaña abierta. Una clave pegada desaparece cuando la página se recarga o la pestaña se cierra. Con la sesión iniciada, la clave se lee de tu cuenta cada vez.
Eventos de stream, headers y solicitud del último turno En la página abierta, hasta que se recarga.
Solicitudes Se envían desde tu navegador a la API con tu clave. Se descuentan de tu saldo como cualquier otra solicitud de API.

Teclado

Teclas Qué hace
Enter Enviar el mensaje.
Shift + Enter Empezar una línea nueva.
Ctrl + K Abrir la paleta de comandos: cambiar de endpoint o de modelo, establecer una plantilla de sistema, iniciar una conversación nueva, alternar streaming, herramientas o comparación. En Mac: ⌘ K.
Esc Detener la respuesta que se está escribiendo, o cerrar un panel abierto en una pantalla estrecha.

Abrir Playground