Google: Gemini 3 Flash Preview (batch)
Gemini 3 Flash Preview мультимодалды түсіну мен пайымдауды мәтін шығысымен біріктіреді. Ол кодты, құжатты және көрнекілікті талдауды, құрылымдалған нәтижелерді және құралға бағытталған үдерістерді қолдайды; талдау тереңдігін таңдауға арналған төрт құжатталған ойлау деңгейі бар.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Gemini 3 Flash Preview — мультимодалды түсінуге, кодтауға және агенттік тапсырмаларға арналған Google компаниясының пайымдау моделі. Ол мәтін, кескін, бейне, аудио және PDF қабылдап, мәтін қайтарады. Сондықтан сұрау бір мәселе төңірегінде жазбаша нұсқауларды, бастапқы файлдарды, көрнекі бақылауларды және диалог тарихын біріктіре алады. Нәтиже жасалған кескін не ауызша жауап емес, сол материалдарға негізделген түсіндірме, код ұсынысы, шығарылған дерек немесе жоспар болуы мүмкін.
Дәл модель картасы кіріс шегін 1,048,576, шығыс шегін 65,536 токен деп береді. Дереккөз бен нәтижені бөлек жоспарлаңыз: репозиторийдің ұзақ үзіндісі, құжаттар жинағы немесе жазба оның өңделген көрінісі мен нұсқаулар кіріс бюджетіне сыйғанда ғана сыяды, ал жауапқа бәрібір өз ұзындығы бөлінуі керек. Байланысты дереккөздерді белгілеп, қай материалдың беделді екенін көрсетіңіз. Ұзақ промптта әзірлеуші нұсқаулығы нақты сұрақты деректерден кейін қойып, алдыңғы ақпаратқа айқын байланыстыруды ұсынады.
Ойлау динамикалық, осы модельдің құжатталған әдепкісі — high. Қолдау табатын деңгейлер — minimal, low, medium және high. Бұлар кепілді токен саны емес, салыстырмалы пайымдау көлемдері. Minimal қиын кодтау мәселесінде бәрібір аздаған пайымдау қамтуы мүмкін. Деңгейді тапсырмаға сай таңдаңыз: қысқа түрлендіру мен көпшартты жөндеу мәселесіне әртүрлі тәсіл керек. Промптқа күрделі пайымдау рәсімдерін мәжбүрлеп енгізбей, тікелей анық нұсқаулар қолданыңыз; соңғы артефактты және оны қолдануға жарамды ететін тексерулерді сұраңыз.
Өндіруші картасы құрылымдалған шығысты, функция шақыруды, код орындауды, компьютер қолдануды, файл іздеуді, іздеу арқылы негіздеуді, Google Maps арқылы негіздеуді, URL контекстін және кэштеуді тізімдейді. Құжатталған Gemini 3 үдерісінде кіріктірілген құралдарды арнайы функция шақырумен біріктіруге болады. Қолданба функцияларды анықтайды, аргументтерін тексереді, қабылданған әрекеттерді орындайды және нәтижелерін қайта жібереді. Код көмекшісінде файл оқу немесе басқарылатын тест орындағыш құралы келесі қадамға нақты дәлел бере алады. Соңғы есепте ұсынылған әрекет пен байқалған құрал нәтижесі бөлек қалуы керек.
Бағдарламалау үшін тиісті файлдарды, тілді, күтілетін мінез-құлықты және мәселені көрсететін кірісті беріңіз. Өзгеріс ауқымын бекітіп, сақталуы тиіс интерфейсті не мінез-құлықты атаңыз. Түзетілген іске асыру мен тексерілетін жағдайларды сұраңыз. Құжатты талдау тапсырмасына сұрақты, міндетті өрістерді және дереккөз сілтемелерін анықтаңыз. Құрылымдалған шығыс қолданылса, өріс мағыналары мен жоқ мән ережелері айқын схеманы беріңіз. Оның синтаксисін де, әр мәннің бастапқы материалдан шығатынын да тексеріңіз.
Мультимодалды талдауда әр дереккөзде не маңызды екенін көрсетіңіз. Скриншот интерфейс түсіндірмесін қолдай алады, PDF кесте не диаграмма бере алады, ал жазба айтылған немесе көрінетін оқиғаларды жеткізе алады. Әзірлеуші нұсқаулығы медиа ажыратымдылығын басқаруды талқылайды, өйткені егжей-тегжей өңделген көрініс пен токен жұмсалуын өзгертеді. Өндірушінің код орындау үдерісі модель жауап дайындағанға дейін берілген кескіндерді қиып не үлкейтіп, көрнекі деректермен есептеу жүргізіп, түсіндірме белгілер қоса алады. Оқылатын ұсақ мәтінге жалпы көрініс сипаттамасынан басқа параметр қажет болуы мүмкін. Жатық түйіндемені әр бөлшек дұрыс оқылғанының дәлелі санамай, бақылауларды тексеру үшін тиісті бетті, кескінді не роликті қолжетімді сақтаңыз.
Таңдалған интерфейсте диалог пен құрал күйін сақтау керек. Gemini 3 шақырулар арасында пайымдау контекстін тасымалдау үшін ойлау қолтаңбаларын қолданады; әзірлеуші нұсқаулығы басқарылатын күйлі тарихты қолмен басқарылатын күйсіз тарихтан ажыратады. Құрал тапсырмасын жалғастырғанда немесе нәтижені түзеткенде қажетті контексті сақтаңыз. Google күрделі тапсырмаларда цикл не нашар мінез-құлық туғызуы мүмкін төмен temperature тәсілін көшірмей, өзінің әдепкі 1.0 temperature мәнін сақтауды да ұсынады. Бұлар белгілі қолданбаның тасымалы туралы жаңа мәлімдемелер емес, өндірушінің интеграция тәжірибелері.
Мәтін моделі кескін не аудио генерациясын немесе Live API-ді ұсынбайды. Нұсқаулық көрнекі түсінуді пиксель деңгейіндегі кескін сегменттеуінен де ажыратады; соңғысы Gemini 3 Flash қолдайтын мүмкіндік емес. Нақты тапсырмаға лайық соңғы нәтиже қолданыңыз: дереккөзге байланыстырылған бақылаулар, құрылымдалған жазба, код өзгерісі немесе жорамалдары көрсетілген шешім. Арифметиканы тексеріңіз, кодты көзделген ортада сынаңыз және қайтарылған құрал ақпаратын қараңыз. Жаңа фактілер маңызды болса, модель білімін нақты уақытта жаңартылатын дерекқор деп болжамай, бапталған негіздеу дереккөздерін немесе берілген өзекті деректерді қолданыңыз.
Ailoot Ultra · Пакеттік өңдеу POST /v1/batches google/gemini-3-flash-preview:batch
google/gemini-3-flash-preview:batch
google/gemini-3-flash-preview:batchБастау
Gemini 3 Flash Preview мультимодалды түсіну мен пайымдауды мәтін шығысымен біріктіреді. Ол кодты, құжатты және көрнекілікті талдауды, құрылымдалған нәтижелерді және құралға бағытталған үдерістерді қолдайды; талдау тереңдігін таңдауға арналған төрт құжатталған ойлау деңгейі бар.
- Қабылданатын кіріс деректері
- Мәтін
- Нәтижелер
- Мәтін
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Пакеттік өңдеу POST /v1/batches
- Кіріс
text- Шығыс
text- Шығыс пішімі
- Жауаптың ішіндегі results[].response.body JSON деректері
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісendpoint | Түріstring | ТалапМіндетті | Мәндер мен шектеулер /v1/chat/completions | Әдепкі— |
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер google/gemini-3-flash-preview:batch | Әдепкі— |
Өрісrequests | Түріbatch_item[] | ТалапМіндетті | Мәндер мен шектеулер Элементтердің ең аз саны: 1 | Әдепкі— |
Өрісrequests[].custom_id | Түріstring | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісrequests[].body.messages | Түріmessage[] | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісcompletion_window | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 24h | Әдепкі— |
Өрісprovider | Түріobject|null | ТалапМіндетті емес | Мәндер мен шектеулер | Әдепкі— |
Өрісrequests[].body.model | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер google/gemini-3-flash-preview:batch, google/gemini-3-flash-preview | Әдепкі— |
Өрісprovider.only | Түріstring[] | ТалапМіндетті емес | Мәндер мен шектеулер google-vertex/global | Әдепкі— |
Өрісprovider.allow_fallbacks | Түріboolean|null | ТалапМіндетті емес | Мәндер мен шектеулер false, null | Әдепкі— |
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыendpoint, model, requests |
Параметрmaterial_types | Параметр талаптарыtext |
Параметрrepresentation | Параметр талаптарыСұрау ішіне енгізілген requests[]; әр элементте custom_id және body бар |
Параметрrequest_endpoint_profile | Параметр талаптары/v1/chat/completions |
Параметрfile_material | Параметр талаптарыСұрауды жіберуші нақты UTF-8 JSONL деректерін жергілікті ортада оқып, requests[] ішіне енгізе алады. Жүктеу мақсаты, input_file_id немесе файлға сілтеме қолданылмайды. Клиент материалы жоқ немесе бос болса, дайындық POST жіберілгенге дейін тоқтатылады. |
Параметрserialization_order | Параметр талаптарыendpoint, model, provider (берілген болса), completion_window (берілген болса), requests өрісін соңында орналастырыңыз |
Параметрoptional_controls | Параметр талаптарыprovider.only, provider.allow_fallbacks, completion_window |
Параметрschema_scope | Параметр талаптарыҚұжаттамада сипатталған, сұраудың ішіне енгізілетін Batch құрылымындағы мәтіндік Chat Completions сұрауларының денелері. |
Өмірлік цикл: asynchronous
GET /v1/batches/{operation_id} · Бастапқы жасау жауабындағы нақты response.id; сол пайдаланушы/кілт/топ
Тарифтер
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
- Жылдам режим
- Көрсетілмеген Жылдам режим таңдалғанда
- Икемді режим
- Көрсетілмеген flex режимі таңдалғанда
- Ой қорытудың ең жоғары деңгейі
- Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
- Айқын кэштеу бағасы
- Қосылмаған Айқын кэштеу сұралғанда
Ailoot мөлшерлемелері
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Контекст токендерінің саны мынадан көп | Контекст токендерінің саны мынадан аспайды, шегі кіреді | Төлем |
|---|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Контекст токендерінің саны мынадан көп— | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері $0.0005 / 1K токен Шығыс · Шығыс токендері $0.003 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен |
| БаптауСұрау ұзындығының 1-деңгейі | Мөлшерлемелер кестесі— | Контекст токендерінің саны мынадан көп0 | Контекст токендерінің саны мынадан аспайды, шегі кіредіЖоғарғы шегі жоқ | Төлем Кіріс · Кіріс токендері $0.0005 / 1K токен Шығыс · Шығыс токендері $0.003 / 1K токен Кіріс · Кэшті оқу — / 1K токен Кіріс · Кэшке жазу — / 1K токен Кіріс · Кэшке жазу, 1 сағ — / 1K токен |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
Ailoot Ultra · Пакеттік өңдеу
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-3-flash-preview:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json
import json, os
from pathlib import Path
from urllib.request import Request, urlopen
def prepare_requests(customer_path):
path = Path(customer_path)
if not path.is_file(): raise ValueError("Customer JSONL file is missing")
items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
if not items: raise ValueError("Customer JSONL contains no requests")
ids = set()
for item in items:
if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
cid = item["custom_id"]
if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
ids.add(cid)
if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
supplied_model = item["body"].get("model")
if supplied_model is not None and supplied_model not in ['google/gemini-3-flash-preview:batch', 'google/gemini-3-flash-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")
return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3-flash-preview:batch", "requests":items}
if __name__ == "__main__":
material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
body = prepare_requests(material)
key = os.environ.get("AILOOT_API_KEY", "")
if not key: raise SystemExit("Set AILOOT_API_KEY")
request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")
with urlopen(request) as response:
raw = response.read()
Path("batch-create-response.json").write_bytes(raw)
print(raw.decode("utf-8"))
import json
from pathlib import Path
raw = Path("batch-status-response.json").read_bytes()
response = json.loads(raw)
if response.get("status") != "completed":
raise SystemExit("Keep the original operation; read its status without resubmitting")
results = response.get("results")
if not isinstance(results, list) or not results:
raise SystemExit("Preserve the original response; completed results are missing")
Path("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\n" for item in results), encoding="utf-8")
# Preserve batch-status-response.json with aggregate usage and every result/error.
Нәтижелерді алу және сақтау
Ailoot Ultra · Пакеттік өңдеу
Жауаптың ішіндегі results[].response.body JSON деректері
GET /v1/batches/{operation_id}
Тапсырма күйін тексеру
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json
Барлық дайын нәтижені сақтау
Қайтарылған әр толық жауапты, файлды және мазмұн бөлігін сақтаңыз.
Бастапқы күй туралы толық JSON деректерін, әрбір нәтижені/custom_id мәнін және жауаптың немесе қатенің толық денесін сақтаңыз. Аяқталған results[] деректерін сүзгілемей JSONL түрінде сақтаңыз.
Бастапқы жауапты тексеру қажет болса
Бастапқы операцияның ID мәнін сақтаңыз. 503 result_pending_check жауабында X-Should-Retry:false көрсетіледі; нәтижесі белгісіз бастапқы пакетті ешқашан қайта жібермеңіз.
Жауап өрістері
| Өріс | Түрі |
|---|---|
Өрісresults[].custom_id | Түріstring |
Өрісresults[].response.body.choices[].message.content | Түріstring|null |
Өрісresults[].error | Түріobject|null |
Өрісusage | Түріobject|null |
Өрісid | Түріstring |
Өрісmodel | Түріstring |
Өрісendpoint | Түріstring |
Өрісstatus | Түріstring |
Өрісrequest_counts | Түріobject |
Өрісresults[].id | Түріstring |
Өрісresults[].response.status_code | Түріinteger |
Өрісresults[].response.request_id | Түріstring |
Қателер және келесі қадамдар
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартҚұжаттамада сипатталған сұрау ішіндегі құрылым жарамсыз, кілттер қайталанады, элементтің сәйкестігі бұзылған немесе бапталған модель мүмкіндіктері арасында қайшылық бар. | Келесі қадамЖаңадан жібермес бұрын көрсетілген өрістерді түзетіңіз. |
Жауап401 · authentication_error | ШартЖарамсыз API кілті. | Келесі қадамПайдалануға рұқсат берілген Ailoot кілтін қолданыңыз. |
Жауап403 · permission_error | ШартПакеттік өңдеу тобы қолжетімсіз. | Келесі қадамКілттің/топтың қол жеткізу құқығын тексеріңіз. |
Жауап422 · invalid_request_error | ШартBatch төлемді баланстан алады; жазылыммен төленетін жасау сұрауы қабылданбайды. | Келесі қадамБаланстан төлем алынатын, пайдалануға рұқсат берілген топты қолданыңыз. |
Жауап422 · price_unavailable | ШартBatch кіріс деректерінің құнын алдын ала есептеу мүмкін емес. | Келесі қадамЖауапты сақтаңыз; осы әдістер тобы үшін құжаттамада сипатталған кіріс деректерін қолданыңыз. |
Жауап402 · billing_error | ШартПакеттік өңдеу үшін қаражатты резервтеу қолжетімсіз. | Келесі қадамЖаңа сұрау жібермес бұрын сұрауды қабылдау мәселесін шешіңіз. |
Жауап503 · price_unavailable | ШартBatch әдісінің бағасы/жүйенің төл тарифтері қолжетімсіз. | Келесі қадамЖауапты сақтаңыз; бағаларды басқа мәндермен алмастырмаңыз. |
Жауап503 · api_error | ШартПровайдердің осы нақты маршруты қолжетімсіз. | Келесі қадамМаршрутты түзету үшін жауапты сақтаңыз. |
Жауап503 · result_pending_check | ШартБастапқы нәтижені тексеру қажет; X-Should-Retry:false. | Келесі қадамБастапқы operation_id/id мәнін сақтап, оның күйін оқыңыз; бастапқы POST сұрауын ешқашан қайталамаңыз. |
Жауап404 · not_found | ШартBatch күйін тексеретін операция жоқ немесе басқа субъектіге тиесілі. | Келесі қадамБастапқы id мәнін дәл қолданыңыз және сол пайдаланушыны/кілтті/топты пайдаланыңыз. |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra google/gemini-3-flash-preview:batch
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
FAQ · Google: Gemini 3 Flash Preview (batch)
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/batches·google/gemini-3-flash-preview:batch:text→text- Сұрау қандай өрістерді пайдаланады?
POST /v1/batches·google/gemini-3-flash-preview:batch:endpoint,model,requests,completion_window,provider- Қандай шектеулер қолданылады?
POST /v1/batches·google/gemini-3-flash-preview:batch:requests.min_items:1