models

Google: Nano Banana (Gemini 2.5 Flash Image)

Markdown · JSON

Google: Nano Banana (Gemini 2.5 Flash Image)

Nano Banana (Gemini 2.5 Flash Image) мәтін мен кескіндерден суреттер жасайды және өңдейді. Қай бөлшектер сақталуы керегін айтып, көрініс құруға, таңдалған элементті өзгертуге, көрнекі референстерді біріктіруге немесе тауар кескінін жетілдіруге оның диалогтік үдерісін қолданыңыз.

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

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

Gemini 2.5 Flash Image (Nano Banana деп те белгілі) — көрнекі материалдар жасауға және диалог арқылы кескін өңдеуге арналған Google компаниясының мәтін-кескін моделі. Ол міндетті емес кескін референстері бар нұсқауды қабылдап, қосымша мәтіні бар кескіндер қайтара алады. Дәл осы 2.5 Flash Image нұсқасы Nano Banana 2, Nano Banana Pro және кейінгі Lite кескін модельдерінен бөлек. Оның пайдалы нәтижесі — жалпы Gemini 2.5 мәтін моделінің жауабы емес, жасалған не түзетілген көрнекі материал.

Дәл модель картасы 65,536 кіріс және 32,768 шығыс токенін көрсетеді. Кескіндер мен нұсқаулар кірістің бөлігі, ал қайтарылған кескін не мәтін нәтиженің бөлігі болады. Нұсқаулықтың ажыратымдылық кестесі қолдайтын кескін ені мен биіктігінің арақатынастары арасында 1:1 шығысты 1024×1024, 3:4 шығысты 864×1184 және 16:9 шығысты 1344×768 деп береді. Көріністі жобаламас бұрын көзделген көрсету пішінін таңдаңыз. Кейінгі Gemini кескін нұсқасының жоғары ажыратымдылық таңдауларын дәл осы модельге құжатталған басқарулар деп қабылдауға болмайды.

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

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

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

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

Модель картасы осы нұсқа үшін ойлауды, іздеу арқылы негіздеуді, функция шақыруды, код орындауды немесе шектелген құрылымдалған шығысты тізімдемейді. Ол аудио генерациясын не Live API-ді де ұсынбайды. Құжатталған кірісі — мәтін мен кескіндер, сондықтан басқа Gemini модельдерінің аудио, бейне және құжат өңдеу мүмкіндіктерін осы профильге телуге болмайды. Қолданба кәдімгі прозалық жауапта дайын кескін материалы бар деп болжамай, қайтарылған мазмұн бөліктерін нақты өңдеуі керек.

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

Практикалық тапсырма

Практикалық тапсырма

Ағылшын тіліндегі техникалық мысал

Change a product photo background

Using the supplied product photograph, preserve the ceramic mug's shape, handle, glaze and existing logo exactly. Replace only the background with a pale stone tabletop and soft morning side light. Keep the camera angle and mug position. Remove unrelated background clutter and add no new lettering, props or decorative marks.

Күтілетін нәтиже

An edited image retaining the reference mug while changing its setting and light as requested.

Нәтижені тексеру

Compare the result with the reference for mug geometry, logo fidelity, camera angle and removal of clutter.
Ailoot Ultra · OpenAI чаты POST /v1/chat/completions google/gemini-2.5-flash-image

google/gemini-2.5-flash-image

Google /google/gemini-2.5-flash-image

Бастау

Nano Banana (Gemini 2.5 Flash Image) мәтін мен кескіндерден суреттер жасайды және өңдейді. Қай бөлшектер сақталуы керегін айтып, көрініс құруға, таңдалған элементті өзгертуге, көрнекі референстерді біріктіруге немесе тауар кескінін жетілдіруге оның диалогтік үдерісін қолданыңыз.

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

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

Ailoot Ultra · OpenAI чаты POST /v1/chat/completions
Кіріс
text
Шығыс
text
Шығыс пішімі
json немесе SSE
ӨрісТүріТалапМәндер мен шектеулерӘдепкі
ӨрісmodelТүріstringТалапМіндеттіМәндер мен шектеулер
google/gemini-2.5-flash-image
Әдепкі—
ӨрісmessagesТүріmessage[]ТалапМіндеттіМәндер мен шектеулер
Элементтердің ең аз саны: 1
Әдепкі—
Өрісmessages[].roleТүріstringТалапМіндеттіМәндер мен шектеулер
Мысалдар: system, user, assistant, tool, function
Шарттар: Бұл рөлдер бастапқы кодтағы үйлесімділік түрлерінде айқын көрсетілген; рөлдердің нақты жиыны әр модельге байланысты.
Модельге байланысты
Әдепкі—
Өрісmessages[].contentТүріstring|content_part[]|nullТалапМіндетті емесМәндер мен шектеулерӘдепкі—
Өрісmessages[].tool_callsТүріtool_call[]ТалапМіндетті емесМәндер мен шектеулерӘдепкі—
Өрісmessages[].tool_call_idТүріstringТалапМіндетті емесМәндер мен шектеулер
Мына жағдайда қолданылады: role=tool; нақты қайтарылған ID мәнін пайдаланыңыз
Әдепкі—
Өрісmessages[].nameТүріstringТалапМіндетті емесМәндер мен шектеулерӘдепкі—
Өрісmessages[].reasoning_contentТүріstringТалапМіндетті емесМәндер мен шектеулер
Мына жағдайда қолданылады: Модель пайымдауды пайдаланса, нақты қайтарылған пайымдауды қайта жіберіңіз
Әдепкі—
Өрісmessages[].reasoning_detailsТүріobject|arrayТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
Өрісmax_tokensТүріintegerТалапМіндетті емесМәндер мен шектеулер
Ең азы: 1
Модельге байланысты
Әдепкі—
Өрісmax_completion_tokensТүріintegerТалапМіндетті емесМәндер мен шектеулер
Ең азы: 1
Модельге байланысты
Әдепкі—
ӨрісstreamТүріbooleanТалапМіндетті емесМәндер мен шектеулерӘдепкіfalse
Өрісstream_options.include_usageТүріbooleanТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
ӨрісtemperatureТүріnumberТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
Өрісtop_pТүріnumberТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
ӨрісstopТүріstring|string[]ТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
ӨрісtoolsТүріfunction_tool[]ТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
Өрісtools[].typeТүріstringТалапМіндетті емесМәндер мен шектеулер
function
Модельге байланысты
Әдепкі—
Өрісtools[].function.nameТүріstringТалапМіндеттіМәндер мен шектеулер
Мына жағдайда қолданылады: функция құралы берілген
Әдепкі—
Өрісtools[].function.descriptionТүріstringТалапМіндетті емесМәндер мен шектеулерӘдепкі—
Өрісtools[].function.parametersТүріJSON_schemaТалапМіндетті емесМәндер мен шектеулерӘдепкі—
Өрісtool_choiceТүріstring|objectТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
Өрісparallel_tool_callsТүріbooleanТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
Өрісresponse_formatТүріobjectТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
Өрісreasoning_effortТүріstringТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
ӨрісreasoningТүріobjectТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
Өрісservice_tierТүріstringТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
ӨрісinstructionsТүріstringТалапМіндетті емесМәндер мен шектеулер
Үйлесімділік өрісі
Әдепкі—
ӨрісfunctionsТүріfunction[]ТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
Өрісfunction_callТүріstring|objectТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
Өрісprompt_cache_optionsТүріobjectТалапМіндетті емесМәндер мен шектеулер
Модельге байланысты
Әдепкі—
ӨрісmodalitiesТүріstring[]ТалапМіндетті емесМәндер мен шектеулер
text
Әдепкі—
ӨрісproviderТүріobjectТалапМіндетті емесМәндер мен шектеулер
Шарттар: Осы Ultra мәтіндік бағытында provider.options қабылданбайды
Әдепкі—
Өрісcache_control.ttlТүріstringТалапМіндетті емесМәндер мен шектеулер
Шарттар: Сұрау кэшінің нақты орындарында 1h қабылданбайды
Әдепкі—
Кіріс материалдарының үйлесімдері

Мәтін · UTF8 мәтіні

messages[].content

Әдіс параметрлері мен өмірлік циклі
ПараметрПараметр талаптары
Параметрcontent_typeПараметр талаптарыapplication/json
ПараметрrequiredПараметр талаптарыmodel, messages
Параметрmaterial_typesПараметр талаптарыtext
ПараметрmessagesПараметр талаптарыrole/content құрылымы бар хабарламалар жиымы
Параметрfile_materialПараметр талаптарынақты UTF-8 құжаты сөзбе-сөз мәтін ретінде енгізіледі; файл ID-і болжанбайды
Параметрoptional_controlsПараметр талаптарыstream, temperature, top_p, stop, max_tokens, max_completion_tokens, reasoning, response_format, tools, tool_choice
Параметрcontrol_scopeПараметр талаптарымодельге байланысты; пайдаланушының функция құралдары қызмет жағында орындалатын құралдардан өзгеше
Параметрoutput_modalitiesПараметр талаптарыtext
Параметрhosted_operationsПараметр талаптарыfalse
Параметрmultimodal_input_bindingПараметр талаптарыnull

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

Модельдің дәл ID мәнін messages деректерімен бірге жіберіңіз.

Контекст ұзындығы шығыстың жоғарғы шегі емес.

Мәтіндік файл сөзбе-сөз мәтінді бере алады; кіріс суреттері, аудио және файл нысандары дәл байланыстыруды қажет етеді.

Тарифтер

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

Жылдам режим
Стандартты тариф Жылдам режим таңдалғанда
Икемді режим
Стандартты тариф flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі
Стандартты тариф Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Айқын кэштеу бағасы
Қосылмаған Айқын кэштеу сұралғанда

Ailoot мөлшерлемелері

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

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

БаптауМөлшерлемелер кестесіКонтекст токендерінің саны мынадан көпКонтекст токендерінің саны мынадан аспайды, шегі кіредіТөлем
БаптауТокендердің базалық тарифтеріМөлшерлемелер кестесіНегізгі мөлшерлемеКонтекст токендерінің саны мынадан көп—Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқТөлем
Кіріс · Кіріс токендері $0.0006 / 1K токен
Шығыс · Шығыс токендері $0.005 / 1K токен
Кіріс · Кэшті оқу $0.00006 / 1K токен
Кіріс · Кэшке жазу $0.0001666666666666666 / 1K токен
Кіріс · Кэшке жазу, 1 сағ — / 1K токен
Шығыс · Шығыс кескін токендері $0.06 / 1K сурет токені
БаптауСұрау ұзындығының 1-деңгейіМөлшерлемелер кестесі—Контекст токендерінің саны мынадан көп0Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқТөлем
Кіріс · Кіріс токендері $0.0006 / 1K токен
Шығыс · Шығыс токендері $0.005 / 1K токен
Кіріс · Кэшті оқу $0.00006 / 1K токен
Кіріс · Кэшке жазу $0.0001666666666666666 / 1K токен
Кіріс · Кэшке жазу, 1 сағ — / 1K токен

Анықтамалық тариф мәліметтері

Модельдің анықтамалық кестелері әдіс таңдауын, баға есебін не төлемді өзгертпейді. Қолданыстағы төлемдер таңдалған Ailoot әдісінің мөлшерлемелерімен есептеледі.

google/gemini-2.5-flash-image

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

БаптауТөлемді есептеу шарттарыТөлем
Баптауgoogle/gemini-2.5-flash-image · Әдепкі конфигурацияТөлемді есептеу шарттарыӘдепкі баптауТөлем
Кіріс · Кіріс 0,0006 $ / 1K токен
Шығыс · Шығыс 0,06 $ / 1K токен
Google: Nano Banana (Gemini 2.5 Flash Image)

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

БаптауТөлемді есептеу шарттарыТөлем
БаптауGoogle: Nano Banana (Gemini 2.5 Flash Image) · Әдепкі конфигурацияТөлемді есептеу шарттарыӘдепкі баптауТөлем
Кіріс · Кіріс токендері 0,0006 $ / 1K токен
Шығыс · Шығыс токендері 0,005 $ / 1K токен
Кіріс · Кіріс кескін 0,0006 $ / 1K токен
Шығыс · Шығыс кескін 0,06 $ / 1K токен
Кіріс · Аудио кірісі 0,002 $ / 1K токен
Кіріс · Аудио кэшінен оқу 0,0002 $ / 1K токен
Шығыс · Веб-іздеу 0,028 $ әр іздеу үшін
Шығыс · Пайымдау токендері 0,005 $ / 1K токен
Кіріс · Кэшті оқу 0,00006 $ / 1K токен
Кіріс · Кэшке жазу · 5 минут ≈0,000167 $ / 1K токен

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

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

Ailoot Ultra · OpenAI чаты

curlPython SDKPython ағыны
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/gemini-2.5-flash-image", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}')

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/chat/completions \
  -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 json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("choices",[]):
    if x.get("message",{}).get("content"): print(x["message"]["content"])
PY_RESULT
from openai import OpenAI
import os

if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.chat.completions.create(model='google/gemini-2.5-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}])
import base64, json
from pathlib import Path

def save_result(data, stem="result"):
    # Keep every field, including usage, IDs, reasoning and tool requests.
    Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
    print(json.dumps(data, ensure_ascii=False, indent=2))
    def save_blob(encoded, suffix, label):
        raw = base64.b64decode(encoded, altchars=b"-_", validate=True)
        ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix
        file = Path(stem + "-" + label + "." + ext)
        file.write_bytes(raw)
        print("Saved", file)
    for index, block in enumerate(data.get("content") or []):
        print("Content", index, json.dumps(block, ensure_ascii=False))
    for choice in data.get("choices") or []:
        print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))
    for index, item in enumerate(data.get("output") or []):
        print("Output", index, json.dumps(item, ensure_ascii=False))
        if item.get("type") == "image_generation_call" and item.get("result"):
            save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))
    for ci, candidate in enumerate(data.get("candidates") or []):
        for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):
            print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))
            blob = part.get("inlineData") or part.get("inline_data")
            if blob and blob.get("data"):
                mime = blob.get("mimeType") or blob.get("mime_type")
                suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")
                save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))

save_result(result.to_dict(mode="json"))
from openai import OpenAI
import os
from pathlib import Path

if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
import base64, json
from pathlib import Path

def save_result(data, stem="result"):
    # Keep every field, including usage, IDs, reasoning and tool requests.
    Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
    print(json.dumps(data, ensure_ascii=False, indent=2))
    def save_blob(encoded, suffix, label):
        raw = base64.b64decode(encoded, altchars=b"-_", validate=True)
        ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix
        file = Path(stem + "-" + label + "." + ext)
        file.write_bytes(raw)
        print("Saved", file)
    for index, block in enumerate(data.get("content") or []):
        print("Content", index, json.dumps(block, ensure_ascii=False))
    for choice in data.get("choices") or []:
        print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False))
    for index, item in enumerate(data.get("output") or []):
        print("Output", index, json.dumps(item, ensure_ascii=False))
        if item.get("type") == "image_generation_call" and item.get("result"):
            save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index))
    for ci, candidate in enumerate(data.get("candidates") or []):
        for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []):
            print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False))
            blob = part.get("inlineData") or part.get("inline_data")
            if blob and blob.get("data"):
                mime = blob.get("mimeType") or blob.get("mime_type")
                suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin")
                save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi))

with client.chat.completions.stream(model='google/gemini-2.5-flash-image',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream:
    with Path("stream-events.jsonl").open("w",encoding="utf-8") as log:
        for event in stream:
            payload=event.to_dict(mode="json")
            log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush()
            print(json.dumps(payload,ensure_ascii=False))
    final=stream.get_final_completion()
    save_result(final.to_dict(mode="json"),"stream-result")

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

Ailoot Ultra · OpenAI чаты

json немесе SSE

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

Қайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз.

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

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

Сұрау мен жауаптың ID мәндерін және тақырыптарын сақтаңыз. Мәтіндік тапсырманы алуға арналған ортақ URL берілмеген.

Жауап өрістері
ӨрісТүрі
Өрісchoices[].indexТүріinteger
Өрісchoices[].message.contentТүріstring|null
Өрісchoices[].message.tool_callsТүріtool_call[]
Өрісchoices[].message.reasoning_contentТүріstring
Өрісchoices[].message.reasoning_detailsТүріobject|array
Өрісchoices[].finish_reasonТүріstring|null
ӨрісusageТүріobject
Қателер және келесі қадамдар
ЖауапШартКелесі қадам
Жауап400 · invalid_request_errorШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қатеКелесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз.

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

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

Ailoot Ultra google/gemini-2.5-flash-image

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

/v1/images

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

google/gemini-2.5-flash-image

Ailoot Ultra · Суреттер POST /v1/images/generations google/gemini-2.5-flash-image

google/gemini-2.5-flash-image

Google /google/gemini-2.5-flash-image

Бастау

Nano Banana (Gemini 2.5 Flash Image) мәтін мен кескіндерден суреттер жасайды және өңдейді. Қай бөлшектер сақталуы керегін айтып, көрініс құруға, таңдалған элементті өзгертуге, көрнекі референстерді біріктіруге немесе тауар кескінін жетілдіруге оның диалогтік үдерісін қолданыңыз.

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

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

Ailoot Ultra · Суреттер POST /v1/images/generations
Кіріс
text, image
Шығыс
image
ӨрісТүріТалапМәндер мен шектеулерӘдепкі
ӨрісmodelТүріstringТалапМіндеттіМәндер мен шектеулер
google/gemini-2.5-flash-image
Әдепкі—
ӨрісpromptТүріstringТалапМіндеттіМәндер мен шектеулер
Ең аз ұзындық: 1
Әдепкі—
Өрісaspect_ratioТүріstringТалапМіндетті емесМәндер мен шектеулер
1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
Әдепкі—
Өріс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.24576 жасауға дейінгі бағалау

Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

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': 'google/gemini-2.5-flash-image', '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 google/gemini-2.5-flash-image

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

/v1/images

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

google/gemini-2.5-flash-image

Ailoot Ultra · Anthropic хабарламалары POST /v1/messages google/gemini-2.5-flash-image

google/gemini-2.5-flash-image

Google /google/gemini-2.5-flash-image

Бастау

Nano Banana (Gemini 2.5 Flash Image) мәтін мен кескіндерден суреттер жасайды және өңдейді. Қай бөлшектер сақталуы керегін айтып, көрініс құруға, таңдалған элементті өзгертуге, көрнекі референстерді біріктіруге немесе тауар кескінін жетілдіруге оның диалогтік үдерісін қолданыңыз.

Қабылданатын кіріс деректері
Мәтін
Нәтижелер
json · sse

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

Ailoot Ultra · Anthropic хабарламалары POST /v1/messages
Кіріс
text
Шығыс
json, sse
Шығыс пішімі
JSON немесе SSE
ӨрісТүріТалапМәндер мен шектеулерӘдепкі
ӨрісmodelТүріstringТалапМіндеттіМәндер мен шектеулер
google/gemini-2.5-flash-image
Әдепкі—
ӨрісmessagesТүріmessage[]ТалапМіндеттіМәндер мен шектеулерӘдепкі—
Өрісmessages[].roleТүріstringТалапМіндеттіМәндер мен шектеулер
user, assistant
Әдепкі—
Өрісmessages[].contentТүріstringТалапМіндеттіМәндер мен шектеулерӘдепкі—
Өрісmax_tokensТүріintegerТалапМіндеттіМәндер мен шектеулерӘдепкі—
ӨрісstreamТүріbooleanТалапМіндетті емесМәндер мен шектеулерӘдепкіfalse
Кіріс материалдарының үйлесімдері

Мәтін · UTF-8 мәтіні

messages[].content жолы

Әдіс параметрлері мен өмірлік циклі
ПараметрПараметр талаптары
Параметрcontent_typeПараметр талаптарыapplication/json
ПараметрrequiredПараметр талаптарыmodel, messages, max_tokens
Параметрoptional_controlsПараметр талаптарыstream
Параметрmaterial_typesПараметр талаптарыtext
Параметрtext_file_materialПараметр талаптарыНақты UTF-8 құжатын оқып, оның мәтінін көрсетілген кіріс жолына немесе хабарлама мазмұнының жолына қойыңыз.

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

Тарифтер

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

Жылдам режим
Стандартты тариф Жылдам режим таңдалғанда
Икемді режим
Стандартты тариф flex режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі
Стандартты тариф Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Айқын кэштеу бағасы
Қосылмаған Айқын кэштеу сұралғанда

Ailoot мөлшерлемелері

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

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

БаптауМөлшерлемелер кестесіКонтекст токендерінің саны мынадан көпКонтекст токендерінің саны мынадан аспайды, шегі кіредіТөлем
БаптауТокендердің базалық тарифтеріМөлшерлемелер кестесіНегізгі мөлшерлемеКонтекст токендерінің саны мынадан көп—Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқТөлем
Кіріс · Кіріс токендері $0.0006 / 1K токен
Шығыс · Шығыс токендері $0.005 / 1K токен
Кіріс · Кэшті оқу $0.00006 / 1K токен
Кіріс · Кэшке жазу $0.0001666666666666666 / 1K токен
Кіріс · Кэшке жазу, 1 сағ — / 1K токен
Шығыс · Шығыс кескін токендері $0.06 / 1K сурет токені
БаптауСұрау ұзындығының 1-деңгейіМөлшерлемелер кестесі—Контекст токендерінің саны мынадан көп0Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқТөлем
Кіріс · Кіріс токендері $0.0006 / 1K токен
Шығыс · Шығыс токендері $0.005 / 1K токен
Кіріс · Кэшті оқу $0.00006 / 1K токен
Кіріс · Кэшке жазу $0.0001666666666666666 / 1K токен
Кіріс · Кэшке жазу, 1 сағ — / 1K токен

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

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

Ailoot Ultra · Anthropic хабарламалары

Ең ықшам толық JSON сұрау денесіcurl · өзіңіздің UTF-8 құжатыңызды қолданыңызPython · нәтижені толық сақтаңыз
{
  "model": "google/gemini-2.5-flash-image",
  "max_tokens": 128,
  "messages": [
    {
      "role": "user",
      "content": "Summarize the incident report."
    }
  ],
  "stream": false
}
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'google/gemini-2.5-flash-image', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
Path('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
PY_RESULT
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'google/gemini-2.5-flash-image', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
from urllib.request import Request, urlopen
from urllib.error import HTTPError

api_key = os.environ['AILOOT_API_KEY']
if not api_key.strip():
    raise SystemExit('Set AILOOT_API_KEY before making a request')
headers = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}
headers['x-api-key'] = api_key
request = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')
try:
    with urlopen(request, timeout=120) as response:
        raw = response.read()
        Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')
except HTTPError as error:
    Path('result.json').write_bytes(error.read())
    Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')
    raise
Path('result.json').write_bytes(raw)
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))

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

Ailoot Ultra · Anthropic хабарламалары

JSON немесе SSE

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

Қайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз.

Барлық мазмұн блоктарын, пайымдау қолтаңбаларын және құрал қолданудың нақты ID мәндерін сақтаңыз. SSE блоктарының барлық өзгерістерін жинаңыз; алғашқы мәтіндік блок толық шығыс емес.

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

Сұрау мен жауаптың ID мәндерін және тақырыптарын сақтаңыз. Мәтіндік тапсырманы алуға арналған ортақ URL берілмеген.

Жауап өрістері
ӨрісТүрі
ӨрісidТүріstring
ӨрісmodelТүріstring
Өрісcontent[]Түріtext|thinking|tool_use|other content block
Өрісstop_reasonТүріstring|null
ӨрісusageТүріobject
Қателер және келесі қадамдар
ЖауапШартКелесі қадам
Жауап400 · invalid_request_errorШартМіндетті өрістер, материалды ұсыну тәсілі немесе параметр мәні қатеКелесі қадамЖаңадан жасау сұрауын жібермес бұрын көрсетілген өрістерді түзетіңіз.

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

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

Ailoot Ultra google/gemini-2.5-flash-image

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

/v1/images

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

google/gemini-2.5-flash-image

FAQ · Google: Nano Banana (Gemini 2.5 Flash Image)
Қандай кіріс деректері мен нәтижелер қолжетімді?

POST /v1/chat/completions · google/gemini-2.5-flash-image: text → text

POST /v1/images/generations · google/gemini-2.5-flash-image: text, image → image

POST /v1/messages · google/gemini-2.5-flash-image: text → json, sse

Сұрау қандай өрістерді пайдаланады?

POST /v1/chat/completions · google/gemini-2.5-flash-image: model, messages, stream, modalities, provider

POST /v1/images/generations · google/gemini-2.5-flash-image: model, prompt, aspect_ratio, n, input_references, provider

POST /v1/messages · google/gemini-2.5-flash-image: model, messages, max_tokens, stream

Қандай шектеулер қолданылады?

POST /v1/chat/completions · google/gemini-2.5-flash-image: messages.min_items: 1

POST /v1/images/generations · google/gemini-2.5-flash-image: n.minimum: 1; n.maximum: 1

Толығырақ

Ailoot-ты Claude Code, OpenCode, Hermes не қолданбаңызға қосыңыз.

Компания және оның жобалар портфелі

Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.

Токенді жеңілдікпен сатып алыңыз.

Тұрақты жұмысқа жазылым жеңілдігі. Токен сатып алуға промокодтар — 50% дейін.

Жазылым
Тұрақты сұрауыңызға жеңілдікті тариф таңдаңыз.
50% дейінгі промокод
Сатып алғанда код енгізіңіз. Баға қазіргі науқанмен қайта есептеледі.
Тарихтағы шығындар
Әр сұрауға модель, токен және сома сақталады.

Жазылым таңдау · Модель бағасын көру

API-ді сататын өніміңізге қосыңыз.

SaaS, қолданба мен бот Ailoot офертасы және лицензиялық шартына сай. Қайта сатуға реселлер лицензиясын сұраңыз.

Коммерциялық қолданба
Қызметіңіздің ақылы функциясына мәтін, сурет, бейне және дыбыс жасауды қосыңыз.
Реселлер лицензиясы
Жоба сипаттамасы мен кіру схемасын жіберіңіз. Пайдалану мен қайта сатуға жазбаша шарт сұраңыз.
Сайттағы құжаттар
Оферта, лицензиялық шарт және дерек саясаты қоспай тұрып қолжетімді.

Реселлер лицензиясын сұрау · Оферта мен лицензиялық шарт