Премини към основното съдържание
Български— Изберете език
Меню

Точка на достъп /v1/images/generations: Първи стъпки

Урок 1 от 14 Обновен 3 ноември 2026 г. Начинаещ
На тази страница
  1. Генерирайте първото си изображение с Grok API
  2. Структура на заявката за генериране
  3. Параметри на заявката
  4. Формат на отговора
  5. Практическо упражнение
  6. Ключови изводи

Урокът е завършен на 3 ноември 2026 г. въз основа на страницата Image Generation и справочника на xAI Images API: стойности по подразбиране (aspect_ratio зададен на auto, resolution на 1k), параметърът quality за Imagine 2.0 и JPEG като формат по подразбиране. Източници: Image Generation · Images API.

Генерирайте първото си изображение с Grok API

Изображение, генерирано от Grok API на xAI предлага специализирана точка на достъп за генериране на изображения: POST /v1/images/generations. Тази точка Ви позволява да създавате изображения от текстово описание, използвайки моделите Grok Imagine. Независимо дали искате да произведете илюстрации, маркетингови визуализации или креативни прототипи, всичко започва с тази точка на достъп.

В този урок ще научите как да структурирате заявка за генериране на изображение и да разберете основните параметри.

1
Точка на достъп за генериране
2
Налични модели
10
Максимален брой изображения на заявка
2k
Максимална резолюция

Структура на заявката за генериране

Два параметъра са достатъчни за генериране на изображение: моделът и подканата (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, вижте урок 12
  • response_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