Punkt końcowy /v1/images/generations: Pierwsze kroki
Na tej stronie
Lekcja ukończona 3 listopada 2026 r. na podstawie strony Image Generation oraz dokumentacji referencyjnej xAI Images API: wartości domyślne (
aspect_ratioustawione naauto,resolutionna1k), parametrqualitydla modelu Imagine 2.0 oraz JPEG jako domyślny format. Źródła: Image Generation · Images API.
Wygeneruj swój pierwszy obraz za pomocą API Grok
API xAI oferuje dedykowany punkt końcowy do generowania obrazów: POST /v1/images/generations. Umożliwia on tworzenie grafik na podstawie opisów tekstowych przy użyciu modeli Grok Imagine. Niezależnie od tego, czy chcesz tworzyć ilustracje, materiały marketingowe, czy kreatywne prototypy – wszystko zaczyna się od tego punktu końcowego.
W tej lekcji dowiesz się, jak poprawnie zbudować żądanie generowania obrazu i zrozumiesz podstawowe parametry.
Struktura żądania generowania
Do wygenerowania obrazu wystarczą dwa parametry: model i prompt (polecenie tekstowe). Wszystkie pozostałe mają wartości domyślne, co pozwala uzyskać pierwszy wynik w zaledwie trzech liniach kodu. Zrób to dokładnie tak, zanim przeczytasz resztę – dzięki temu będziesz mieć przed oczami gotowy obraz, do którego odniesiesz każdy kolejny parametr.
from openai import OpenAI
import os
client = OpenAI(
api_key=os.getenv("XAI_API_KEY"),
base_url="https://api.x.ai/v1"
)
response = client.images.generate(
model="grok-imagine-image",
prompt="Bretońska latarnia morska pod rozgwieżdżonym niebem, styl akwarelowy"
)
image_url = response.data[0].url
print(image_url)
API xAI jest kompatybilne z SDK OpenAI w zakresie generowania obrazów: wystarczy wskazać base_url jako https://api.x.ai/v1, podać swój klucz xAI, a reszta kodu pozostaje bez zmian. Pamiętaj jednak o zakresie tej kompatybilności – dotyczy ona tylko generowania, nie edycji, która wymaga innego formatu. Temat ten omówimy w lekcji 5.
Parametry żądania
Oto parametry, które możesz uwzględnić w swoim żądaniu:
model: model generujący do użycia (grok-imagine-imagelubgrok-imagine-image-2.0, zob. lekcja 2)prompt: tekstowy opis pożądanego obrazun: liczba obrazów do wygenerowania (od 1 do 10, domyślnie: 1)aspect_ratio: proporcje obrazu (domyślnieauto: model dobiera je na podstawie promptu)resolution: rozdzielczość (domyślnie1klub2k)quality:low,mediumlubauto(domyślnie) w modelu Imagine 2.0, zob. lekcja 12response_format:url(domyślnie) lubb64_json, aby otrzymać obraz w formacie Base64
Przykład ze wszystkimi parametrami
response = client.images.generate(
model="grok-imagine-image",
prompt="Zaczarowany las ze świetlikami, styl sztuki cyfrowej",
n=2,
response_format="url",
extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)
for image in response.data:
print(image.url)
Format odpowiedzi
Odpowiedź zawsze przybiera formę tablicy, nawet jeśli generujesz tylko jeden obraz. Iteruj po niej, zamiast odczytywać bezpośrednio data[0] – w przeciwnym razie Twój kod przestanie działać w dniu, w którym ustawisz n=4. Każdy obiekt zawiera:
url: tymczasowy adres URL obrazu (gdyresponse_formattourl)b64_json: dane obrazu w formacie Base64 (gdyresponse_formattob64_json)
Zwracany typ MIME może to być image/png, image/jpeg lub image/webp. Domyślnie jest to image/jpeg, chyba że ustawienie jakości wymusi format PNG.
Ćwiczenia praktyczne
Spróbuj wygenerować swój pierwszy obraz, dostosowując prompt do swojego kontekstu zawodowego. Na przykład, aby stworzyć grafikę do prezentacji:
response = client.images.generate(
model="grok-imagine-image",
prompt="Minimalistyczny wykres pokazujący wzrost startupu, "
"kolory niebieski i biały, ciemne tło, styl płaskiego designu",
extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)
Kluczowe wnioski
- Punkt końcowy generowania to
POST /v1/images/generations - Do rozpoczęcia pracy wystarczą dwa parametry:
modeliprompt - API jest kompatybilne z Python SDK OpenAI po zmianie
base_url - Możesz wygenerować do 10 obrazów w jednym żądaniu
- Dostępne rozdzielczości to
1k(domyślnie) i2k