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. Её сильные стороны касаются сложных рассуждений, программирования и синтеза свидетельств; итоговый материал всё равно нужно проверять по источнику и реальным результатам инструментов. Сохраняйте неразрешённую неоднозначность, когда предоставленные сведения не поддерживают определённый вывод. Полезный материал — запрошенный подтверждённый ответ, код или запись с достаточными свидетельствами для оценки практических ограничений.
", "aboutText": "Gemini 3.1 Pro Preview — ориентированная на рассуждения текстовая модель Google для сложных задач, которым нужны разработка ПО, создание алгоритмов или синтез мультимодальных свидетельств. Она развивает Gemini 3 Pro, делая акцент на точном использовании инструментов, более эффективных рассуждениях и надёжном многошаговом выполнении. Текст, изображения, аудио, видео и PDF могут вносить вклад в письменный ответ, программный материал или структурированный результат.\n\nДля сложного задания по программированию предоставьте цель, соответствующие материалы репозитория, наблюдаемое поведение и сохраняемые ограничения. Контекст задачи могут предоставлять целые репозитории кода. Для проверки программного контракта попросите сравнить обработку общего контракта данных двумя модулями, найти несоответствие и предложить точечное исправление с подтверждающими ссылками на код. Полезный вывод отделяет анализ, предлагаемую правку и свидетельства от проверок, выполненных подключённым приложением.\n\nМатериалы запуска демонстрируют визуальные объяснения кодом и интерактивные проекты, включая анимированный SVG по текстовому брифу. Это программные материалы, а не генерация растровых изображений. Ясный бриф может определить предмет объяснения, поведение визуализации и представляемые данные. Проверяйте полученный код и отображение по этим требованиям. Для задачи синтеза данных предоставьте реальные источники и запросите единое представление, сохраняющее обнаруженные в них отношения и оговорки.\n\nДокументированные уровни thinking — low, medium и high; по умолчанию для 3.1 Pro Preview применяется high. Полностью отключить thinking в этом профиле Pro нельзя. Выбирайте меньшее усилие для ограниченного ответа и больше рассуждений для трудной многошаговой работы, оставляя достаточный объём вывода итоговому материалу. Маленький предел вывода может прервать рассуждения до появления пригодного итогового ответа. Руководство thinking отделяет краткое изложение рассуждений от полного внутреннего процесса и объясняет значение контекста thought signatures диалога.\n\nТочная таблица Preview перечисляет вызов функций, выполнение кода, привязку к поиску, Maps, URL context и структурированный вывод. File Search ограничен AI Studio. Задавайте назначения функций и определения параметров и продолжайте от реально возвращённого результата. Отдельный профиль Custom Tools Preview оптимизирован для приоритета пользовательских инструментов и bash; это отдельная именованная конечная точка разработчика, поэтому нельзя незаметно считать такую специализацию свойством каждого запроса 3.1 Pro. Выбирайте схему структурированного результата, если задаче нужны заданные записи вместо свободного текста.\n\nДля мультимодального анализа укажите нужную страницу, визуальный материал, интервал записи или событие видео. Для анализа документа сравните схему с письменной спецификацией и верните каждое расхождение с подтверждающим фрагментом. Устный источник может давать расшифровку или текстовую интерпретацию. Сохраняйте ссылки на источники для выводов, требующих проверки, и отделяйте видимое или сказанное от предположений. Вывод этого профиля остаётся текстом, включая код; собственная генерация изображений или речи не входит в его точную таблицу возможностей.\n\nСобственная карточка 3.1 Pro задаёт контекст до 1M и текстовый вывод 64K, а точная таблица Preview API — 1 048 576 токенов входа и 65 536 токенов вывода. Включайте инструкции, историю диалога и медиа во входной бюджет. Документированы кэширование и пакетная обработка; для профиля разработчика также перечислены Flex и Priority. Для нескольких независимых элементов определяйте нужный вывод и сохраняйте идентификатор каждого источника вместо объединения несвязанных свидетельств в один непрослеживаемый ответ.\n\nИменованная версия Preview остаётся отдельной от профиля Pro Custom Tools и последующих выпусков Flash или Pro. Её сильные стороны касаются сложных рассуждений, программирования и синтеза свидетельств; итоговый материал всё равно нужно проверять по источнику и реальным результатам инструментов. Сохраняйте неразрешённую неоднозначность, когда предоставленные сведения не поддерживают определённый вывод. Полезный материал — запрошенный подтверждённый ответ, код или запись с достаточными свидетельствами для оценки практических ограничений.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "ae429c9d1ad76337bd1a322f1c409a7d59342731f34329a468997418306958d8", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "google/gemini-3.1-pro-preview:batchGemini 3.1 Pro Preview — мультимодальная модель рассуждения Google для сложных задач программного обеспечения, алгоритмов и знаний. Она принимает текст, изображения, аудио, видео и PDF и возвращает текст или код, поддерживая инструменты и структурированный выход. Уровни рассуждения low, medium и high задают усилие; документированное значение по умолчанию — high.
Описание раскрывает возможности модели. Доступные в 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. Её сильные стороны касаются сложных рассуждений, программирования и синтеза свидетельств; итоговый материал всё равно нужно проверять по источнику и реальным результатам инструментов. Сохраняйте неразрешённую неоднозначность, когда предоставленные сведения не поддерживают определённый вывод. Полезный материал — запрошенный подтверждённый ответ, код или запись с достаточными свидетельствами для оценки практических ограничений.
POST /v1/batchestexttext| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Поле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 исходного ответа на создание; тот же пользователь, ключ и группа
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Токенов контекста больше | Токенов контекста не более, включительно | Плата |
|---|---|---|---|---|
| КонфигурацияБазовые ставки за токены | Шкала ставокБазовая ставка | Токенов контекста больше— | Токенов контекста не более, включительноБез верхней границы | Плата Вход · Входные токены $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 резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json\nfrom pathlib import Path\nbody=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}}]}')\nPath("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json\nimport json, os\nfrom pathlib import Path\nfrom urllib.request import Request, urlopen\n\ndef prepare_requests(customer_path):\n path = Path(customer_path)\n if not path.is_file(): raise ValueError("Customer JSONL file is missing")\n items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]\n if not items: raise ValueError("Customer JSONL contains no requests")\n ids = set()\n for item in items:\n if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")\n cid = item["custom_id"]\n if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")\n ids.add(cid)\n if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")\n supplied_model = item["body"].get("model")\n 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")\n return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.1-pro-preview:batch", "requests":items}\n\nif __name__ == "__main__":\n material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")\n if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")\n body = prepare_requests(material)\n key = os.environ.get("AILOOT_API_KEY", "")\n if not key: raise SystemExit("Set AILOOT_API_KEY")\n 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")\n with urlopen(request) as response:\n raw = response.read()\n Path("batch-create-response.json").write_bytes(raw)\n print(raw.decode("utf-8"))\nimport json\nfrom pathlib import Path\nraw = Path("batch-status-response.json").read_bytes()\nresponse = json.loads(raw)\nif response.get("status") != "completed":\n raise SystemExit("Keep the original operation; read its status without resubmitting")\nresults = response.get("results")\nif not isinstance(results, list) or not results:\n raise SystemExit("Preserve the original response; completed results are missing")\nPath("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\\n" for item in results), encoding="utf-8")\n# Preserve batch-status-response.json with aggregate usage and every result/error.\nВстроенный JSON results[].response.body
GET /v1/batches/{operation_id}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nBATCH_OPERATION_ID="$(python3 - <<'PY_ID'\nimport json\nfrom pathlib import Path\nfrom urllib.parse import quote\nresponse = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))\noperation = response.get("id")\nif not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")\nprint(quote(operation, safe=""))\nPY_ID\n)"\ncurl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json\nСохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
Сохраняйте полный исходный 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
Используйте пути методов, указанные выше.