Google: Gemini 3.1 Pro Preview (batch)

Gemini 3.1 Pro Preview — мультимодальная модель рассуждения Google для сложных задач программного обеспечения, алгоритмов и знаний. Она принимает текст, изображения, аудио, видео и PDF и возвращает текст или код, поддерживая инструменты и структурированный выход. Уровни рассуждения low, medium и high задают усилие; документированное значение по умолчанию — high.

Ailoot Ultra · Пакетная обработка POST /v1/batches google/gemini-3.1-pro-preview:batch

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

Gemini 3.1 Pro Preview — ориентированная на рассуждения текстовая модель Google для сложных задач, которым нужны разработка ПО, создание алгоритмов или синтез мультимодальных свидетельств. Она развивает Gemini 3 Pro, делая акцент на точном использовании инструментов, более эффективных рассуждениях и надёжном многошаговом выполнении. Текст, изображения, аудио, видео и PDF могут вносить вклад в письменный ответ, программный материал или структурированный результат.

Для сложного задания по программированию предоставьте цель, соответствующие материалы репозитория, наблюдаемое поведение и сохраняемые ограничения. Контекст задачи могут предоставлять целые репозитории кода. Для проверки программного контракта попросите сравнить обработку общего контракта данных двумя модулями, найти несоответствие и предложить точечное исправление с подтверждающими ссылками на код. Полезный вывод отделяет анализ, предлагаемую правку и свидетельства от проверок, выполненных подключённым приложением.

Материалы запуска демонстрируют визуальные объяснения кодом и интерактивные проекты, включая анимированный SVG по текстовому брифу. Это программные материалы, а не генерация растровых изображений. Ясный бриф может определить предмет объяснения, поведение визуализации и представляемые данные. Проверяйте полученный код и отображение по этим требованиям. Для задачи синтеза данных предоставьте реальные источники и запросите единое представление, сохраняющее обнаруженные в них отношения и оговорки.

Документированные уровни thinking — low, medium и high; по умолчанию для 3.1 Pro Preview применяется high. Полностью отключить thinking в этом профиле Pro нельзя. Выбирайте меньшее усилие для ограниченного ответа и больше рассуждений для трудной многошаговой работы, оставляя достаточный объём вывода итоговому материалу. Маленький предел вывода может прервать рассуждения до появления пригодного итогового ответа. Руководство thinking отделяет краткое изложение рассуждений от полного внутреннего процесса и объясняет значение контекста thought signatures диалога.

Точная таблица Preview перечисляет вызов функций, выполнение кода, привязку к поиску, Maps, URL context и структурированный вывод. File Search ограничен AI Studio. Задавайте назначения функций и определения параметров и продолжайте от реально возвращённого результата. Отдельный профиль Custom Tools Preview оптимизирован для приоритета пользовательских инструментов и bash; это отдельная именованная конечная точка разработчика, поэтому нельзя незаметно считать такую специализацию свойством каждого запроса 3.1 Pro. Выбирайте схему структурированного результата, если задаче нужны заданные записи вместо свободного текста.

Для мультимодального анализа укажите нужную страницу, визуальный материал, интервал записи или событие видео. Для анализа документа сравните схему с письменной спецификацией и верните каждое расхождение с подтверждающим фрагментом. Устный источник может давать расшифровку или текстовую интерпретацию. Сохраняйте ссылки на источники для выводов, требующих проверки, и отделяйте видимое или сказанное от предположений. Вывод этого профиля остаётся текстом, включая код; собственная генерация изображений или речи не входит в его точную таблицу возможностей.

Собственная карточка 3.1 Pro задаёт контекст до 1M и текстовый вывод 64K, а точная таблица Preview API — 1 048 576 токенов входа и 65 536 токенов вывода. Включайте инструкции, историю диалога и медиа во входной бюджет. Документированы кэширование и пакетная обработка; для профиля разработчика также перечислены Flex и Priority. Для нескольких независимых элементов определяйте нужный вывод и сохраняйте идентификатор каждого источника вместо объединения несвязанных свидетельств в один непрослеживаемый ответ.

Именованная версия Preview остаётся отдельной от профиля Pro Custom Tools и последующих выпусков Flash или Pro. Её сильные стороны касаются сложных рассуждений, программирования и синтеза свидетельств; итоговый материал всё равно нужно проверять по источнику и реальным результатам инструментов. Сохраняйте неразрешённую неоднозначность, когда предоставленные сведения не поддерживают определённый вывод. Полезный материал — запрошенный подтверждённый ответ, код или запись с достаточными свидетельствами для оценки практических ограничений.

Ailoot Ultra · Пакетная обработка POST /v1/batches google/gemini-3.1-pro-preview:batch

google/gemini-3.1-pro-preview:batch

Google /google/gemini-3.1-pro-preview:batch

Начало

Допустимые входные данные: Текст
Результаты: Текст

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Пакетная обработка POST /v1/batches

Входные данные: text
Результат: text
Выходной формат: Встроенный JSON results[].response.body

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`endpoint`	Тип`string`	ТребованиеОбязательно	Значения и ограничения /v1/chat/completions	По умолчанию—
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения google/gemini-3.1-pro-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.1-pro-preview:batch, google/gemini-3.1-pro-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`	КонтрактВызывающая сторона может локально прочитать фактический JSONL в UTF-8 и поместить его в requests[]. Назначение загрузки, input_file_id и ссылка на файл не используются. Отсутствующий или пустой материал клиента останавливает подготовку до POST.
Параметр`serialization_order`	Контрактendpoint, model, provider (если указан), completion_window (если указан), requests — последним
Параметр`optional_controls`	Контрактprovider.only, provider.allow_fallbacks, completion_window
Параметр`schema_scope`	КонтрактТела текстовых запросов Chat Completions в документированной встроенной оболочке Batch.

Жизненный цикл: asynchronous

GET /v1/batches/{operation_id} · Фактический response.id исходного ответа на создание; тот же пользователь, ключ и группа

Тарифы

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим: Не указано При выборе быстрого режима
Режим flex: Не указано При выборе режима flex
Максимальная интенсивность рассуждений: Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Цены явного кэширования: Не включено Когда запрошено явное кэширование

Ставки Ailoot

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

Конфигурация	Шкала ставок	Токенов контекста больше	Токенов контекста не более, включительно	Плата
КонфигурацияБазовые ставки за токены	Шкала ставокБазовая ставка	Токенов контекста больше—	Токенов контекста не более, включительноБез верхней границы	Плата Вход · Входные токены $0.002 / 1K токенов Выход · Выходные токены $0.012 / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов
КонфигурацияУровень 1 по длине запроса	Шкала ставок—	Токенов контекста больше0	Токенов контекста не более, включительно200 000	Плата Вход · Входные токены $0.002 / 1K токенов Выход · Выходные токены $0.012 / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов
КонфигурацияУровень 2 по длине запроса	Шкала ставок—	Токенов контекста больше200 000	Токенов контекста не более, включительноБез верхней границы	Плата Вход · Входные токены $0.004 / 1K токенов Выход · Выходные токены $0.018 / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Пакетная обработка

curl · сохранённый образец запросаPython HTTP · реальный JSONL клиентаPython · сохраните каждый готовый результат

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.1-pro-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.1-pro-preview:batch', 'google/gemini-3.1-pro-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.1-pro-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 · Пакетная обработка

Встроенный JSON results[].response.body

GET /v1/batches/{operation_id}

Проверить статус задачи

curl · статус исходной операции

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`	УсловиеПакетная обработка оплачивается с баланса; создание по подписке отклоняется.	Следующий шагИспользуйте разрешённую группу с оплатой с баланса.
Ответ422 · `price_unavailable`	УсловиеСтоимость входных данных пакета невозможно рассчитать.	Следующий шагСохраните ответ; используйте документированный формат входных данных для этого семейства.
Ответ402 · `billing_error`	УсловиеРезерв для пакетной обработки недоступен.	Следующий шагУстраните причину отказа в допуске перед новым запросом.
Ответ503 · `price_unavailable`	УсловиеЦена метода пакетной обработки или нативные тарифы недоступны.	Следующий шагСохраните ответ; не подменяйте цены.
Ответ503 · `api_error`	УсловиеТочный маршрут поставщика недоступен.	Следующий шагСохраните ответ для исправления маршрута.
Ответ503 · `result_pending_check`	УсловиеИсходный результат требует проверки; X-Should-Retry:false.	Следующий шагСохраните исходный operation_id/id и читайте его статус; никогда не повторяйте исходный POST.
Ответ404 · `not_found`	УсловиеОперация проверки статуса пакета отсутствует или принадлежит другой учётной записи.	Следующий шагИспользуйте точный исходный id и того же пользователя, ключ и группу.

Псевдонимы

Псевдонимы моделей

Ailoot Ultra google/gemini-3.1-pro-preview:batch

Псевдонимы путей метода

Используйте пути методов, указанные выше.

Связанные ID для вызова

google/gemini-3.1-pro-preview:batch

FAQ · Google: Gemini 3.1 Pro Preview (batch)

Какие входные данные и результаты доступны?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: text → text
Какие поля использует запрос?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: endpoint, model, requests, completion_window, provider
Какие ограничения действуют?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: requests.min_items: 1

Google: Gemini 3.1 Pro Preview (batch)