Endpoint /v1/images/generations: Tibda
F'din il-paġna
Lezzjoni kkompletata fit-3 ta’ Novembru 2026 ibbażata fuq il-paġna Image Generation u r-referenza tal-API tal-Immaġni ta’ xAI: valuri predefiniti (
aspect_ratiostabbilit għalauto,resolutiongħal1k), il-parametruqualitygħal Imagine 2.0, u JPEG bħala l-format predefinit. Sorsi: Image Generation · Images API.
Iġġenera l-Ewwel Immaġni Tiegħek bl-API ta’ Grok
L-API ta’ xAI toffri endpoint iddedikat għall-ġenerazzjoni tal-immaġni: POST /v1/images/generations. Dan l-endpoint jippermettilek toħloq immaġni minn deskrizzjoni tat-test bl-użu tal-mudelli Grok Imagine. Kemm jekk trid tipproduċi illustrazzjonijiet, viżwali għall-marketing, jew prototipi kreattivi, kollox jibda b’dan l-endpoint.
F’din il-lezzjoni, se titgħallem kif tistruttura talba ta’ ġenerazzjoni ta’ immaġni u tifhem il-parametri fundamentali.
Struttura ta’ Talba ta’ Ġenerazzjoni
Żewġ parametri biżżejjed biex tiġġenera immaġni: il-mudell u l-prompt. Il-bqija kollha għandhom valuri predefiniti, li jippermettilek tikseb l-ewwel riżultat f’tliet linji—u dan huwa eżattament dak li għandek tagħmel qabel ma taqra l-bqija, sabiex ikollok immaġni quddiemek li magħha tista’ tqabbel kull parametru.
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)
L-API ta’ xAI hija kompatibbli mal-SDK ta’ OpenAI għall-ġenerazzjoni tal-immaġni: tindirizza l-base_url lejn https://api.x.ai/v1, tipprovdi ċ-ċavetta xAI tiegħek, u l-bqija tal-kodiċi tiegħek tibqa’ mingħajr bidla. Żomm f’moħħok l-ambitu ta’ din il-kompatibbiltà—tapplika għall-ġenerazzjoni, iżda mhux għall-editjar, li jistenna format differenti. Il-Lezzjoni 5 tkopri dan.
Parametri tat-Talba
Hawn huma l-parametri li tista’ tinkludi fit-talba tiegħek:
model: il-mudell tal-ġenerazzjoni li għandu jintuża (grok-imagine-imagejewgrok-imagine-image-2.0, ara l-lezzjoni 2)prompt: id-deskrizzjoni tat-test tal-immaġni mixtieqan: in-numru ta’ immaġni li għandhom jiġu ġġenerati (minn 1 sa 10, predefinit: 1)aspect_ratio: il-proporzjon tal-aspett tal-immaġni (autob’mod predefinit: il-mudell jagħżel ibbażat fuq il-prompt)resolution: ir-riżoluzzjoni (1kb’mod predefinit, jew2k)quality:low,medium, jewauto(predefinit) fuq Imagine 2.0, ara l-lezzjoni 12response_format:url(predefinit) jewb64_jsonbiex tirċievi l-immaġni f’Base64
Eżempju bil-Parametri Kollha
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)
Format tar-Rispons
Ir-rispons huwa dejjem array, anke għal immaġni waħda—iterah minflok ma taqra data[0], inkella l-kodiċi tiegħek se jkisser il-jum li tissettja n=4. Kull oġġett fih:
url: l-URL temporanju tal-immaġni (jekkresponse_formathuwaurl)b64_json: id-dejta Base64 tal-immaġni (jekkresponse_formathuwab64_json)
It-tip MIME rritornat jista’ jkun image/png, image/jpeg, jew image/webp; huwa predefinit għal image/jpeg, ħlief jekk setting tal-kwalità jipproduċi PNG.
Prattika Manwali
Ipprova tiġġenera l-ewwel immaġni tiegħek billi tadatta l-prompt għall-kuntest professjonali tiegħek. Pereżempju, għal viżwali ta’ preżentazzjoni:
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"},
)
Punti Ewlenin
- L-endpoint tal-ġenerazzjoni huwa
POST /v1/images/generations - Żewġ parametri biżżejjed biex tibda:
modeluprompt - L-API hija kompatibbli mal-Python SDK ta’ OpenAI billi tbiddel il-
base_url - Tista’ tiġġenera sa 10 immaġni għal kull talba
- Ir-riżoluzzjonijiet disponibbli huma
1k(predefinit) u2k