Annonce: Offre de lancement limitée à 20 % de réduction sur GPT Image 2.6 Flare et Sunburst, essayez dès maintenant
HiAPI

Générateur de JSON Schema pour la sortie structurée

Collez un JSON d'exemple, obtenez un JSON Schema et copiez une requête d'API qui fait retourner exactement cette structure au modèle. Tout fonctionne dans votre navigateur.

Chaque propriété est required, additionalProperties est false et les champs absents de certains éléments deviennent nullable. La sortie structurée stricte attend exactement cela.

Votre JSON est traité dans ce navigateur et n'est jamais téléversé.

Paramètres de la requête (modèle, prompt)

Modèle d'exemple. La prise en charge de json_schema varie selon le modèle, vérifiez donc la page du modèle avant de vous y fier.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "response",
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "age": {
      "type": "integer"
    },
    "email": {
      "type": "string",
      "format": "email"
    },
    "joined": {
      "type": "string",
      "format": "date-time"
    },
    "skills": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "address": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string"
        },
        "zip": {
          "type": "string"
        }
      },
      "required": [
        "city",
        "zip"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "name",
    "age",
    "email",
    "joined",
    "skills",
    "address"
  ],
  "additionalProperties": false
}

Exécutez-le sur HiAPI en trois étapes

  1. 01Créez un compte gratuit

    Inscrivez-vous avec un e-mail, Google ou GitHub. Cela prend environ une minute.

    S'inscrire
  2. 02Créez une clé d'API

    Générez une clé dans le tableau de bord et utilisez-la à la place de YOUR_API_KEY.

    Obtenir une clé d'API
  3. 03Faites votre premier appel

    Exécutez le code généré. Votre requête apparaît dans les journaux d'utilisation.

Comment générer un schéma pour la sortie structurée

  1. 01 Collez un JSON d'exemple

    Utilisez un vrai exemple de la sortie souhaitée, avec des valeurs représentatives. Incluez plusieurs éléments de tableau pour que les champs facultatifs soient détectés.

  2. 02 Vérifiez le schéma

    Vérifiez les types et formats, et ajustez les noms. Le mode strict rend chaque champ obligatoire, ce qu'attend la sortie structurée stricte.

  3. 03 Copiez l'appel API

    Choisissez cURL, Python ou Node.js, ajoutez votre clé et exécutez. Le résultat est une chaîne JSON dans choices[0].message.content.

FAQ du générateur de JSON Schema

Mon JSON est-il téléversé quelque part ?

Non. Le schéma et le code sont générés entièrement dans votre navigateur. Rien n'est envoyé à HiAPI ni à aucun autre serveur.

Que change le mode strict ?

Il marque chaque propriété comme required, met additionalProperties à false et transforme en types nullable les champs absents de certains éléments du tableau. La sortie structurée stricte exige tout cela.

Chaque modèle prend-il en charge json_schema ?

Non. La prise en charge dépend du modèle. L'exemple utilise kimi-k3 avec response_format.type défini sur json_schema. Consultez la page du modèle pour ce que chaque modèle accepte.

Comment le schéma est-il déduit d'un seul exemple ?

Les types viennent de vos valeurs, les entiers et les décimales sont distingués, les tableaux sont fusionnés entre les éléments, et les formats de chaîne sont ajoutés quand chaque échantillon correspond. Un seul exemple ne peut pas montrer d'enums ni de limites de valeurs, modifiez-les à la main.

Où se trouve le résultat structuré dans la réponse ?

Dans choices[0].message.content sous forme de chaîne JSON. Analysez-le et validez les champs métier dans votre application.