API Grok Image pour la génération et l'édition
Accédez à Grok Image via l'API indépendante de GoEnhance. Générez à partir d'un prompt textuel ou fournissez jusqu'à neuf images de référence pour l'édition image-vers-image, puis récupérez le résultat asynchrone par polling ou par callback HTTPS. GoEnhance n'est pas xAI et ceci n'est pas l'API officielle de xAI.
Créer une clé API
Un seul endpoint pour les nouvelles images et les éditions guidées par références
Génération texte-image
Définissez model sur grok-image, envoyez un prompt de 1–2 000 caractères et choisissez 2:3, 3:2, 1:1, 9:16 ou 16:9. Le ratio s'applique aux requêtes en texte seul.
Édition à partir d'images de référence
Ajoutez image_list avec une à neuf URL d'images accessibles pour lancer une génération image-vers-image. En présence de références, le champ de ratio documenté est ignoré.
N'utilisez que les champs de requête documentés et validez-les avant l'envoi.
Capacités de l'API Grok Image
Endpoint d'images unifié
Envoyez du JSON en POST vers <code>https://api.goenhance.ai/api/v1/images/generations</code>.
Sélection précise du modèle
Définissez la valeur obligatoire de <code>model</code> sur <code>grok-image</code>.
Validation du prompt
Fournissez un prompt textuel obligatoire comptant entre 1 et 2 000 caractères.
Images de référence facultatives
Fournissez un à neuf objets d'URL dans <code>image_list</code> pour les requêtes image-vers-image.
Ratios pour le texte seul
Choisissez 2:3, 3:2, 1:1, 9:16 ou 16:9 lorsqu'aucune liste de références n'est fournie.
Traitement asynchrone du résultat
Conservez <code>img_uuid</code>, puis interrogez le détail du job par polling ou traitez les événements de callback HTTPS.
La documentation actuelle de GoEnhance indique un tarif fixe pour chaque image générée.
Tarifs de l'API Grok Image
1,3 token par image
Chaque génération Grok Image réussie est documentée à 1,3 token GoEnhance.
$0.026 par image
L'équivalent documenté en dollars est de $0.026 pour chaque image générée.
Gérer les réponses liées au solde
Vérifiez le code de la réponse JSON en plus du statut HTTP ; un solde de tokens insuffisant peut renvoyer <code>code: 100</code>.
Intégrez l'API Grok Image en quatre étapes
1
1. Créez une clé API
Créez une clé GoEnhance et envoyez-la depuis votre serveur dans l'en-tête
Authorization. 2
2. Construisez la requête
Envoyez en POST
model: grok-image avec un prompt. Ajoutez image_list pour l'édition guidée par références, ou choisissez un ratio pris en charge pour la génération texte-image. 3
3. Suivez le job et lisez le résultat
Lisez
data.img_uuid dans une réponse réussie et associez-le à votre propre enregistrement de job. Interrogez ensuite GET /api/v1/jobs/detail par polling ou fournissez une custom_callback_url HTTPS publique, en traitant le traitement en cours, la réussite et l'échec comme des états explicites.Reliez la génération et l'édition d'images à des produits qui gèrent déjà les prompts, la relecture et la diffusion.
Cas d'usage développeur pour Grok Image
Illustration éditoriale
Générez des concepts de scènes originaux à partir de briefs d'articles et envoyez-les dans une file de relecture.
Variantes créatives de campagne
Produisez des directions visuelles pilotées par prompt dans les ratios portrait, carré ou paysage pris en charge.
Restylage guidé par références
Utilisez des images sources validées pour créer des variations visuelles maîtrisées, à relire ensuite.
Concept art produit
Transformez des descriptions produit structurées et des références facultatives en supports d'exploration visuelle.
Idéation de personnages et de décors
Créez des concepts préliminaires de personnages, d'accessoires et de décors à partir de prompts descriptifs.
Pipelines créatifs automatisés
Reliez les jobs asynchrones aux callbacks, à la modération, au stockage, à la validation et aux traitements en aval.
Réponses aux questions fréquentes sur les tarifs, les entrées, les ratios et l'intégration.