Aller au contenu
Terrain de jeu API

Terrain de jeu API

Interactif

Essayez chaque modèle et chaque point de terminaison dans le navigateur avec votre propre clé — sortie en streaming, inspecteur de requêtes et code généré que vous pouvez coller directement dans votre application.

Lancer le terrain de jeu

Le playground est une console de chat pour l'API, à l'adresse /docs/playground. Vous discutez avec un modèle, et le playground envoie les mêmes requêtes que votre code enverrait : vers l'un des trois points de terminaison, avec le modèle, le prompt système, les paramètres et les outils que vous avez définis. Chaque requête peut être relue sous forme de code et d'événements bruts du flux.

Démarrer

  • Donnez-lui une clé — Une fois connecté, le playground utilise la clé API de votre compte et affiche votre solde. Si vous n'êtes pas connecté, choisissez Ajouter une clé et collez une clé : elle n'est gardée que dans cet onglet et n'est jamais enregistrée.
  • Choisissez un point de terminaison et un modèle — La barre du haut contient le sélecteur de point de terminaison et le sélecteur de modèle. Une nouvelle conversation démarre sur Chat Completions avec shannon-3.
  • Envoyez un message — Écrivez en bas et appuyez sur Entrée. Chaque réponse rejoint la conversation, donc le message suivant la poursuit. L'écran vide propose trois prompts de départ et un exemple d'appel d'outil prêt à l'emploi.

Vous trouvez et renouvelez votre clé sur la page Clés et utilisation. Clés et utilisation

Points de terminaison et modèles

Le sélecteur de point de terminaison détermine le format de requête que le playground construit. Vous pouvez le changer au milieu d'une conversation ; les messages restent.

Point de terminaison Requête envoyée Référence
Chat Completions POST /v1/chat/completions Chat Completions
Responses POST /v1/responses API Responses
Messages POST /v1/messages Format anthropique

Le sélecteur de modèle liste ce que renvoie GET /v1/models. On peut y faire une recherche, il garde vos modèles récents en haut, et il affiche pour chaque modèle le prix par 1M de tokens, la fenêtre de contexte et des repères pour les outils, l'entrée d'images, le raisonnement et la sortie structurée.

La conversation

  • Les réponses arrivent dans le fil au fur et à mesure de leur écriture. Le raisonnement du modèle s'affiche dans un bloc à part que vous pouvez replier.
  • Sous chaque réponse : le temps jusqu'au premier token, les tokens par seconde, le temps écoulé, les tokens d'entrée et de sortie avec les parties en cache et de raisonnement, une estimation du coût du tour, le motif de fin et l'id de la réponse.
  • Un de vos messages peut être modifié et renvoyé à partir de ce point. Une réponse peut être régénérée. Un message peut être supprimé, et la suppression peut être annulée pendant quelques secondes.
  • Arrêter ou la touche Échap met fin à une réponse en cours d'écriture.
  • Les images se joignent avec le bouton d'image, par collage ou en déposant un fichier, pour les modèles qui acceptent les images. Une image est réduite à 1,568 pixels sur son grand côté avant l'envoi. Un fichier de plus de 30 MB est ignoré.
  • La zone de saisie et le prompt système affichent un nombre de tokens. Pour les modèles open-weight hébergés, c'est le décompte exact de POST /v1/tokenize. Pour les autres modèles, c'est une estimation, marquée par ≈.
  • Une requête échouée indique la suite à donner : définir une clé quand la clé a été rejetée, recharger quand le solde est épuisé, les secondes à attendre après trop de requêtes, ou un nouvel essai après une erreur du serveur.

Réglages de la requête

Le bouton Réglages ouvre un panneau de six onglets. Les réglages appartiennent à la conversation : chaque conversation garde les siens.

Onglet Ce qu'il contient
Système Le prompt système de la conversation, envoyé avec chaque requête. Cinq modèles permettent de le remplir, et son nombre de tokens est affiché.
Paramètres Tokens de sortie max., température, top_p, effort de raisonnement, séquences d'arrêt, seed, et les interrupteurs du streaming et de la recherche web. Un contrôle pour lequel le point de terminaison sélectionné n'a pas de champ est désactivé et signalé.
Outils Les définitions d'outils envoyées avec la requête : quatre préréglages (get_weather, read_file, run_shell, web_search) ou votre propre définition en JSON, et tool_choice (auto, none, required ou un seul outil par son nom). Quand le modèle appelle un outil, le fil montre l'appel avec une zone pour le résultat. Avec Proposer des résultats d'exemple activé, un clic remplit un résultat d'exemple. Vous pouvez aussi saisir le vôtre, puis l'envoyer pour poursuivre le tour.
Structuré response_format : text, json_object ou json_schema avec un nom de schéma et un schéma JSON. Avec un schéma défini, la dernière réponse est vérifiée par rapport à lui et marquée dans le fil comme conforme ou non. L'onglet est désactivé sur le point de terminaison Messages, et une option que le modèle sélectionné n'accepte pas n'est pas proposée.
Code La requête de la conversation actuelle en code cURL, Python, Node ou Go, construite à partir de la conversation et de ses réglages. La clé est écrite YOUR_API_KEY. Le code peut être copié ou ouvert en grand affichage.
Événements Le dernier tour tel qu'il a circulé sur le réseau : chaque événement du flux avec son décalage dans le temps et un filtre, la réponse assemblée, les en-têtes de réponse (x-request-id, content-type, retry-after, date) et le corps de la requête. Ils sont conservés jusqu'au rechargement de la page.

Vérifications de saisie

Les valeurs que vous saisissez sont vérifiées avant l'envoi d'une requête. Une valeur hors limites est signalée sur son champ, et l'envoi est bloqué jusqu'à correction.

Réglage Vérification
Tokens de sortie max. Un nombre entier de 1 jusqu'à la valeur max_output_tokens du modèle.
Température Un nombre de 0 à 2. Vide, le champ est omis de la requête.
top_p Un nombre de 0 à 1. Vide, le champ est omis de la requête.
seed Un nombre entier.
Séquences d'arrêt 4 au maximum, séparées par des virgules.
response_format Doit être un format accepté par le modèle sélectionné. Une conversation passée à un modèle sans json_schema ou sans response_format est retenue, avec la raison.
Images Retirées du message quand vous passez à un modèle qui n'accepte que du texte, avec une note.

Comparer deux modèles

Comparer deux modèles dans le menu Plus ajoute un second sélecteur de modèle. Chaque message part alors vers les deux modèles en même temps, avec les mêmes réglages, et les deux réponses s'affichent côte à côte, repérées par A et B. Vous pouvez régénérer un seul côté. Quand un côté appelle un outil, le résultat que vous envoyez ne poursuit que ce côté.

Partager, exporter et importer

  • Copier le lien de partage place la conversation dans le lien lui-même, dans la partie après #. Rien n'est envoyé en ligne. Les images, votre clé et les détails de la dernière exécution sont omis. Celui qui ouvre le lien obtient la conversation comme une nouvelle conversation dans son propre playground.
  • Une conversation trop longue pour un lien est refusée, avec une note. Téléchargez-la plutôt en JSON.
  • Télécharger la conversation en JSON enregistre la conversation avec ses réglages dans un fichier. Importer du JSON dans le panneau des conversations ouvre un tel fichier.
  • Copier en cURL copie la requête actuelle sous la forme d'une seule commande cURL.

Ce qui est conservé et où

Quoi Où c'est conservé
Conversations, outils enregistrés, modèles récents, disposition des panneaux Dans ce navigateur. Elles ne sont pas envoyées à Shannon et ne vous suivent pas sur un autre appareil.
Clé API Dans la mémoire de l'onglet ouvert. Une clé collée disparaît au rechargement de la page ou à la fermeture de l'onglet. Une fois connecté, la clé est lue depuis votre compte à chaque fois.
Événements du flux, en-têtes et requête du dernier tour Dans la page ouverte, jusqu'à son rechargement.
Requêtes Envoyées depuis votre navigateur vers l'API avec votre clé. Elles sont décomptées de votre solde comme toute autre requête API.

Clavier

Touches Ce qu'il fait
Enter Envoyer le message.
Shift + Enter Commencer une nouvelle ligne.
Ctrl + K Ouvrir la palette de commandes : changer de point de terminaison ou de modèle, définir un modèle de prompt système, démarrer une nouvelle conversation, activer ou désactiver le streaming, les outils ou la comparaison. Sur Mac : ⌘ K.
Esc Arrêter la réponse en cours d'écriture, ou fermer un panneau ouvert sur un écran étroit.

Lancer le terrain de jeu