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
Essayer grok-imagine-quality/image-to-image
Entrée
Créations
Voir toutes les créationsSortie
imageTarifs
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
https://api.hiapi.ai/v1/tasks En-têtes
AuthorizationstringRequisClé API du compte. Requise sur chaque requête. Exemple : Bearer YOUR_HIAPI_API_KEY. Obtenir une clé API
Content-TypestringOptionnelLe 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-KeystringOptionnelClé 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.
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
modelstringRequisValeur fixe actuelle : grok-imagine-quality/image-to-image
routestringOptionnelValeur 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 8000Texte 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 3Tableau 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.
1k2kaspect_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.
auto2:120:919.5:916:94:33:21:1Tout afficher (6)
2:33:49:169:19.59:201:2output_formatstringOptionnelDéfaut: "jpeg"Format de l'image de sortie, sous forme de chaîne ; par défaut jpeg.
jpegpngwebpcallbackobjectOptionnel
Configuration de notification d'état terminal. Sans elle, aucun callback — interrogez la tâche vous-même.
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.
urlstringRequisObligatoire 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.
finalstoragestringOptionnelDé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.
temppersistentExemples 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
https://api.hiapi.ai/v1/tasks/:id Champs de réponse
taskIdstringRequisIdentifiant de tâche, toujours préfixé tk-hiapi-.
modelstringRequisNom 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.
routestringOptionnelPrésent uniquement si le paramètre route explicite a été utilisé ; renvoie la valeur soumise.
statusstringRequisStatut de la tâche.
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.
creatednumberRequisDate de création de la tâche (secondes Unix).
completednumberRequisSecondes 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
urlstringRequisURL de l'artefact, téléchargeable directement.
typestringRequisValeurs possibles actuelles : video, image, audio, first_frame, last_frame, thumbnail ; d'autres pourront s'ajouter.
expireAtnumberRequisSecondes Unix de disponibilité de l'artefact ; téléchargez ou transférez avant l'expiration.
errorobjectOptionnel
Présent uniquement si status == fail.
codestringRequisCode d'erreur métier.
messagestringRequisDescription 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"
}
}
} Articles
Voir tous les articles →-
Tutoriel
Comment utiliser kling-4.0/text-to-video via l'API HiAPI : curl, Python et un exemple de requête fonctionnel
Guide pratique pour les développeurs : prompts cinématographiques, audio synchronisé, interrogation asynchrone et téléchargement des sorties
-
Tutoriel
Utiliser Kandinsky 6.0 Pro texte-vers-vidéo sur HiAPI : tutoriel curl et Python
Démonstration pratique axée sur la requête : construire l'appel du prompt au clip vidéo, soumettre la requête, interroger l'état d'achèvement et télécharger le résultat
-
Tutoriel
Comment appeler kling-4.0/image-to-video sur HiAPI : curl, Python et interrogation périodique
-
Tutoriel
Comment appeler hailuo-2.3/text-to-video via l'API HiAPI : curl, Python et exemples de requêtes exécutables
-
Tutoriel
Tutoriel pour kandinsky-6.0-pro/image-to-video sur HiAPI : curl + Python
Lancer une requête image-vers-vidéo exploitable sur HiAPI : de l'envoi de la première image à l'interrogation asynchrone jusqu'au téléchargement final
-
Tutoriel
Comment appeler hailuo-2.3-fast/image-to-video via l'API HiAPI : curl et Python en pratique
La première requête exploitable du palier image-vers-vidéo rapide et économique — de l'ID du modèle au téléchargement du MP4
Modèles associés
Voir tous les modèles →Même type
-
Recraft Crisp Upscale Recraft $0.004 /image -
FASHN Tryon v1.6 FASHN $0.107 /image -
Qwen Image 2.1 Alibaba $0.020 /image -
Qwen Image 2.0 Alibaba $0.042 /image -
FLUX.1 Fill Pro Black Forest Labs $0.071 /image -
Nano Banana Google $0.021 /image -
Nano Banana 2 Lite Google $0.033 /image -
FLUX.1 Schnell Black Forest Labs $0.005 /image -
Recraft Creative Upscale Recraft $0.357 /image -
Ideogram V4 Ideogram $0.050 /image -
Seedream 4.5 ByteDance $0.045 /image -
Imagen 4 Google $0.030 /image







