SpaceXAI: Grok Imagine Image Quality
Grok Imagine Image Quality génère et monte des images en mettant l’accent sur le réalisme, le rendu de texte et le contrôle créatif. Utilisez un brief textuel précis et des références facultatives pour développer des visuels de produits, des ressources de campagnes, 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 montage d’images de SpaceXAI qui met l’accent sur les détails réalistes, un meilleur rendu de texte et le respect étroit d’un brief créatif. Il accepte du texte et des références d’image facultatives et renvoie une image. Ses usages comprennent la visualisation de produits, les créations de campagnes, les ressources pour les réseaux sociaux, les illustrations et les icônes de style interface, avec une gamme de styles incluant l’imagerie photographique et cinématographique ainsi que les créations graphiques.
Pour une scène de produit, décrivez l’objet, l’agencement, la matière, l’éclairage et la vue de caméra avant d’ajouter le 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 de pierre avec une palette définie et de l’espace pour un titre. Pour une icône ou un graphique, précisez 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.
Le montage ajoute une image source à l’instruction. Les références d’image stockées dans le processus du producteur doivent être entièrement téléversées et utiliser PNG, JPEG ou WebP. Nommez la modification et ce qui doit être préservé : un nouvel arrière-plan, 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, comme le produit d’une image et l’apparence de marque d’une autre. Gardez la référence de 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 choisie comme entrée du montage suivant et gardez la nouvelle instruction centrée sur la transformation. Pour une variante de campagne, conservez le sujet et la hiérarchie réussis en changeant l’environnement ou le texte complémentaire. Cela développe une image par étapes explicites plutôt que d’attendre d’un prompt ultérieur qu’il se souvienne d’une ressource antérieure qui n’a pas été fournie.
La typographie et les textures fines font partie de l’accent créatif du modèle Quality. Fournissez les mots, les chiffres et les emplacements 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. Inspectez 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 tout de même provenir du brief et des références approuvés.
Le processus d’image du producteur prend en charge les résolutions 1K et 2K et les compositions paysage, carré ou portrait, avec sélection automatique du format lorsqu’aucun n’est précisé. Choisissez le format de l’image selon le sujet et le placement du texte au lieu de traiter la résolution comme un substitut à la mise en page. Plusieurs variantes peuvent être demandées au moyen du réglage commun du nombre d’images générées, qui va d’une à dix images, avec une image par défaut. Comparer les variantes est utile pour choisir une composition; cela ne prouve pas que chaque détail demandé est présent dans chaque résultat.
Les images sont normalement renvoyées par des emplacements hébergés temporaires, avec livraison en base64 disponible lorsque l’image doit être incluse directement dans une ressource d’application. Conservez la ressource réelle sélectionnée au lieu de compter sur un emplacement temporaire comme seule copie du projet. L’intégration de fichiers d’image du producteur démontre aussi l’utilisation d’identifiants d’images stockées comme références et le stockage des fichiers d’images générées pour 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 étendus de références ou de ratios ne doivent pas être considérés comme des réglages de ce profil. Demander plusieurs variantes dans un appel d’image est aussi différent de l’API Batch du fabricant, que la page exacte du modèle Quality n’indique pas comme prise en charge. Gardez le choix du modèle, le prompt, les références et la sortie sélectionnée de l’image reliés lorsque vous préparez 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 distincte, mais le résultat propre au modèle d’image reste une image. Préservez la version réussie et les références pour qu’un montage 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-qualityPour commencer
Grok Imagine Image Quality génère et monte des images en mettant l’accent sur le réalisme, le rendu de texte et le contrôle créatif. Utilisez un brief textuel précis et des références facultatives pour développer des visuels de produits, des ressources de campagnes, 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 · Jetons en entrée · Estimation à des fins de comparaison uniquement — / 1K jetons Sortie · Jetons en sortie · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Lecture du cache · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Écriture dans le cache · Estimation à des fins de comparaison uniquement — / 1K jetons Entrée · Écriture dans le cache, 1 h · Estimation à des fins de comparaison uniquement — / 1K jetons |
| Configurationimage d’entrée | Barème tarifaire— | Quantité prévisionnelle— | Unité de facturationpar image en entrée | Coût Entrée · image d’entrée · Estimation à des fins de comparaison uniquement $0.02 par image en entrée |
| ConfigurationCoût de génération estimé | 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