Точка на достъп /v1/images/generations: Първи стъпки
На тази страница
Урокът е завършен на 3 ноември 2026 г. въз основа на страницата Image Generation и справочника на xAI Images API: стойности по подразбиране (
aspect_ratioзададен наauto,resolutionна1k), параметърътqualityза Imagine 2.0 и JPEG като формат по подразбиране. Източници: Image Generation · Images API.
Генерирайте първото си изображение с Grok API
API на xAI предлага специализирана точка на достъп за генериране на изображения: POST /v1/images/generations. Тази точка Ви позволява да създавате изображения от текстово описание, използвайки моделите Grok Imagine. Независимо дали искате да произведете илюстрации, маркетингови визуализации или креативни прототипи, всичко започва с тази точка на достъп.
В този урок ще научите как да структурирате заявка за генериране на изображение и да разберете основните параметри.
Структура на заявката за генериране
Два параметъра са достатъчни за генериране на изображение: моделът и подканата (prompt). Всички останали имат стойности по подразбиране, което Ви позволява да получите първи резултат с три реда код – и точно това трябва да направите, преди да прочетете останалото, за да имате изображение пред себе си, към което да свържете всеки параметър.
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="A Breton lighthouse under a starry sky, watercolor style"
)
image_url = response.data[0].url
print(image_url)
API на xAI е съвместим със SDK на OpenAI за генериране на изображения: насочвате base_url към https://api.x.ai/v1, предоставяте Вашия ключ на xAI и останалата част от кода Ви остава непроменена. Имайте предвид обхвата на тази съвместимост – тя важи за генерирането, но не и за редактирането, което изисква различен формат. Урок 5 разглежда това.
Параметри на заявката
Ето параметрите, които можете да включите във Вашата заявка:
model: моделът за генериране, който да използвате (grok-imagine-imageилиgrok-imagine-image-2.0, вижте урок 2)prompt: текстовото описание на желаното изображениеn: броят изображения за генериране (от 1 до 10, по подразбиране: 1)aspect_ratio: съотношението на страните на изображението (autoпо подразбиране: моделът избира въз основа на подканата)resolution: резолюцията (1kпо подразбиране или2k)quality:low,mediumилиauto(по подразбиране) за Imagine 2.0, вижте урок 12response_format:url(по подразбиране) илиb64_jsonза получаване на изображението в Base64
Пример с всички параметри
response = client.images.generate(
model="grok-imagine-image",
prompt="An enchanted forest with fireflies, digital art style",
n=2,
response_format="url",
extra_body={"aspect_ratio": "16:9", "resolution": "2k"},
)
for image in response.data:
print(image.url)
Формат на отговора
Отговорът винаги е масив, дори за едно изображение – итерирайте през него, вместо да четете директно data[0], в противен случай кодът Ви ще се счупи в деня, в който зададете n=4. Всеки обект съдържа:
url: временният URL адрес на изображението (акоresponse_formatеurl)b64_json: Base64 данните на изображението (акоresponse_formatеb64_json)
Върнатият MIME тип може да бъде image/png, image/jpeg или image/webp; по подразбиране е image/jpeg, освен ако настройка за качество не доведе до PNG.
Практическо упражнение
Опитайте да генерирате първото си изображение, като адаптирате подканата към Вашия професионален контекст. Например, за визуализация на презентация:
response = client.images.generate(
model="grok-imagine-image",
prompt="Minimalist chart showing startup growth, "
"blue and white colors, dark background, flat design style",
extra_body={"resolution": "2k", "aspect_ratio": "16:9"},
)
Ключови изводи
- Точката на достъп за генериране е
POST /v1/images/generations - Два параметъра са достатъчни за начало:
modelиprompt - API е съвместим с Python SDK на OpenAI чрез промяна на
base_url - Можете да генерирате до 10 изображения на заявка
- Наличните резолюции са
1k(по подразбиране) и2k