Source: https://ailoot.ai/models/it/x-ai-grok-imagine-image-2-0/ Canonical: https://ailoot.ai/models/it/x-ai-grok-imagine-image-2-0/ Language: it # xAI: Grok Imagine Image 2.0 [Markdown](https://ailoot.ai/models/it/x-ai-grok-imagine-image-2-0/index.md) · [JSON](https://ailoot.ai/models/it/x-ai-grok-imagine-image-2-0/facts.json) ## [xAI: Grok Imagine Image 2.0](https://ailoot.ai/models/it/x-ai-grok-imagine-image-2-0/) Grok Imagine Image 2.0 crea immagini a partire da brief scritti e modifica immagini esistenti tramite istruzioni in linguaggio naturale. xAI documenta qualità, risoluzione e composizione configurabili, riferimenti a più immagini, trasferimento di stile e perfezionamento iterativo. - [**Ailoot Ultra · Immagini** `POST /v1/images/generations` `x-ai/grok-imagine-image-2.0`](https://ailoot.ai/models/it/x-ai-grok-imagine-image-2-0/#method-0) Informazioni sul modello Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito. Grok Imagine Image 2.0 è il modello di xAI per la generazione e la modifica di immagini. Riceve una descrizione scritta, oppure una descrizione insieme a immagini di partenza, e restituisce un'immagine. Il profilo 2.0 indicato dal produttore comprende la creazione di scene, la modifica di immagini esistenti, la combinazione di soggetti tratti dai riferimenti e la trasformazione dello stile visivo. Per prima cosa, scegli se ti serve una nuova composizione o una modifica specifica a materiale di cui disponi già. #### Creare un'immagine da un brief Descrivi il soggetto principale, l'ambientazione, la composizione, l'illuminazione e il trattamento visivo. Indica ciò che l'osservatore dovrebbe notare per primo e dove verrà utilizzata l'immagine. Per il concept di un prodotto, un brief esemplificativo può descrivere una lampada da scrivania in ceramica su un tavolo in pietra chiara, una luce morbida proveniente dalla finestra, un'inquadratura ravvicinata del materiale e uno spazio libero per un titolo da aggiungere separatamente. Per un'illustrazione, specifica i personaggi, l'azione e l'estetica desiderata, senza aspettarti che una sola parola riferita allo stile definisca l'intera scena. Il produttore documenta da una a dieci immagini in uscita per richiesta di generazione, con una come valore predefinito. Più risultati ottenuti dallo stesso brief offrono alternative da valutare; non garantiscono un soggetto identico in ogni variazione. Controlla il soggetto, la composizione e i dettagli importanti, poi conserva la versione che risponde meglio al brief. Tieni insieme il brief e la variazione selezionata, così che le modifiche successive utilizzino la composizione desiderata. #### Composizione, risoluzione e qualità La guida alla generazione documenta la scelta automatica del rapporto d'aspetto oppure l'impostazione di un rapporto esplicito. Le opzioni elencate comprendono 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9 e 5:2. Scegli il formato in funzione della destinazione: quadrato per un riquadro compatto, verticale per una composizione in altezza oppure orizzontale per una scena ampia. Specifica il soggetto che deve restare visibile dopo il ritaglio e lo spazio richiesto dall'impaginazione, anziché affidarti soltanto al rapporto d'aspetto. Le impostazioni documentate per la risoluzione di generazione sono 1k e 2k, con 1k come valore predefinito. La qualità è un controllo separato, con le opzioni low, medium e auto. Nella guida attuale di xAI, auto è l'opzione predefinita e usa low per la generazione e medium per la modifica; impostare esplicitamente low o medium rende fissa quella scelta. Risoluzione e qualità descrivono quindi controlli diversi. Indica i dettagli visivi importanti e verificali nell'immagine restituita, senza considerare nessuna delle due impostazioni una garanzia di precisione dei testi, della geometria o della conservazione del soggetto. #### Modificare le immagini e trasferire lo stile visivo Fornisci l'immagine da modificare e descrivi il cambiamento richiesto in relazione al contenuto visibile. Una modifica mirata potrebbe chiedere di sostituire una parete scura con una superficie in intonaco chiaro, mantenendo la disposizione dei mobili, il punto di vista della fotocamera e l'illuminazione calda. Se l'obiettivo è una trasformazione stilistica, specifica il trattamento desiderato: il produttore mostra esempi in stile fotografico, anime, pittura a olio, acquerello, pop art e schizzo a matita. Indica quali elementi devono mantenere il loro aspetto e quali possono cambiare con il trattamento. Il flusso di modifica del produttore accetta un riferimento all'immagine di partenza, dati immagine codificati oppure un identificatore di file. Per i riferimenti archiviati, usa immagini PNG, JPEG o WebP caricate completamente. La guida documenta anche modifiche successive: usa il risultato di una modifica come input per quella seguente. In questo modo una composizione di base può diventare un risultato più specifico, per esempio cambiando prima l'arredamento e poi regolando l'illuminazione. Associa a ciascun brief l'originale e l'immagine intermedia scelta, così da poter verificare un perfezionamento successivo rispetto alla composizione desiderata. #### Combinare più riferimenti La guida attuale all'uso di più immagini consente fino a cinque immagini di partenza in una singola modifica. Richiamale nell'ordine in cui sono state fornite e assegna a ciascuna un ruolo chiaro, per esempio il soggetto della prima immagine e l'ambiente della seconda. Per impostazione predefinita, il rapporto d'aspetto dell'output segue quello della prima immagine in ingresso, ma è possibile sostituirlo con un rapporto esplicito. Per il concept di un prodotto inserito in una stanza, descrivi la posizione del prodotto, le sue dimensioni e il contatto con le superfici della stanza, poi chiedi di conservare i dettagli che lo identificano. Valuta come sono stati combinati i materiali di partenza, senza presumere che ogni elemento sia stato copiato senza alterazioni. #### Ricevere e conservare l'immagine Per impostazione predefinita il produttore restituisce un indirizzo temporaneo dell'immagine e documenta anche l'output con immagine codificata. Salva tempestivamente l'immagine effettiva quando ti serve come risorsa. Il flusso differito facoltativo separa la conferma di ricezione della richiesta dal completamento: a un identificatore della richiesta seguono gli stati pending, done o failed; i risultati differiti usano il formato di risposta con indirizzo, con un periodo di conservazione documentato di 24 ore. Una richiesta inviata o uno stato pending non corrispondono a un'immagine completata. Conserva l'immagine completata insieme al brief e alle impostazioni scelte, per poterla riutilizzare in seguito. Un risultato finale utile è un'immagine adatta a una scena, un'impaginazione o un brief di modifica ben definiti. Esamina l'intera composizione e i dettagli più piccoli, soprattutto il soggetto di partenza, i contorni degli oggetti, le proporzioni e qualsiasi testo portatore di significato. Nel lavoro iterativo, cambia l'istruzione relativa al problema visibile e usa il risultato selezionato come riferimento successivo. Formula in modo concreto la modifica desiderata e le istruzioni su ciò che va preservato, così da poter valutare ogni risultato rispetto a uno scopo creativo preciso. **Ailoot Ultra · Immagini** `POST /v1/images/generations` `x-ai/grok-imagine-image-2.0` [`x-ai/grok-imagine-image-2.0`](https://ailoot.ai/models/it/#m=x-ai%2Fgrok-imagine-image-2.0&route=Ultra&caller=x-ai%2Fgrok-imagine-image-2.0&fmt=images) xAI /`x-ai/grok-imagine-image-2.0` ### Introduzione Grok Imagine Image 2.0 crea immagini a partire da brief scritti e modifica immagini esistenti tramite istruzioni in linguaggio naturale. xAI documenta qualità, risoluzione e composizione configurabili, riferimenti a più immagini, trasferimento di stile e perfezionamento iterativo. Input accettati Testo · Immagini Risultati Immagini ### Disponibile in Ailoot · input e metodi **Ailoot Ultra · Immagini** `POST /v1/images/generations` Tipi di input `text`, `image` Tipi di output `image` | Campo | Tipo | Requisito | Valori e limiti | Predefinito | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObbligatorio | Valori e limiti x-ai/grok-imagine-image-2.0 | Predefinito— | | Campo`prompt` | Tipo`string` | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 | Predefinito— | | Campo`resolution` | Tipo`string` | RequisitoFacoltativo | Valori e limiti 1K, 2K | Predefinito— | | Campo`aspect_ratio` | Tipo`string` | RequisitoFacoltativo | Valori e limiti 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 | Predefinito— | | Campo`quality` | Tipo`string` | RequisitoFacoltativo | Valori e limiti low, medium | Predefinito— | | Campo`n` | Tipo`integer` | RequisitoFacoltativo | Valori e limiti Minimo: 1 Massimo: 1 | Predefinito— | | Campo`input_references` | Tipo`array` | RequisitoFacoltativo | Valori e limiti Numero minimo di elementi: 0 Numero massimo di elementi: 3 | Predefinito— | | Campo`provider` | Tipo`object` | RequisitoFacoltativo | Valori e limiti | Predefinito— | Parametri e ciclo di vita del metodo | Parametro | Contratto | | --- | --- | | Parametro`content_type` | Contrattoapplication/json | | Parametro`required` | Contrattomodel, prompt | | Parametro`material_types` | Contrattotext, image | Ciclo di vita: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · task\_id effettivamente restituito o record della libreria multimediale `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Tariffe ##### Calcolo del costo finale Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile. Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato. Modalità rapida Non specificato Quando è selezionata la modalità rapida Modalità flex Non specificato Quando è selezionata la modalità flex Sforzo massimo di ragionamento Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default) #### Tariffe stimate per il confronto #### Prezzi per configurazione Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative. | Configurazione | Listino delle tariffe | Quantità prevista | Unità di fatturazione | Costo | | --- | --- | --- | --- | --- | | ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Unità di fatturazione— | Costo Input · Token in input · Stima solo a fini di confronto **—** / 1K token Output · Token in output · Stima solo a fini di confronto **—** / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto **—** / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto **—** / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto **—** / 1K token | | Configurazioneimmagine in ingresso | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper immagine in input | Costo Input · immagine in ingresso · Stima solo a fini di confronto **$0.02** per immagine in input | | ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Unità di fatturazione— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto **$0.08** stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. | Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. [Come funzionano la prenotazione e l’addebito finale →](https://ailoot.ai/docs/it/billing/reserve/) ### Esempi di richieste #### Ailoot Ultra · Immagini curl ```bash 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-2.0', '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"