Съотношения на страните, резолюции и изходни формати
На тази страница
Обновено на 2 ноември 2026 г. — Imagine.
grok-imagine-image-qualityе премахнат от 2 ноември 2026 г. (заявките му се обслужват от Imagine 2.0 в качествоlow): примерите сега използватgrok-imagine-image(Imagine 1.0) иgrok-imagine-image-2.0(Imagine 2.0, качествоlow,mediumилиauto). Когато работите с OpenAI SDK, параметритеaspect_ratio,resolutionиqualityсе предават чрезextra_body, а редактирането става през xAI SDK или чрез HTTP заявка.
Овладяване на размерите на Вашите изображения
Съотношението на страните и резолюцията, които избирате, директно определят външния вид и приложението на генерираните от Вас изображения. Grok Imagine API предлага значителна гъвкавост с множество предварително дефинирани съотношения и два нива на резолюция.
Налични съотношения на страните
Изберете съотношението въз основа на крайната дестинация на изображението и го определете преди генерирането. Изрязването на квадратно изображение в панорамен банер впоследствие нарушава композицията, изградена от модела за квадрат: обектът се оказва изместен от центъра, полетата изчезват. Генерирането директно в правилния формат струва същото и Ви осигурява изображение, проектирано специално за неговите пропорции.
| Съотношение | Ориентация | Типично използване |
|---|---|---|
| 1:1 | Квадрат | Профили, икони, Instagram |
| 16:9 | Широкоформатен пейзаж | Презентации, банери, видео |
| 9:16 | Вертикален портрет | Stories, Reels, TikTok |
| 4:3 | Класически пейзаж | Традиционни снимки, документи |
| 3:4 | Портрет | Постери, книжни корици |
| 3:2 / 2:3 | Стандартна снимка | Фото разпечатки, пощенски картички |
| 2:1 / 1:2 | Ултра широко / ултра вертикално | Уеб банери, панорами |
| auto | Автоматично | Моделът избира оптималното съотношение |
Допълнителни съотношения са налични и за специфични случаи, като екрани на смартфони: 9:19.5, 19.5:9, 9:20 и 20:9.
Резолюции: 1k срещу 2k
При избора между 1k и 2k, въпросът не е „кое е най-доброто“, а „къде ще бъде разгледано това изображение“. На екран разликата е невидима за огромното мнозинство от уеб приложенията, а 2k само увеличава времето за генериране. Това обаче става критично за печат, където броят пиксели на сантиметър директно определя възприеманата острота.
1k: Стандартна резолюция, подходяща за повечето уеб нужди. По-бързо време за генериране.2k: Висока резолюция, идеална за печат или визуализации, изискващи много детайли.
# Стандартна резолюция за уеб
response_web = client.images.generate(
model="grok-imagine-image",
prompt="Neon-style mobile app icon",
extra_body={"resolution": "1k", "aspect_ratio": "1:1"},
)
# Висока резолюция за печат
response_print = client.images.generate(
model="grok-imagine-image-2.0",
prompt="Art deco concert poster with elegant typography",
extra_body={"resolution": "2k", "aspect_ratio": "3:4"},
)
Изходни формати
Параметърът response_format определя как изображението ще бъде върнато към Вас:
Временен URL (по подразбиране)
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronaut cat",
response_format="url"
)
# response.data[0].url → Временен URL, изтеглете бързо
Base64 JSON
import base64
response = client.images.generate(
model="grok-imagine-image",
prompt="Astronaut cat",
response_format="b64_json"
)
image_bytes = base64.b64decode(response.data[0].b64_json)
with open("astronaut_cat.png", "wb") as f:
f.write(image_bytes)
Важната дума е временен: върнатият URL изтича. Приложение, което го съхранява в база данни и го показва седмици по-късно, ще срещне счупени изображения, често дълго след внедряването. Работят два варианта: изтеглете изображението от URL адреса незабавно или поискайте директно Base64 – и в двата случая изображението трябва да завърши на Вашето собствено хранилище.
Избор на правилната комбинация
За всеки случай на употреба ето препоръчителните комбинации:
- Пост за Instagram:
1:1, резолюция1k, Imagine 1.0 - Story/Reel:
9:16, резолюция1k, Imagine 1.0 - Уеб банер:
16:9или2:1, резолюция1k, Imagine 1.0 - Постер за събитие:
3:4, резолюция2k, Imagine 2.0 в качествоmedium - Илюстрация за статия:
16:9, резолюция2k, Imagine 2.0 в качествоmedium
Ключови изводи
- Над 10 налични съотношения на страните, плюс режим
auto - Две резолюции:
1k(бърза, за уеб) и2k(детайлна, за печат) - Два изходни формата:
url(временен) иb64_json(постоянен) - Върнатите MIME типове могат да бъдат PNG, JPEG или WebP
- Адаптирайте съотношението към канала за разпространение на Вашето изображение