xAI

Grok Imagine Quality

grok-imagine-quality/text-to-image

Modèle de génération et d'édition d'images haute fidélité de xAI, plus stable sur le rendu du texte et la composition, avec prise en charge des sorties 1K/2K et de l'édition cohérente à partir d'images de référence

grok-imagine-quality/image-to-image grok-imagine-quality/text-to-image

Essayer grok-imagine-quality/text-to-image

Entrée

Créations

Voir toutes les créations

Sortie

image

Renseignez les paramètres et générez : les résultats s'afficheront ici.

Tarifs

grok-imagine-quality/text-to-image per image

Spécifications	Prix unitaire
1K	$0.070
2K	$0.100

Présentation et positionnement

grok-imagine-quality/text-to-image est un modèle texte-image haute fidélité lancé par xAI, appartenant à la gamme d'images Grok Imagine et orienté vers la qualité de rendu final. Il génère des images photoréalistes à partir de prompts textuels, prend en charge deux niveaux de résolution (1k et 2k), 13 ratios d'aspect ainsi que trois formats de sortie (jpeg, png, webp), avec un prompt unique pouvant atteindre 8000 caractères. Comparé à la version standard, il est plus performant en netteté des détails, en naturel des textures et de l'éclairage, en rendu du texte intégré à l'image et en stabilité de la composition ; il convient donc davantage aux développeurs qui ont besoin de livrer directement un produit fini, plutôt qu'aux scénarios de simples ébauches créatives.

Points forts essentiels

Niveau haute fidélité orienté sortie de qualité finale — les détails, les textures et l'éclairage sont plus aboutis que ceux du Grok Imagine standard, et les résultats générés se rapprochent davantage d'images directement utilisables.
Prise en charge des résolutions 1k et 2k — la même interface permet de passer d'un essai rapide en basse résolution à un rendu soigné en 2k, sans changer de modèle ni de canal.
13 ratios d'aspect couvrant les mises en page courantes — des ratios allant de 1:1 à 16:9, 9:16, 20:9, etc., peuvent être spécifiés directement, adaptés aux affiches horizontales, aux formats verticaux pour les réseaux sociaux et aux bannières grand écran.
Rendu du texte intégré à l'image plus précis — la restitution des visuels comportant de la typographie est meilleure, ce qui réduit les reprises liées à un texte mal formé dans les scénarios d'affiches et de graphismes pour les réseaux sociaux.

Description des capacités

Génération d'images photoréalistes à partir de prompts textuels : il suffit de saisir une description pour générer une image ; le prompt peut atteindre 8000 caractères, ce qui permet d'inclure une description assez complète de la scène, du style et du sujet.

Résolution et ratio contrôlables : resolution permet de choisir 1k ou 2k, et aspect_ratio de spécifier le cadrage parmi 13 ratios, pour une sortie directement alignée sur la mise en page du support cible.

Format de sortie au choix : les formats jpeg, png et webp sont pris en charge, ce qui permet de choisir l'encodage adapté à l'affichage front-end, à l'archivage des ressources ou à un processus de compression ultérieur.

Restitution d'entités nommées : la précision de rendu des entités nommées telles que les marques, les personnalités publiques ou les lieux précis est relativement élevée ; le sujet peut être nommé directement dans le prompt.

Cas d'usage

Production de supports publicitaires et marketing — saisir les arguments produit et la description visuelle pour générer un visuel principal carré ou horizontal en 2k, destiné aux Hero Banners, aux affiches et aux supports de campagne.
Conception d'illustrations et de vignettes pour les réseaux sociaux — générer aux ratios 16:9 ou 9:16 des visuels de couverture intégrant de la typographie, directement utilisables comme vignettes vidéo et illustrations pour les réseaux sociaux.
Workflow itératif de l'ébauche au rendu soigné — générer d'abord en lot des directions créatives en 1k, puis, après sélection, régénérer en 2k pour la version finale à livrer.
Génération de scènes avec sujets nommés — spécifier dans le prompt un modèle de véhicule, un lieu ou une marque précise pour générer des images contextualisées, destinées à la présentation de concepts et à l'illustration de contenus.

Limites et conseils de sélection

La qualité d'image se fait au détriment de la vitesse de génération : le rythme de production est plus lent que celui du modèle d'image Grok Imagine standard, ce qui le rend inadapté aux scénarios nécessitant de nombreux essais rapides en grande quantité. Pour les tâches à haute résolution ou exigeant une grande rigueur sur les sujets nommés et les détails de l'image, plusieurs ajustements du prompt peuvent être nécessaires pour atteindre le résultat attendu ; il est recommandé de valider d'abord la direction en 1k avant de générer en 2k. Le canal actuel ne couvre que la génération texte-image ; pour une édition ciblée à partir d'une image existante, il faut se tourner vers le modèle image-image de la même gamme. Le coût est facturé à l'image, selon le panneau tarifaire de la plateforme.

Questions fréquentes

Voir toutes les questions →

À quels types de visuels finaux Grok Imagine Quality est-il adapté ?

Aux visuels principaux, couvertures, concepts publicitaires et images de scène de haute qualité nécessitant des matériaux, des jeux d'ombre et de lumière, une atmosphère et des détails plus marqués.
Comment se fait la facturation pour 1k et 2k ?

1k et 2k utilisent des tarifs unitaires par image différents ; le format et le format de sortie n'entraînent aucun frais supplémentaire ; les montants exacts sont ceux du tarif en temps réel indiqué sur cette page.
Pourquoi ne pas utiliser directement le niveau standard ?

Le niveau standard est plus adapté aux brouillons en masse et lorsque la rapidité est prioritaire ; ne choisissez Quality que lorsque le rendu final accorde plus d'importance aux matériaux et aux détails.
Prenez-vous en charge les images de référence ?

La génération d'images à partir de texte actuelle n'accepte pas d'image de référence ; pour une édition de haute qualité à partir d'une image de référence, veuillez utiliser grok-imagine-quality/image-to-image.

Créer une tâche de génération

POST https://api.hiapi.ai/v1/tasks

En-têtes

AuthorizationstringRequis

Clé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API

Content-TypestringOptionnel

Le corps de la requête est toujours analysé en JSON ; s'il est envoyé, seul application/json (charset facultatif) est accepté — toute autre valeur renvoie 415. Exemple : application/json.

Idempotency-KeystringOptionnel

Clé d'idempotence, jusqu'à 255 octets. Les reprises avec la même clé du même compte ne créent la tâche qu'une seule fois ; les rejeux renvoient le taskId d'origine.

Clé d'idempotence

En cas de timeout réseau ou de relance automatique du client, la même clé ne crée la tâche qu'une seule fois, sans double facturation (portée = le compte de la clé API). Utilisez un identifiant métier unique (ex. "order-42") ; les rejeux renvoient le taskId d'origine et les clés expirent 24 h après la première requête. La matrice complète des scénarios est dans la présentation de l'API asynchrone unifiée.

Corps

modelstringRequis

Valeur fixe actuelle : grok-imagine-quality/text-to-image

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

Objet de paramètres métier pour grok-imagine-quality/text-to-image et la route default — voir le tableau des paramètres ci-dessous.

promptstringRequisminLength 1maxLength 8000

Description textuelle utilisée pour générer l'image, sous forme de chaîne de caractères, décrivant le contenu visuel souhaité.

resolutionstringOptionnelDéfaut: "1k"

Résolution de l'image de sortie, sous forme de chaîne de caractères, valeur par défaut 1k.

Options：1k2k

aspect_ratiostringOptionnelDéfaut: "1:1"

Rapport largeur-hauteur de l'image générée, sous forme de chaîne de caractères, valeur par défaut 1:1.

Options：2:120:919.5:916:94:33:21:12:3

Tout afficher (5)

3:49:169:19.59:201:2

output_formatstringOptionnelDéfaut: "jpeg"

Format de l'image de sortie, sous forme de chaîne de caractères, valeur par défaut jpeg.

Options：jpegpngwebp

callbackobjectOptionnel

Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.

Rappels (Webhook)

Fournissez callback.url à la création et HiAPI envoie un POST à votre service à l'état terminal — plus besoin de polling. Le corps du rappel reprend la structure du détail de tâche ; vérification de signature, relances et idempotence sont décrits dans la présentation de l'API asynchrone unifiée.

urlstringRequis

Obligatoire si callback est présent. Un POST est envoyé vers cette URL à l'état terminal ; doit être une URL http(s) valide.

whenstringOptionnelDéfaut: "final"

Seul final est pris en charge pour l'instant — notifié sur success et fail.

Options：final

storagestringOptionnelDéfaut: "temp"

Niveau de stockage des artefacts : temp (par défaut, ~7 jours) ou persistent (long terme, facturé au volume). Solde insuffisant ou dépassement de limite ⇒ rétrogradation silencieuse en temp ; le niveau effectif figure dans la réponse de détail.

Options：temppersistent

Exemples de requête

# Soumet une tâche asynchrone ; renvoie immédiatement un taskId (n'attend pas la génération)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "grok-imagine-quality/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1k",
    "aspect_ratio": "1:1",
    "output_format": "jpeg"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "grok-imagine-quality/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1k",
      "aspect_ratio": "1:1",
      "output_format": "jpeg"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "grok-imagine-quality/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1k",
          "aspect_ratio": "1:1",
          "output_format": "jpeg"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obtenir le détail de la tâche

GET https://api.hiapi.ai/v1/tasks/:id

Champs de réponse

taskIdstringRequis

Identifiant de tâche, toujours préfixé tk-hiapi-.

modelstringRequis

Nom complet résolu du modèle. Les tâches envoyées avec le paramètre route renvoient base@route (ex. gpt-image-2/text-to-image@ext) ; sinon identique au nom fourni.

routestringOptionnel

Présent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.

statusstringRequis

Statut de la tâche.

Valeurs de statut

queued En file, pas encore démarrée. handling En cours de traitement. archiving Traitement terminé, préparation des artefacts. success Terminal : terminé, artefacts disponibles (output renvoyé). fail Terminal : échec (error renvoyé). Après soumission, suivez status : success et fail sont terminaux, le reste non terminal. Interrogez toutes les 1–3 s jusqu'à l'état terminal. En cas de succès, téléchargez les artefacts via output[].url et transférez-les avant expireAt ; pour une conservation longue durée, indiquez storage: "persistent" à la création.

creatednumberRequis

Date de création de la tâche (secondes Unix).

completednumberRequis

Secondes Unix de l'état terminal ; 0 tant que non terminal.

outputarrayOptionnel

Présent uniquement si status == success. Liste d'artefacts — toujours un tableau ; une tâche peut renvoyer plusieurs types à la fois (ex. video + first_frame).

Array [ object ]

Éléments du tableau

urlstringRequis

URL de l'artefact, téléchargeable directement.

typestringRequis

Valeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.

expireAtnumberRequis

Secondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.

errorobjectOptionnel

Présent uniquement si status == fail.

codestringRequis

Code d'erreur métier.

messagestringRequis

Description de l'erreur.

Exemples de réponse

Succès

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

En cours (non terminal)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Échec

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}