Skip to main content
OpenAI a récemment fourni une interface pour créer des réponses de modèle. Fournissez des entrées textuelles ou d’image pour générer des sorties textuelles ou d’image. Permettez au modèle d’appeler votre propre code personnalisé ou d’utiliser des outils intégrés, tels que la recherche sur le web ou la recherche de fichiers, pour utiliser vos propres données comme entrée pour les réponses du modèle. Ce document décrit principalement le processus d’utilisation de l’API OpenAI Responses, ce qui nous permet d’utiliser facilement la fonctionnalité de création de réponses de modèle d’OpenAI.

Processus de demande

Pour utiliser l’API OpenAI Responses, commencez par obtenir votre jeton API sur le tableau de bord Ace Data Cloud pour le garder en réserve. Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion pour vous inviter à vous inscrire et à vous connecter, après quoi vous serez automatiquement renvoyé à la page actuelle. Un jeton API suffit pour appeler tous les services de la plateforme, sans avoir à en demander un pour chaque service. La première demande vous donnera un quota gratuit pour une expérience sans frais ; lorsque le quota est insuffisant, vous pouvez recharger le solde général dans le tableau de bord.
📘 Documentation complète : OpenAI Responses API →

Utilisation de base

Vous pouvez ensuite remplir le contenu correspondant sur l’interface, comme indiqué sur l’image :

Lors de la première utilisation de cette interface, nous devons remplir au moins trois contenus, l’un est authorization, que vous pouvez sélectionner directement dans la liste déroulante. L’autre paramètre est model, model est la catégorie de modèle que nous choisissons d’utiliser sur le site officiel d’OpenAI ChatGPT, ici nous avons principalement 20 modèles, pour plus de détails, vous pouvez consulter les modèles que nous fournissons. Le dernier paramètre est input, input est un tableau de mots de question que nous entrons, il s’agit d’un tableau qui représente plusieurs mots de question pouvant être téléchargés simultanément, chaque mot de question contenant role et content, où role représente le rôle du questionneur, nous avons fourni trois identités, à savoir user, assistant, system. L’autre content est le contenu spécifique de notre question. Vous pouvez également remarquer qu’il y a un code d’appel correspondant généré à droite, que vous pouvez copier et exécuter directement, ou vous pouvez simplement cliquer sur le bouton « Essayer » pour effectuer un test. Paramètres optionnels courants :
  • max_tokens : limite le nombre maximum de tokens pour une seule réponse.
  • temperature : génère de l’aléatoire, entre 0 et 2, plus la valeur est élevée, plus elle est dispersée.
  • n : combien de réponses candidates générer en une seule fois.
  • response_format : paramètres de format de retour.
  • tools : définition des appels de fonctions/outils.
  • background : exécute-t-il en arrière-plan de manière asynchrone.

Après l’appel, nous constatons que le résultat retourné est le suivant :
Le résultat retourné contient plusieurs champs, décrits comme suit :
  • id, l’ID généré pour cette tâche de dialogue, utilisé pour identifier de manière unique cette tâche de dialogue.
  • model, le modèle choisi sur le site officiel d’OpenAI ChatGPT.
  • output, les informations de réponse fournies par ChatGPT pour le mot de question.
  • usage : les informations statistiques sur les tokens pour cette question-réponse.
Parmi ceux-ci, output contient les informations de réponse de ChatGPT, où output est ChatGPT, comme on peut le voir sur l’image.

On peut voir que le champ content dans output contient le contenu spécifique de la réponse de ChatGPT.

Réponse en continu

Cette interface prend également en charge les réponses en continu, ce qui est très utile pour l’intégration sur le web, permettant d’afficher les résultats mot par mot. Si vous souhaitez retourner une réponse en continu, vous pouvez modifier le paramètre stream dans l’en-tête de la requête, en le changeant en true. Modifiez comme indiqué sur l’image, mais le code d’appel doit également être modifié pour prendre en charge les réponses en continu.

Après avoir modifié stream en true, l’API renverra les données JSON correspondantes ligne par ligne, et au niveau du code, nous devons faire les modifications nécessaires pour obtenir les résultats ligne par ligne. Exemple de code d’appel en Python :
L’effet de sortie est le suivant :
On peut voir que la réponse contient beaucoup de data, et que le delta dans data est le contenu de la réponse la plus récente, conforme à ce qui a été présenté ci-dessus. Le delta est le contenu de réponse ajouté, que vous pouvez intégrer dans votre système. De plus, la fin de la réponse en streaming est déterminée par le contenu de data. Si le contenu de type est response.completed, cela signifie que la réponse en streaming est entièrement terminée. Les résultats retournés dans data contiennent plusieurs champs, décrits comme suit :
  • item_id, l’ID généré pour cette tâche de dialogue, utilisé pour identifier de manière unique cette tâche de dialogue.
  • type, le type de tâche de génération de réponses pour ce dialogue.
  • model, le modèle choisi sur le site officiel d’OpenAI ChatGPT.
  • delta, les informations de réponse fournies par ChatGPT en réponse à la question.
JavaScript est également pris en charge, par exemple, le code d’appel en streaming pour Node.js est comme suit :
Exemple de code en Java :
D’autres langages peuvent être réécrits séparément, le principe est le même.

Dialogue multi-tours

Si vous souhaitez intégrer une fonctionnalité de dialogue multi-tours, vous devez télécharger plusieurs questions dans le champ input, des exemples concrets de plusieurs questions sont montrés ci-dessous :

Exemple de code d’appel en Python :
En téléchargeant plusieurs questions, vous pouvez facilement réaliser un dialogue multi-tours et obtenir la réponse suivante :
On peut voir que les informations contenues dans output sont cohérentes avec le contenu de l’utilisation de base, cela inclut le contenu spécifique de la réponse de ChatGPT à plusieurs dialogues, permettant ainsi de répondre aux questions correspondantes en fonction de plusieurs contenus de dialogue.

Modèle visuel

gpt-4o est un modèle de langage multimodal de grande taille développé par OpenAI, qui a ajouté des capacités de compréhension visuelle à GPT-4. Ce modèle peut traiter simultanément des entrées textuelles et des images, réalisant une compréhension et une génération intermodales. Le traitement de texte avec le modèle gpt-4o est conforme au contenu d’utilisation de base mentionné ci-dessus. Voici un bref aperçu de l’utilisation de la capacité de traitement d’image du modèle. L’utilisation de la capacité de traitement d’image du modèle gpt-4o se fait principalement en ajoutant un champ type à la base du contenu content existant, ce champ permettant de savoir si ce qui est téléchargé est du texte ou une image, afin d’utiliser la capacité de traitement d’image du modèle gpt-4o. Ci-dessous, nous allons principalement aborder l’appel de cette fonctionnalité via Curl et Python.
  • Méthode de script Curl
  • Méthode de script Python
Ensuite, vous pouvez obtenir le résultat suivant, les informations des champs dans le résultat sont cohérentes avec le texte ci-dessus, comme suit :
On peut voir que le contenu de la réponse est basé sur l’image, donc avec les deux méthodes ci-dessus, il est facile d’utiliser les capacités de traitement de texte et d’image du modèle gpt-4.1. En plus de gpt-4.1, il existe un modèle à coût inférieur, appelé gpt-4o-mini. gpt-4o-mini est le dernier modèle de langage de grande taille développé par OpenAI, qui non seulement répond rapidement, mais est également moins cher et prend en charge le multimodal. L’utilisation de la fonction vision peut se référer au contenu d’utilisation du modèle gpt-4.1 ci-dessus.

Création de modèles de traitement de fichiers

Exemple de requête :
Exemple de résultat :
可以看到,我们对输入的文件也进行了处理文件,结果与上文类似。

Gestion des Erreurs

Lors de l’appel à l’API, si une erreur se produit, l’API renverra le code d’erreur et les informations correspondantes. Par exemple :
  • 400 token_mismatched : Mauvaise requête, probablement en raison de paramètres manquants ou invalides.
  • 400 api_not_implemented : Mauvaise requête, probablement en raison de paramètres manquants ou invalides.
  • 401 invalid_token : Non autorisé, jeton d’autorisation invalide ou manquant.
  • 429 too_many_requests : Trop de demandes, vous avez dépassé la limite de taux.
  • 500 api_error : Erreur interne du serveur, quelque chose s’est mal passé sur le serveur.

Exemple de Réponse d’Erreur

Conclusion

Grâce à ce document, vous avez compris comment utiliser l’API OpenAI Responses pour réaliser facilement la fonctionnalité de création de réponses officielle d’OpenAI. J’espère que ce document vous aidera à mieux vous connecter et à utiliser cette API. Si vous avez des questions, n’hésitez pas à contacter notre équipe de support technique.