Processus de demande
Pour utiliser l’API OpenAI Images Generations, vous pouvez d’abord vous rendre sur la page OpenAI Images Generations API et cliquer sur le bouton « Acquire » pour obtenir les informations d’identification nécessaires à la demande :
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 vous être connecté ou inscrit, vous serez automatiquement renvoyé à la page actuelle.
Lors de la première demande, un quota gratuit sera offert, vous permettant d’utiliser cette API gratuitement.
Utilisation de base
Ensuite, vous pouvez remplir les informations correspondantes sur l’interface, comme indiqué sur l’image :
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 DALL-E, ici nous avons principalement 1 type de modèle, les détails peuvent être consultés dans les modèles que nous fournissons. Le dernier paramètre est prompt, prompt est le mot clé que nous entrons pour générer l’image.
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 « Try » pour effectuer un test.
created, l’ID de la génération de cette image, utilisé pour identifier de manière unique cette tâche.data, qui contient les informations sur le résultat de la génération d’images.
data contient les informations spécifiques sur l’image générée par le modèle, et son url est le lien détaillé vers l’image générée, comme on peut le voir sur l’image ci-dessous.
Paramètre de qualité d’image quality
Nous allons maintenant expliquer comment définir certains paramètres détaillés des résultats de génération d’images, où le paramètre de qualité d’image quality comprend deux types : le premier standard indique que l’image générée est standard, et l’autre hd indique que l’image créée a des détails plus fins et une plus grande cohérence.
Voici comment définir le paramètre de qualité d’image sur standard, les paramètres spécifiques sont illustrés sur l’image ci-dessous :
standard est illustrée ci-dessous :
hd pour obtenir l’image illustrée ci-dessous :
hd a des détails plus fins et une plus grande cohérence par rapport à celle générée avec standard.
Paramètre de taille d’image size
Nous pouvons également définir la taille des images générées, nous pouvons effectuer les réglages suivants.
Réglez la taille de l’image à 1024 * 1024, les réglages spécifiques sont illustrés ci-dessous :
1024 * 1024, comme illustré ci-dessous :
1792 * 1024, et vous pouvez obtenir l’image illustrée ci-dessous :
On peut voir que la taille de l’image est clairement différente, et il est également possible de définir d’autres tailles, pour plus d’informations, veuillez consulter notre documentation officielle.
Paramètre de style d’image style
Le paramètre de style d’image style contient deux paramètres, le premier vivid indique que l’image générée est plus vivante, l’autre natural indique que l’image générée est plus naturelle.
Réglez le paramètre de style de l’image sur vivid, les réglages spécifiques sont illustrés ci-dessous :
vivid est illustrée ci-dessous :
natural, et vous pouvez obtenir l’image illustrée ci-dessous :
vivid produit des images plus vivantes et réalistes que natural.
Paramètre de format de lien d’image response_format
Le dernier paramètre de format de lien d’image response_format a également deux options, la première b64_json encode le lien de l’image en Base64, l’autre url est un lien d’image ordinaire, que vous pouvez consulter directement.
Réglez le paramètre de format de lien d’image sur url, les réglages spécifiques sont illustrés ci-dessous :
url du lien de l’image générée URL de l’image c’est accessible directement, le contenu de l’image est illustré ci-dessous :
b64_json, pour obtenir le lien de l’image encodée en Base64, le résultat spécifique est illustré ci-dessous :
Appel asynchrone
Étant donné que le temps de génération d’images de l’API OpenAI peut être relativement long, si l’API ne répond pas pendant une longue période, la requête HTTP maintiendra la connexion, entraînant une consommation supplémentaire de ressources système, c’est pourquoi cette API propose également un support de rappel asynchrone. Le processus global est le suivant : lorsque le client initie une demande, il spécifie un champcallback_url supplémentaire, après que le client ait lancé la demande API, l’API renverra immédiatement un résultat, contenant un champ d’information task_id, représentant l’ID de la tâche actuelle. Lorsque la tâche est terminée, le résultat de l’image générée sera envoyé au callback_url spécifié par le client sous forme de POST JSON, qui inclura également le champ task_id, permettant ainsi de relier le résultat de la tâche par ID.
Voyons comment procéder à travers un exemple.
Tout d’abord, le rappel Webhook est un service capable de recevoir des requêtes HTTP, le développeur doit le remplacer par l’URL de son propre serveur HTTP. Pour des raisons de démonstration, nous utilisons un site Web de modèle Webhook public https://webhook.site/, en ouvrant ce site, vous obtiendrez une URL Webhook, comme illustré ci-dessous :
Copiez cette URL, vous pouvez l’utiliser comme Webhook, l’exemple ici est https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab.
Ensuite, nous pouvons définir le champ callback_url sur l’URL Webhook ci-dessus, tout en remplissant les paramètres correspondants, comme le montre le code suivant :
task_id dans le résultat, le champ data contient les mêmes résultats de génération d’images que l’appel synchrone, et le champ task_id permet de relier la tâche.
Gestion des erreurs
Lors de l’appel de 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 requêtes, vous avez dépassé la limite de taux.500 api_error: Erreur interne du serveur, quelque chose s’est mal passé sur le serveur.