Przejdź do głównej treści
Polski— Wybierz język
Menu

Punkt końcowy /v1/images/generations: Pierwsze kroki

Lekcja 1 z 14 Zaktualizowano 3 listopada 2026 Początkujący
Na tej stronie
  1. Wygeneruj swój pierwszy obraz za pomocą API Grok
  2. Struktura żądania generowania
  3. Parametry żądania
  4. Format odpowiedzi
  5. Ćwiczenia praktyczne
  6. Kluczowe wnioski

Lekcja ukończona 3 listopada 2026 r. na podstawie strony Image Generation oraz dokumentacji referencyjnej xAI Images API: wartości domyślne (aspect_ratio ustawione na auto, resolution na 1k), parametr quality dla 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

Obraz wygenerowany przez 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.

1
Punkt końcowy generowania
2
Dostępne modele
10
Maksymalna liczba obrazów na żądanie
2k
Maksymalna rozdzielczość

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-image lub grok-imagine-image-2.0, zob. lekcja 2)
  • prompt: tekstowy opis pożądanego obrazu
  • n: liczba obrazów do wygenerowania (od 1 do 10, domyślnie: 1)
  • aspect_ratio: proporcje obrazu (domyślnie auto: model dobiera je na podstawie promptu)
  • resolution: rozdzielczość (domyślnie 1k lub 2k)
  • quality: low, medium lub auto (domyślnie) w modelu Imagine 2.0, zob. lekcja 12
  • response_format: url (domyślnie) lub b64_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 (gdy response_format to url)
  • b64_json: dane obrazu w formacie Base64 (gdy response_format to b64_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: model i prompt
  • 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) i 2k