SpaceXAI: Grok Imagine Image Quality
Grok Imagine Image Quality génère et retouche des images en mettant l’accent sur le réalisme, le rendu du texte et le contrôle créatif. Utilisez un brief textuel précis et des références facultatives pour développer des visuels produit, des ressources de campagne, des icônes ou une révision ciblée d’une image existante.
À propos du modèle
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Grok Imagine Image Quality est le modèle nommé de génération et de retouche d’images de SpaceXAI, mettant l’accent sur le détail réaliste, un meilleur rendu du texte et le respect précis d’un brief créatif. Il accepte du texte et des images de référence facultatives et renvoie une image. Ses usages comprennent la visualisation de produits, les créations de campagne, les ressources pour les réseaux sociaux, les illustrations et les icônes de type interface, avec une gamme de styles incluant les images photographiques et cinématographiques ainsi que les créations graphiques.
Pour une scène de produit, décrivez l’objet, la disposition, la matière, l’éclairage et la vue de caméra avant d’ajouter un style décoratif. Fournissez une référence lorsque la forme ou les caractères du produit doivent rester reconnaissables. Un brief utile peut placer une petite bouteille étiquetée sur une surface en pierre, avec une palette définie et de l’espace pour un titre. Pour une icône ou un graphique, indiquez la forme, le contraste et l’échelle visuelle prévue. Le résultat est une image rendue plutôt qu’une interface fonctionnelle ou un fichier de mise en page modifiable.
La retouche ajoute une image source à l’instruction. Les références d’images stockées dans le processus du producteur doivent être entièrement importées et utiliser PNG, JPEG ou WebP. Nommez le changement et ce qui doit être préservé : un nouveau fond, une autre matière, une transformation de style ciblée ou une légende corrigée. Lorsque plusieurs références contribuent à une composition, décrivez leurs rôles séparément, par exemple le produit d’une image et l’aspect de marque d’une autre. Gardez la référence produit originale disponible pour que les révisions ultérieures ne perdent pas l’identité établie dans la première ressource.
Une séquence pratique peut commencer par un rendu de produit, puis placer ce même visuel dans un autre décor ou une composition imprimée. Utilisez la sortie sélectionnée comme entrée de la retouche suivante et gardez la nouvelle instruction centrée sur la transformation. Pour une variation de campagne, conservez le sujet et la hiérarchie réussis tout en changeant l’environnement ou le texte d’accompagnement. Cela développe une image par étapes explicites au lieu d’attendre d’un prompt ultérieur qu’il se souvienne d’une ressource antérieure non fournie.
La typographie et les textures fines font partie des axes créatifs du modèle Quality. Fournissez les mots, chiffres et placements exacts pour un menu, une étiquette ou une publicité, et décrivez comment le texte doit s’intégrer à la matière ou à la composition. Examinez l’orthographe, l’ordre de lecture et les petits caractères à la taille d’affichage réelle. Une texture réaliste peut soutenir la présentation visuelle d’un produit, tandis que ses attributs factuels doivent toujours provenir du brief et des références approuvés.
Le processus image du producteur prend en charge les choix de résolution 1K et 2K et les compositions au format paysage, carré ou portrait, avec sélection automatique du format lorsqu’aucun n’est précisé. Choisissez la forme de l’image selon le sujet et le placement du texte, au lieu de considérer la résolution comme un substitut à la mise en page. Plusieurs variantes peuvent être demandées par le réglage commun de nombre d’images générées, allant d’une à dix avec une par défaut. Comparer des variantes est utile pour un choix de composition ; cela n’établit pas que chaque détail demandé figure dans chaque résultat.
Les images sont normalement renvoyées via des adresses hébergées temporaires, avec livraison base64 disponible lorsque l’image doit être incluse directement dans un livrable d’application. Conservez la ressource sélectionnée elle-même au lieu de dépendre d’une adresse temporaire comme seule copie du projet. L’intégration de fichiers image du producteur montre aussi l’utilisation d’identifiants d’images stockées comme références et le stockage de fichiers image générés pour un usage ultérieur. Ces choix de livraison et de stockage sont distincts du brief visuel qui détermine ce que l’image doit représenter.
Le modèle nommé Image Quality est distinct du paramètre de qualité low, medium et auto de Grok Imagine Image 2.0. Ces commandes de qualité ultérieures et les choix élargis de références ou de rapports de format ne doivent pas être considérés comme des réglages de ce profil. Demander plusieurs variantes dans un appel image diffère aussi de l’API Batch du fabricant, que la page exacte du modèle Quality ne liste pas comme prise en charge. Gardez liés le choix de modèle, le prompt, les références et la sortie sélectionnée de l’image pour préparer un processus reproductible.
Pour une image terminée utile, comparez la scène demandée, les détails du produit, la typographie et les éléments préservés au brief, puis révisez la partie précise qui a manqué l’objectif. Une image fixe générée peut devenir une référence pour une tâche vidéo séparée, mais le livrable propre au modèle d’image reste une image. Préservez la version réussie et les sources de référence pour qu’une retouche de campagne ou un changement de placement ultérieur puisse affiner la même direction créative.
Ailoot Ultra · Génération d’images POST /v1/images/generations x-ai/grok-imagine-image-quality
x-ai/grok-imagine-image-quality
x-ai/grok-imagine-image-qualityPremiers pas
Grok Imagine Image Quality génère et retouche des images en mettant l’accent sur le réalisme, le rendu du texte et le contrôle créatif. Utilisez un brief textuel précis et des références facultatives pour développer des visuels produit, des ressources de campagne, des icônes ou une révision ciblée d’une image existante.
- Entrées acceptées
- Texte · Images
- Résultats
- Images
Disponible dans Ailoot · entrées et méthodes
Ailoot Ultra · Génération d’images POST /v1/images/generations
- Entrée
text,image- Sortie
image
| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites x-ai/grok-imagine-image-quality | Par défaut— |
Champprompt | Typestring | ExigenceObligatoire | Valeurs et limites Longueur minimale: 1 | Par défaut— |
Champresolution | Typestring | ExigenceFacultatif | Valeurs et limites 1K, 2K | Par défaut— |
Champaspect_ratio | Typestring | ExigenceFacultatif | Valeurs et limites 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto | Par défaut— |
Champn | Typeinteger | ExigenceFacultatif | Valeurs et limites Minimum: 1 Maximum: 1 | Par défaut— |
Champinput_references | Typearray | ExigenceFacultatif | Valeurs et limites Nombre minimal d’éléments: 0 Nombre maximal d’éléments: 3 | Par défaut— |
Champprovider | Typeobject | ExigenceFacultatif | Valeurs et limites | Par défaut— |
Paramètres et cycle de vie de la méthode
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, prompt |
Paramètrematerial_types | Contrattext, image |
Cycle de vie : synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id effectivement renvoyé ou enregistrement de la bibliothèque multimédia
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Tarifs
Calcul du coût final
Les tarifs affichés servent à estimer le coût avant la génération. Le montant final est calculé à partir du coût enregistré pour la génération d’origine. La durée mesurée du résultat et les quantités prévisionnelles ne constituent pas la quantité finale facturable.
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
- Mode rapide
- Non précisé Lorsque le mode rapide est sélectionné
- Mode Flex
- Non précisé Lorsque le mode flex est sélectionné
- Effort de raisonnement maximal
- Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)
Tarifs estimés à des fins de comparaison
Prix par configuration
Associez chaque coût aux conditions indiquées. Utilisez un seul tarif pour chaque ensemble de configurations alternatives.
| Configuration | Barème tarifaire | Quantité prévisionnelle | Unité de facturation | Coût |
|---|---|---|---|---|
| ConfigurationTarifs de base des jetons | Barème tarifaireTarif de base | Quantité prévisionnelle— | Unité de facturation— | Coût Entrée · Tokens en entrée · Estimation à des fins de comparaison uniquement — / 1K tokens Sortie · Tokens en sortie · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K tokens Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K tokens |
| Configurationimage en entrée | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar image en entrée | Coût Entrée · image en entrée · Estimation à des fins de comparaison uniquement $0.02 par image en entrée |
| ConfigurationCoût estimé de la génération | Barème tarifaire— | Quantité prévisionnelleEstimation pour une génération | Unité de facturation— | Coût Sortie · Coût estimé de génération · Estimation à des fins de comparaison uniquement $0.1 estimation avant génération Cette estimation ne constitue ni des frais supplémentaires ni un tarif fixe pour la génération terminée. |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
Exemples de requêtes
Ailoot Ultra · Génération d’images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'x-ai/grok-imagine-image-quality', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Recevoir et enregistrer les résultats
Ailoot Ultra · Génération d’images
Téléchargez chaque image renvoyée ou enregistrez son contenu Base64
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Autres lectures de contenu
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Conserver tous les résultats terminés
Enregistrez chaque image terminée ; récupérez chaque URL renvoyée ou décodez son contenu Base64.
Conservez la réponse complète et les en-têtes, chaque sortie effective, les identifiants initialement renvoyés et tous les champs d’utilisation. Récupérez l’opération d’origine sans soumettre à nouveau sa création.
Si la réponse d’origine doit être vérifiée
Conservez le X-Client-Request-ID renvoyé pour le rapprochement. Consultez uniquement les valeurs task_id/asset_id effectivement renvoyées ou votre bibliothèque multimédia ; ne construisez jamais une URL de tâche à partir de l’identifiant de l’opération et ne soumettez jamais à nouveau la création.
Champs de la réponse
| Champ | Type |
|---|---|
Champcreated | Type |
Champdata[].url | Type |
Champdata[].b64_json | Type |
Champusage | Type |
Alias
Alias du modèle
Ailoot Ultra x-ai/grok-imagine-image-quality
Alias des chemins de méthode
/v1/images
ID d’appel associés
FAQ · SpaceXAI: Grok Imagine Image Quality
- Quelles entrées et quels résultats sont disponibles ?
POST /v1/images/generations·x-ai/grok-imagine-image-quality:text,image→image- Quels champs la requête utilise-t-elle ?
POST /v1/images/generations·x-ai/grok-imagine-image-quality:model,prompt,resolution,aspect_ratio,n,input_references,provider- Quelles limites s’appliquent ?
POST /v1/images/generations·x-ai/grok-imagine-image-quality:n.minimum:1;n.maximum:1