Source: https://ailoot.ai/models/ru/google-gemini-3-1-pro-preview-u003a-batch/ Canonical: https://ailoot.ai/models/ru/google-gemini-3-1-pro-preview-u003a-batch/ Language: ru # Google: Gemini 3.1 Pro Preview (batch) [Markdown](https://ailoot.ai/models/ru/google-gemini-3-1-pro-preview-u003a-batch/index.md) · [JSON](https://ailoot.ai/models/ru/google-gemini-3-1-pro-preview-u003a-batch/facts.json) ## [Google: Gemini 3.1 Pro Preview (batch)](https://ailoot.ai/models/ru/google-gemini-3-1-pro-preview-u003a-batch/) Gemini 3.1 Pro Preview — мультимодальная модель рассуждения Google для сложных задач программного обеспечения, алгоритмов и знаний. Она принимает текст, изображения, аудио, видео и PDF и возвращает текст или код, поддерживая инструменты и структурированный выход. Уровни рассуждения low, medium и high задают усилие; документированное значение по умолчанию — high. - [**Ailoot Ultra · Пакетная обработка** `POST /v1/batches` `google/gemini-3.1-pro-preview:batch`](https://ailoot.ai/models/ru/google-gemini-3-1-pro-preview-u003a-batch/#method-0) О модели Описание раскрывает возможности модели. Доступные в 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`](https://ailoot.ai/models/ru/#m=google%2Fgemini-3.1-pro-preview%3Abatch&route=Ultra&caller=google%2Fgemini-3.1-pro-preview%3Abatch&fmt=batches) Google /`google/gemini-3.1-pro-preview:batch` ### Начало Gemini 3.1 Pro Preview — мультимодальная модель рассуждения Google для сложных задач программного обеспечения, алгоритмов и знаний. Она принимает текст, изображения, аудио, видео и PDF и возвращает текст или код, поддерживая инструменты и структурированный выход. Уровни рассуждения low, medium и high задают усилие; документированное значение по умолчанию — high. Допустимые входные данные Текст Результаты Текст ### Доступно в 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 резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. [Как работают резервирование и расчёт →](https://ailoot.ai/docs/ru/billing/reserve/) ### Примеры запросов #### Ailoot Ultra · Пакетная обработка curl · сохранённый образец запросаPython HTTP · реальный JSONL клиентаPython · сохраните каждый готовый результат ```bash 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 ``` ```python 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")) ``` ```python 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 · статус исходной операции ```bash 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`](https://ailoot.ai/models/ru/#m=google%2Fgemini-3.1-pro-preview%3Abatch&route=Ultra&caller=google%2Fgemini-3.1-pro-preview%3Abatch&fmt=batches) #### Псевдонимы путей метода Используйте пути методов, указанные выше. #### Связанные ID для вызова [`google/gemini-3.1-pro-preview:batch`](https://ailoot.ai/models/ru/#m=google%2Fgemini-3.1-pro-preview%3Abatch&route=Ultra&caller=google%2Fgemini-3.1-pro-preview%3Abatch&fmt=batches) 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` Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению. ## Компания и портфель её проектов Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. ## Покупайте токены со скидкой. Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов. Подписка Выберите тариф со скидкой для своих регулярных запросов. Промокод до 50% Введите код при покупке. Цена пересчитается с учётом действующей акции. Расходы в истории Модель, токены и сумма сохраняются для каждого запроса. [Выбрать подписку](https://ailoot.ai/docs/ru/billing/subscriptions/) · [Посмотреть цены моделей](https://ailoot.ai/models/ru/) ## Подключайте API к продукту, который вы продаёте. SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию. Коммерческое приложение Встраивайте генерацию текста, картинок, видео и звука в платные функции своего сервиса. Лицензия для реселлера Пришлите описание проекта и схему доступа. Запросите письменные условия использования и перепродажи. Документы на сайте Оферта, лицензионный договор и политика обработки данных доступны до подключения. [Запросить реселлерскую лицензию](mailto:support@ailoot.ai) · [Оферта и лицензионный договор](https://ailoot.ai/legal/offer?lang=ru) ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.