xAI: Grok Imagine Image 2.0

Grok Imagine Image 2.0 жазбаша тапсырмадан кескін жасайды және бар кескіндерді табиғи тілдегі нұсқаулармен өңдейді. xAI реттелетін сапаны, ажыратымдылық пен композицияны, бірнеше кескін үлгісін, стиль тасымалдауды және итерациялық жетілдіруді құжаттайды.

Ailoot Ultra · Суреттер POST /v1/images/generations x-ai/grok-imagine-image-2.0

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

Grok Imagine Image 2.0 — xAI компаниясының кескін генерациялау және өңдеу моделі. Ол жазбаша сипаттаманы немесе бастапқы кескіндері бар сипаттаманы қабылдап, кескін нәтижесін қайтарады. Өндірушінің атаулы 2.0 профилі көрініс жасауды, бар кескінді өзгертуді, үлгілердегі нысандарды біріктіруді және визуалдық стильді түрлендіруді қамтиды. Алдымен жаңа композиция керек пе, әлде қолда бар материалға нақты өзгеріс қажет пе, соны таңдаңыз.

Тапсырма сипаттамасынан кескін жасау

Негізгі нысанды, оның ортасын, композициясын, жарығы мен визуалдық өңдеуін сипаттаңыз. Көрермен алдымен нені байқауы керек екенін және кескіннің қайда қолданылатынын анықтаңыз. Тауар тұжырымдамасы үшін мысал тапсырма ашық түсті тас үстелдегі керамикалық үстел шамын, терезеден түскен жұмсақ жарықты, материалдың жақын көрінісін және бөлек тақырыпқа арналған бос орынды сипаттай алады. Иллюстрация үшін бір стиль сөзі бүкіл көріністі анықтайды деп күтпей, кейіпкерлерді, әрекет пен қажетті эстетиканы көрсетіңіз.

Өндіруші генерация сұрауынан бірден онға дейін шығыс кескінін құжаттайды, әдепкі саны — бір. Бір тапсырманың бірнеше нәтижесі қарауға баламалар береді; олар әр нұсқада бірдей нысан болуына кепілдік бермейді. Нысанды, композиция мен маңызды бөлшектерді тексеріп, тапсырмаға ең сай нұсқаны сақтаңыз. Кейінгі өңдеулер жоспарланған композицияны қолдануы үшін тапсырма мен таңдалған нұсқаны бірге сақтаңыз.

Композиция, ажыратымдылық және сапа

Генерация нұсқаулығы арақатынасты автоматты таңдауды немесе нақты арақатынасты құжаттайды. Тізімдегі таңдаулар: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, 21:9 және 5:2. Пішінді жоспарланған орналасуға сай таңдаңыз: ықшам тақтаға шаршы, тік композицияға портреттік немесе кең көрініске көлденең. Тек арақатынасқа сүйенбей, қиылуға сезімтал нысанды және макетке қажет кеңістікті көрсетіңіз.

Құжатталған генерация ажыратымдылығы параметрлері — 1k және 2k, әдепкісі 1k. Сапа — low, medium және auto таңдаулары бар бөлек басқару. xAI компаниясының қазіргі нұсқаулығында auto әдепкі болып, генерация үшін low, өңдеу үшін medium қолданады; тікелей low немесе medium беру сол таңдауды бекітеді. Сондықтан ажыратымдылық пен сапа әртүрлі басқаруларды сипаттайды. Екі параметрдің бірін нақты жазуға, геометрияға немесе нысанның сақталуына кепілдік деп санамай, маңызды визуалдық бөлшектерді атап, қайтарылған кескіннен тексеріңіз.

Өңдеу және визуалдық стильді тасымалдау

Өзгертілетін кескінді беріп, сұралған өзгерісті оның көрінетін мазмұнына қатысты сипаттаңыз. Нысаналы өңдеу жиһаз орналасуын, камера нүктесі мен жылы жарықты сақтай отырып, қара қабырғаны ашық сылақ бетке алмастыруды сұрауы мүмкін. Мақсат стильдік түрлендіру болса, қажетті өңдеуді көрсетіңіз: өндіруші фотография, аниме, майлы бояу, акварель, поп-арт және қарындаш нобайы стильдерін көрсетеді. Қай элементтер сыртқы көрінісін сақтауы, қайсысы өңдеумен бірге өзгеруі мүмкін екенін анықтаңыз.

Өндірушінің өңдеу үдерісі бастапқы кескінге сілтемені, кодталған кескін деректерін немесе файл идентификаторын қабылдайды. Сақталған үлгілер үшін толық жүктелген PNG, JPEG немесе WebP кескіндерін пайдаланыңыз. Нұсқаулық кезекті өңдеулерді де құжаттайды: бір өңдеудің нәтижесін келесісіне кіріс етіңіз. Бұл жиһазды өзгертіп, кейін жарықты реттеу арқылы негізгі композицияны нақтырақ нәтижеге айналдыра алады. Кейінгі жетілдіруді жоспарланған композициямен салыстыру үшін түпнұсқа мен таңдалған аралық кескінді әр тапсырмамен байланысты сақтаңыз.

Бірнеше үлгіні біріктіру

Қазіргі бірнеше кескін нұсқаулығы бір өңдеуде беске дейін бастапқы кескінге рұқсат етеді. Оларды берілген ретімен атап, әрқайсысына анық рөл беріңіз, мысалы бірінші кескіннен нысан, екіншісінен орта алынады. Әдепкіде нәтиже арақатынасы бірінші кіріс кескінін ұстанады, оны нақты арақатынаспен өзгертуге болады. Бөлмедегі тауар тұжырымдамасы үшін тауардың орнын, өлшемін және бөлме беттерімен жанасуын сипаттап, кейін оны танытатын бөлшектерді сақтауды сұраңыз. Әр элемент өзгеріссіз көшірілді деп болжамай, дереккөздердің қалай біріктірілгенін тексеріңіз.

Кескінді алу және сақтау

Өндіруші әдепкіде уақытша кескін мекенжайын қайтарады және кодталған кескін нәтижесін де құжаттайды. Материал ретінде қажет болса, нақты кескінді жедел сақтаңыз. Қосымша кейінге қалдырылған үдеріс сұраудың қабылдануын аяқталуынан бөледі: сұрау идентификаторынан кейін pending, done немесе failed күйі келеді, ал кейінге қалдырылған нәтижелер құжатталған 24 сағаттық сақтау мерзімімен мекенжайлы жауап пішімін қолданады. Жіберілген сұрау немесе pending күйі дайын кескін емес. Аяқталған кескінді кейін қайта пайдалану үшін тапсырмасы және таңдалған параметрлерімен бірге сақтаңыз.

Пайдалы соңғы материал — анықталған көрініске, макетке немесе өңдеу тапсырмасына сай кескін. Толық композицияны және ұсақ бөлшектерін, әсіресе бастапқы нысанды, зат шекараларын, пропорцияларды және мағына беретін жазуларды тексеріңіз. Итерациялық жұмыста көрінетін мәселеге қатысты нұсқауды өзгертіп, таңдалған нәтижені келесі үлгі ретінде қолданыңыз. Әр нәтиже нақты шығармашылық мақсатпен бағалануы үшін қажетті өзгеріс пен сақтау нұсқауларын нақты ұстаңыз.

Ailoot Ultra · Суреттер POST /v1/images/generations x-ai/grok-imagine-image-2.0

x-ai/grok-imagine-image-2.0

xAI /x-ai/grok-imagine-image-2.0

Бастау

Қабылданатын кіріс деректері: Мәтін · Суреттер
Нәтижелер: Суреттер

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Суреттер POST /v1/images/generations

Кіріс: text, image
Шығыс: image

Өріс	Түрі	Талап	Мәндер мен шектеулер	Әдепкі
Өріс`model`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер x-ai/grok-imagine-image-2.0	Әдепкі—
Өріс`prompt`	Түрі`string`	ТалапМіндетті	Мәндер мен шектеулер Ең аз ұзындық: 1	Әдепкі—
Өріс`resolution`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1K, 2K	Әдепкі—
Өріс`aspect_ratio`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер 1:1, 3:4, 4:3, 9:16, 16:9, 2:3, 3:2, 9:19.5, 19.5:9, 9:20, 20:9, 1:2, 2:1, auto	Әдепкі—
Өріс`quality`	Түрі`string`	ТалапМіндетті емес	Мәндер мен шектеулер low, medium	Әдепкі—
Өріс`n`	Түрі`integer`	ТалапМіндетті емес	Мәндер мен шектеулер Ең азы: 1 Ең көбі: 1	Әдепкі—
Өріс`input_references`	Түрі`array`	ТалапМіндетті емес	Мәндер мен шектеулер Элементтердің ең аз саны: 0 Элементтердің ең көп саны: 3	Әдепкі—
Өріс`provider`	Түрі`object`	ТалапМіндетті емес	Мәндер мен шектеулер	Әдепкі—

Әдіс параметрлері мен өмірлік циклі

Параметр	Параметр талаптары
Параметр`content_type`	Параметр талаптарыapplication/json
Параметр`required`	Параметр талаптарыmodel, prompt
Параметр`material_types`	Параметр талаптарыtext, image

Өмірлік цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Нақты қайтарылған task_id немесе медиатека жазбасы

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифтер

Қорытынды төлем қалай есептеледі

Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.

Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.

Жылдам режим: Көрсетілмеген Жылдам режим таңдалғанда
Икемді режим: Көрсетілмеген flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі: Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

Баптау	Мөлшерлемелер кестесі	Болжамды мөлшер	Есептеу бірлігі	Төлем
БаптауТокендердің базалық тарифтері	Мөлшерлемелер кестесіНегізгі мөлшерлеме	Болжамды мөлшер—	Есептеу бірлігі—	Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
Баптаукіріс суреті	Мөлшерлемелер кестесі—	Болжамды мөлшер—	Есептеу бірлігікіріс суреті үшін	Төлем Кіріс · кіріс кескін · Тек салыстыруға арналған бағалау $0.02 кіріс суреті үшін
БаптауГенерацияның болжамды құны	Мөлшерлемелер кестесі—	Болжамды мөлшербір генерацияға арналған болжам	Есептеу бірлігі—	Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.08 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Суреттер

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'x-ai/grok-imagine-image-2.0', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Нәтижелерді алу және сақтау

Ailoot Ultra · Суреттер

Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Басқа мазмұнды оқу

Өзіңізге тиесілі қолда бар материалдарды оқу

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Барлық дайын нәтижені сақтау

Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.

Толық жауапты және тақырыптарды, алынған әрбір нәтижені, бастапқыда қайтарылған идентификаторларды және пайдалану туралы барлық өрістерді сақтаңыз. Жасау сұрауын қайта жібермей, бастапқы операцияны қалпына келтіріңіз.

Бастапқы жауапты тексеру қажет болса

Есептерді салыстырып тексеру үшін қайтарылған X-Client-Request-ID мәнін сақтаңыз. Тек нақты қайтарылған task_id/asset_id мәндері арқылы немесе өзіңізге тиесілі медиатекадан оқыңыз; операция ID мәнінен тапсырманың URL мекенжайын ешқашан құрастырмаңыз және жасау сұрауын ешқашан қайта жібермеңіз.

Жауап өрістері

Өріс	Түрі
Өріс`created`	Түрі
Өріс`data[].url`	Түрі
Өріс`data[].b64_json`	Түрі
Өріс`usage`	Түрі

Балама атаулар

Модельдердің балама атаулары

Ailoot Ultra x-ai/grok-imagine-image-2.0

Әдіс жолдарының балама атаулары

/v1/images

Шақыруға арналған байланысты ID

x-ai/grok-imagine-image-2.0

FAQ · xAI: Grok Imagine Image 2.0

Қандай кіріс деректері мен нәтижелер қолжетімді?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: text, image → image
Сұрау қандай өрістерді пайдаланады?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: model, prompt, resolution, aspect_ratio, quality, n, input_references, provider
Қандай шектеулер қолданылады?: POST /v1/images/generations · x-ai/grok-imagine-image-2.0: n.minimum: 1; n.maximum: 1

xAI: Grok Imagine Image 2.0