xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 tworzy obrazy na podstawie pisemnych opisów i edytuje istniejące obrazy zgodnie z instrukcjami w języku naturalnym. xAI dokumentuje ustawienia jakości, rozdzielczości i kompozycji, korzystanie z wielu obrazów referencyjnych, przenoszenie stylu i stopniowe dopracowywanie wyników.

Ailoot Ultra · Obrazy POST /v1/images/generations x-ai/grok-imagine-image-2.0

O modelu

Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.

Grok Imagine Image 2.0 to model xAI do generowania i edycji obrazów. Przyjmuje pisemny opis albo opis wraz z obrazami źródłowymi i zwraca wynik w postaci obrazu. Profil producenta oznaczony jako 2.0 obejmuje tworzenie sceny, zmienianie istniejącego obrazu, łączenie obiektów z materiałów referencyjnych i przekształcanie stylu wizualnego. Zacznij od określenia, czy potrzebujesz nowej kompozycji, czy konkretnej zmiany w materiale, który już masz.

Tworzenie obrazu na podstawie opisu

Opisz główny obiekt, jego otoczenie, kompozycję, oświetlenie i sposób przedstawienia. Wskaż, co widz powinien zauważyć jako pierwsze i gdzie obraz będzie używany. W przypadku koncepcji produktowej przykładowy opis może przedstawiać ceramiczną lampkę biurkową na stole z jasnego kamienia, miękkie światło z okna, zbliżenie na materiał i wolną przestrzeń na osobny nagłówek. W przypadku ilustracji określ postacie, akcję i zamierzoną estetykę, zamiast oczekiwać, że jedno słowo opisujące styl zdefiniuje całą scenę.

Producent dokumentuje możliwość otrzymania od jednego do dziesięciu obrazów z jednego żądania generowania; wartością domyślną jest jeden. Kilka wyników dla tego samego opisu daje warianty do oceny, ale nie gwarantuje identycznego obiektu we wszystkich wersjach. Sprawdź obiekt, kompozycję i ważne szczegóły, a następnie zachowaj wersję najlepiej odpowiadającą opisowi. Przechowuj opis razem z wybranym wariantem, aby późniejsze edycje korzystały z zamierzonej kompozycji.

Kompozycja, rozdzielczość i jakość

Przewodnik generowania dokumentuje automatyczny wybór proporcji lub podanie ich wprost. Wymienione opcje obejmują 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 i 5:2. Dobierz kształt do miejsca użycia: kwadrat do niewielkiego kafelka, pion do kompozycji wertykalnej albo poziom do szerokiej sceny. Określ obiekt, którego nie należy niepożądanie przyciąć, i przestrzeń potrzebną układowi, zamiast polegać wyłącznie na proporcjach.

Udokumentowane ustawienia rozdzielczości generowania to 1k i 2k, z domyślną wartością 1k. Jakość jest osobnym ustawieniem z opcjami low, medium i auto. W aktualnym przewodniku xAI domyślne auto wybiera low przy generowaniu i medium przy edycji; jawne ustawienie low lub medium wymusza wybraną opcję. Rozdzielczość i jakość opisują więc różne parametry. Wskaż ważne szczegóły wizualne i sprawdź je w zwróconym obrazie, zamiast traktować którekolwiek z tych ustawień jako gwarancję dokładnych napisów, geometrii lub zachowania wyglądu obiektu.

Edycja i przenoszenie stylu wizualnego

Dostarcz obraz do zmiany i opisz żądaną modyfikację w odniesieniu do jego widocznej zawartości. Precyzyjna edycja może polegać na zastąpieniu ciemnej ściany powierzchnią z jasnego tynku przy zachowaniu ustawienia mebli, punktu widzenia kamery i ciepłego oświetlenia. Jeśli celem jest przekształcenie stylistyczne, określ oczekiwany sposób przedstawienia: producent pokazuje style fotografii, anime, malarstwa olejnego, akwareli, pop-artu i szkicu ołówkiem. Wskaż, które elementy powinny zachować swój wygląd, a które mogą się zmienić wraz ze stylem.

Proces edycji producenta przyjmuje odwołanie do obrazu źródłowego, zakodowane dane obrazu lub identyfikator pliku. W przypadku przechowywanych materiałów referencyjnych używaj w pełni przesłanych obrazów PNG, JPEG lub WebP. Przewodnik dokumentuje również kolejne edycje: wynik jednej zmiany służy jako wejście do następnej. Pozwala to przekształcić kompozycję bazową w bardziej precyzyjny wynik, na przykład przez zmianę mebli, a następnie korektę oświetlenia. Powiąż oryginał i wybrany obraz pośredni z każdym opisem, aby późniejsze dopracowanie można było porównać z zamierzoną kompozycją.

Łączenie wielu materiałów referencyjnych

Aktualny przewodnik pracy z wieloma obrazami dopuszcza do pięciu obrazów źródłowych w jednej edycji. Odwołuj się do nich w kolejności przesłania i przypisz każdemu jasną rolę, na przykład obiekt z pierwszego obrazu i otoczenie z drugiego. Proporcje wyniku domyślnie odpowiadają pierwszemu obrazowi wejściowemu; można je zastąpić wartością podaną wprost. W koncepcji produktu we wnętrzu opisz jego położenie, rozmiar i kontakt z powierzchniami pomieszczenia, a następnie poproś o zachowanie cech pozwalających go rozpoznać. Sprawdź sposób połączenia źródeł, zamiast zakładać, że każdy element skopiowano bez zmian.

Odbieranie i zachowywanie obrazu

Producent domyślnie zwraca tymczasowy adres obrazu i dokumentuje również wynik jako zakodowane dane obrazu. Niezwłocznie zachowaj właściwy obraz, jeśli ma służyć jako materiał do dalszego użycia. Opcjonalny proces odroczony oddziela potwierdzenie przyjęcia żądania od jego ukończenia: po identyfikatorze żądania następuje status pending, done lub failed, a odroczone wyniki korzystają z formatu odpowiedzi z adresem i udokumentowanego okresu przechowywania wynoszącego 24 godziny. Wysłane żądanie ani status pending nie są gotowym obrazem. Zachowaj ukończony obraz wraz z opisem i wybranymi ustawieniami do późniejszego wykorzystania.

Użytecznym rezultatem końcowym jest obraz odpowiadający określonej scenie, układowi lub opisowi edycji. Sprawdź całą kompozycję i drobne szczegóły, zwłaszcza obiekt źródłowy, granice przedmiotów, proporcje i napisy niosące znaczenie. Przy kolejnych poprawkach zmieniaj instrukcję dotyczącą widocznego problemu i używaj wybranego wyniku jako następnej referencji. Formułuj oczekiwaną zmianę i instrukcje zachowania elementów konkretnie, aby każdy wynik można było ocenić względem określonego celu twórczego.

Ailoot Ultra · Obrazy POST /v1/images/generations x-ai/grok-imagine-image-2.0

x-ai/grok-imagine-image-2.0

xAI /x-ai/grok-imagine-image-2.0

Start

Akceptowane dane wejściowe: Tekst · Obrazy
Wyniki: Obrazy

Dostępne w Ailoot · dane wejściowe i metody

Ailoot Ultra · Obrazy POST /v1/images/generations

Wejście: text, image
Wyjście: image

Pole	Typ	Wymaganie	Wartości i limity	Domyślnie
Pole`model`	Typ`string`	WymaganieWymagane	Wartości i limity x-ai/grok-imagine-image-2.0	Domyślnie—
Pole`prompt`	Typ`string`	WymaganieWymagane	Wartości i limity Minimalna długość: 1	Domyślnie—
Pole`resolution`	Typ`string`	WymaganieOpcjonalne	Wartości i limity 1K, 2K	Domyślnie—
Pole`aspect_ratio`	Typ`string`	WymaganieOpcjonalne	Wartości i limity 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	Domyślnie—
Pole`quality`	Typ`string`	WymaganieOpcjonalne	Wartości i limity low, medium	Domyślnie—
Pole`n`	Typ`integer`	WymaganieOpcjonalne	Wartości i limity Minimum: 1 Maksimum: 1	Domyślnie—
Pole`input_references`	Typ`array`	WymaganieOpcjonalne	Wartości i limity Minimalna liczba elementów: 0 Maksymalna liczba elementów: 3	Domyślnie—
Pole`provider`	Typ`object`	WymaganieOpcjonalne	Wartości i limity	Domyślnie—

Parametry i cykl życia metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt
Parametr`material_types`	Kontrakttext, image

Cykl życia: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Rzeczywiście zwrócony task_id lub wpis w bibliotece multimediów

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Cennik

Jak obliczana jest ostateczna opłata

Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.

Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.

Tryb szybki: Nie określono Gdy wybrany jest tryb szybki
Tryb flex: Nie określono Gdy wybrany jest tryb flex
Maksymalna intensywność rozumowania: Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)

Szacunkowe stawki do porównania

Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

Konfiguracja	Tabela stawek	Przewidywana ilość	Jednostka rozliczeniowa	Opłata
KonfiguracjaBazowe stawki za tokeny	Tabela stawekStawka podstawowa	Przewidywana ilość—	Jednostka rozliczeniowa—	Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania — / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania — / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania — / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania — / 1K tokenów
Konfiguracjaobraz wejściowy	Tabela stawek—	Przewidywana ilość—	Jednostka rozliczeniowaza obraz wejściowy	Opłata Wejście · obraz wejściowy · Szacunek tylko do porównania $0.02 za obraz wejściowy
KonfiguracjaSzacowany koszt generowania	Tabela stawek—	Przewidywana ilośćszacunek dla jednego generowania	Jednostka rozliczeniowa—	Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania $0.08 szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie.

Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. Jak działają rezerwacja i rozliczenie →

Przykładowe żądania

Ailoot Ultra · Obrazy

curl

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"<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

Odbieranie i zapisywanie wyników

Ailoot Ultra · Obrazy

Pobierz każdy zwrócony obraz lub zapisz jego zawartość Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Inne odczyty treści

Odczytaj istniejące zasoby należące do Ciebie

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.

Zachowaj wszystkie ukończone wyniki

Zapisz każdy ukończony obraz; pobierz każdy zwrócony URL lub zdekoduj zawartość Base64.

Zachowaj pełną odpowiedź i nagłówki, wszystkie rzeczywiście uzyskane wyniki, pierwotnie zwrócone identyfikatory oraz wszystkie pola zużycia. Odzyskaj pierwotną operację bez ponownego wysyłania żądania utworzenia.

Jeśli trzeba sprawdzić pierwotną odpowiedź

Zachowaj zwrócony X-Client-Request-ID do uzgodnienia danych. Odczytuj wyłącznie rzeczywiście zwrócone wartości task_id/asset_id lub własną bibliotekę multimediów; nigdy nie buduj adresu URL zadania na podstawie identyfikatora operacji i nigdy nie wysyłaj ponownie żądania utworzenia.

Pola odpowiedzi

Pole	Typ
Pole`created`	Typ
Pole`data[].url`	Typ
Pole`data[].b64_json`	Typ
Pole`usage`	Typ

Aliasy

Aliasy modelu

Ailoot Ultra x-ai/grok-imagine-image-2.0

Aliasy ścieżek metod

/v1/images

Powiązane ID modeli

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

Jakie dane wejściowe i wyniki są dostępne?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
Jakich pól używa żądanie?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
Jakie limity obowiązują?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0