xAI

Grok Imagine Quality

grok-imagine-quality/image-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/image-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/image-to-image per image

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

Présentation du positionnement

grok-imagine-quality/image-to-image est la version haute fidélité de xAI dédiée à l'édition d'images : il reçoit de 1 à 3 images de référence et une consigne d'édition, puis produit une image finale en résolution 1K ou 2K. Par rapport à la version standard, il progresse en netteté des détails, en textures et en éclairage, en rendu du texte dans l'image et en stabilité de la composition, au prix d'une génération un peu plus lente. Il s'adresse aux développeurs qui exigent une qualité de niveau livrable et réalisent des modifications ciblées à partir d'images de référence, pour des livrables tels que visuels commerciaux, images pour réseaux sociaux et mise en page.

Points forts essentiels

Édition haute fidélité, détails et composition plus stables — par rapport à la version standard, les textures, l'éclairage et le rendu physique sont plus naturels, la composition plus stable, ce qui permet une utilisation directe en livrable et non en simple brouillon.
Deux niveaux de sortie, 1K et 2K — la même interface permet d'itérer rapidement en 1K ou de retoucher finement en 2K, conciliant essais créatifs et produit final.
Images de référence multiples et rapport d'aspect contrôlable — jusqu'à 3 images de référence, avec un choix entre auto ou 13 rapports d'aspect fixes ; auto reprend celui de la première image de référence.
Rendu du texte dans l'image plus précis — la fidélité du texte dans les visuels de mise en page est améliorée, adaptée aux sorties contenant du texte comme les affiches et les graphismes pour réseaux sociaux.

Description des capacités

Édition ciblée à partir d'images de référence : en fournissant de 1 à 3 images de référence accompagnées d'une consigne d'édition en langage naturel, il est possible de modifier de manière ciblée l'image tout en préservant la cohérence du sujet et du style.

Contrôle de la résolution et du rapport d'aspect : deux résolutions, 1K et 2K, avec un rapport d'aspect au choix entre auto ou des proportions courantes portrait et paysage ; le mode auto reprend le rapport de la première image de référence, ce qui facilite l'adaptation à différents emplacements de diffusion.

Sortie multiformat : les formats de sortie jpeg, png et webp s'alignent directement sur les exigences de type de fichier des chaînes de traitement en aval.

Édition avec consigne longue : la consigne d'édition accepte jusqu'à 8000 caractères, ce qui permet de décrire des intentions de modification complexes portant sur plusieurs éléments.

Restauration de sujets nommés : la précision de restauration des sujets nommés tels que marques, personnalités publiques et lieux précis est élevée ; les objets peuvent être désignés directement dans la consigne.

Cas d'usage

Retouche de photos produit par les équipes e-commerce et publicité — à partir d'une photo produit réelle comme référence, ajuster le fond, la lumière et la composition selon la description, pour produire des visuels de qualité livrable directement diffusables.
Création d'affiches et d'images pour réseaux sociaux par les designers — générer à partir d'une image de référence de mise en page existante un visuel intégrant du texte composé, et sortir un graphisme 2K pour une affiche d'événement ou une publication sur les réseaux sociaux.
Itération du croquis à la retouche fine par les équipes créatives — valider rapidement une direction en 1K, puis produire la version finale en 2K, ce qui raccourcit le cycle entre test de concept et livraison.
Séries d'images à style cohérent — générer plusieurs visuels conditionnés par la même image de référence, en conservant l'unité de style et de sujet, pour une production de contenu en série.

Limites et conseils de choix

Il s'agit d'une ligne d'édition d'images : elle exige au moins 1 image de référence au format jpeg, png ou webp accessible publiquement, le SVG n'étant pas pris en charge. Elle ne convient donc pas aux besoins de génération pure à partir de texte, pour lesquels il faut choisir la ligne de génération texte-vers-image de la même série. La consigne d'édition est limitée à 8000 caractères et 3 images de référence au maximum par appel. La qualité primant, la génération est plus lente que la version standard ; les tâches à haute résolution ou nécessitant des ajustements fins des images de référence peuvent demander plusieurs essais pour atteindre le résultat attendu. Seule la sortie d'images est prise en charge, les autres modalités comme la vidéo ne le sont pas.

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/image-to-image

routestringOptionnel

Valeur fixe actuelle : default

inputobjectRequis

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

promptstringRequisminLength 1maxLength 8000

Texte d'instruction d'édition d'image, utilisé pour décrire l'effet de sortie souhaité ; se présente sous forme de chaîne, dont le contenu détermine directement la direction de l'édition.

image_urlsarrayRequisminItems 1maxItems 3

Tableau d'images de référence en entrée, dont les éléments sont des URL d'images accessibles publiquement, prenant en charge les formats jpeg/png/webp, SVG non pris en charge ; le nombre va de 1 à 3 images.

Array [ string ]

resolutionstringOptionnelDéfaut: "1k"

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

Options：1k2k

aspect_ratiostringOptionnelDéfaut: "auto"

Rapport largeur-hauteur de l'image générée, sous forme de chaîne ; lorsqu'il est défini sur auto, il suit le rapport largeur-hauteur de la première image d'entrée ; par défaut auto.

Options：auto2:120:919.5:916:94:33:21:1

Tout afficher (6)

2:33:49:169:19.59:201:2

output_formatstringOptionnelDéfaut: "jpeg"

Format de l'image de sortie, sous forme de chaîne ; 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/image-to-image",
  "input": {
    "prompt": "…",
    "image_urls": "…",
    "resolution": "1k",
    "aspect_ratio": "auto",
    "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/image-to-image",
    input: {
      "prompt": "…",
      "image_urls": "…",
      "resolution": "1k",
      "aspect_ratio": "auto",
      "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/image-to-image",
        "input": {
          "prompt": "…",
          "image_urls": "…",
          "resolution": "1k",
          "aspect_ratio": "auto",
          "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"
    }
  }
}