Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Endpoint /v1/images/generations: Tibda

Lezzjoni 1 / 14 Aġġornat 3 ta’ Novembru 2026 Bidbieni
F'din il-paġna
  1. Iġġenera l-Ewwel Immaġni Tiegħek bl-API ta’ Grok
  2. Struttura ta’ Talba ta’ Ġenerazzjoni
  3. Parametri tat-Talba
  4. Format tar-Rispons
  5. Prattika Manwali
  6. Punti Ewlenin

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_ratio stabbilit għal auto, resolution għal 1k), il-parametru quality għ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

Immaġni ġġenerata minn 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.

1
Endpoint tal-Ġenerazzjoni
2
Mudelli Disponibbli
10
Massimu ta' Immaġni għal Kull Talba
2k
Riżoluzzjoni Massima

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-image jew grok-imagine-image-2.0, ara l-lezzjoni 2)
  • prompt: id-deskrizzjoni tat-test tal-immaġni mixtieqa
  • n: 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 (auto b’mod predefinit: il-mudell jagħżel ibbażat fuq il-prompt)
  • resolution: ir-riżoluzzjoni (1k b’mod predefinit, jew 2k)
  • quality: low, medium, jew auto (predefinit) fuq Imagine 2.0, ara l-lezzjoni 12
  • response_format: url (predefinit) jew b64_json biex 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 (jekk response_format huwa url)
  • b64_json: id-dejta Base64 tal-immaġni (jekk response_format huwa b64_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: model u prompt
  • 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) u 2k