OpenAI: GPT-4.1 (batch)
OpenAI GPT-4.1 — модель без отдельного этапа рассуждения для точного выполнения инструкций, программирования и вызова инструментов. Она принимает текст и изображения и возвращает текст, поддерживая большой контекст, Structured Outputs и Predicted Outputs для повторной генерации преимущественно неизменённого текста или кода.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
GPT-4.1 — модель OpenAI без отдельного этапа рассуждения для выполнения инструкций и вызова инструментов, с широкими знаниями в разных областях. Она принимает текст и изображения и возвращает текст без специального шага рассуждения. Большой контекст полезен, когда задача ясно определена, а нужные материалы занимают значительные документы или код. Укажите желаемую операцию, исходный материал для неё и форму итогового результата.
Для обработки документов отделяйте инструкции от материала заголовками или другими ясными границами. Размечайте документы и сохраняйте идентификаторы, на которые должен ссылаться ответ. Определите поля извлечения, критерии сравнения либо аудиторию и длину переработанного текста. Пример вывода — таблица требований с их положением в источниках, резюме по заданному набору вопросов или структурированная запись, отличающая отсутствующие сведения от явного значения.
Для программирования предоставьте нужные файлы, запрошенную правку и поведение, которое нужно сохранить. Запрашивайте фактически необходимый материал: изменённую функцию, полный файл, предлагаемые аргументы инструмента или объяснение затрагиваемой логики. Примеры могут уточнять правило форматирования или граничный случай, но должны следовать тем же требованиям, что и реальная задача. Руководство OpenAI по инструкциям выделяет прямые указания, роли, границы источников и характерные примеры, не предполагая автоматической точности длинной инструкции.
Точная спецификация GPT-4.1 указывает контекстное окно 1 047 576 токенов, максимальный вывод 32 768 токенов и границу знаний 1 июня 2024 года. Большой входной контекст не означает такого же большого вывода, поэтому запрос переработки обширного материала должен определять нужную часть и итоговый материал. Оставляйте достаточно места для ответа и предоставляйте актуальную информацию, если задача зависит от фактов после границы знаний. Документированный тип модели GPT-4.1 — chat; настройки интенсивности рассуждения из более новых моделей рассуждения не входят в этот профиль.
OpenAI документирует для GPT-4.1 интерфейсы Chat Completions, Responses, Assistants, Batch и дообучения. Перечисленные возможности включают потоковую передачу, Structured Outputs, вызов функций, загрузку файлов, входные изображения, веб-поиск и поиск по файлам, дообучение и кэширование входных данных. Инструменты включают интерпретацию кода, генерацию изображений и подключения MCP, а также поиск и функции. Собственный вывод модели — текст, тогда как инструмент может вернуть отдельный материал или наблюдение. Определяйте назначение и аргументы операции приложения и используйте её фактический результат; сгенерированный моделью запрос не подтверждает завершения внешней операции.
Особая возможность — Predicted Outputs в интерфейсе OpenAI Chat Completions. Когда большая часть нужного текста или кода уже известна, существующее содержание можно передать как предсказание, чтобы помочь повторно создать полный результат с небольшой правкой. Например, предоставьте текущий файл и запросите точно ограниченное переименование свойства с сохранением окружающего кода. Предсказание — ожидаемое содержание вывода, а не инструкция и не гарантия правильности неизменённых частей. Проверяйте повторно созданный материал по запрошенной правке и оригиналу.
У Predicted Outputs собственные ограничения совместимости. OpenAI документирует работу только с текстом, без входного или выходного аудио и без вызова функций в таком запросе. Не поддерживаются несколько вариантов при n больше 1, логарифмические вероятности, положительные значения штрафов за присутствие или частотность и параметр max_completion_tokens. Отделяйте этот процесс повторной генерации от задачи с вызовами инструментов. Текст предсказания может совпадать с частями вывода, а производитель сообщает принятые и отклонённые токены предсказания; неподходящее предсказание может частично остаться неиспользованным, поэтому возможность не гарантирует конкретного ускорения или результата.
Для обычного выполнения инструкций полезный результат GPT-4.1 — документ или код, соответствующий определённой спецификации, извлечённые данные с явными полями или запрос инструмента с аргументами, подходящими предоставленной операции. Для небольшой правки преимущественно неизменного файла процесс с предсказанным выводом даёт более конкретный способ подготовить ожидаемый результат. В обоих случаях сохраняйте материалы для проверки ответа и явно показывайте неоднозначность. Контекст и инструменты модели поддерживают процесс; задание по-прежнему определяет содержание полного, пригодного к использованию ответа.
Ailoot Ultra · Пакетная обработка POST /v1/batches openai/gpt-4.1:batch
openai/gpt-4.1:batchНачало
OpenAI GPT-4.1 — модель без отдельного этапа рассуждения для точного выполнения инструкций, программирования и вызова инструментов. Она принимает текст и изображения и возвращает текст, поддерживая большой контекст, Structured Outputs и Predicted Outputs для повторной генерации преимущественно неизменённого текста или кода.
- Допустимые входные данные
- Текст
- Результаты
- Текст
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Пакетная обработка POST /v1/batches
- Входные данные
text- Результат
text- Выходной формат
- Встроенный JSON results[].response.body
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеendpoint | Типstring | ТребованиеОбязательно | Значения и ограничения /v1/chat/completions | По умолчанию— |
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения openai/gpt-4.1:batch | По умолчанию— |
Полеrequests | Типbatch_item[] | ТребованиеОбязательно | Значения и ограничения Минимум элементов: 1 | По умолчанию— |
Полеrequests[].custom_id | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеrequests[].body.messages | Типmessage[] | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеcompletion_window | Типstring | ТребованиеНеобязательно | Значения и ограничения 24h | По умолчанию— |
Полеprovider | Типobject|null | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеrequests[].body.model | Типstring | ТребованиеНеобязательно | Значения и ограничения openai/gpt-4.1:batch, openai/gpt-4.1 | По умолчанию— |
Полеprovider.only | Типstring[] | ТребованиеНеобязательно | Значения и ограничения openai | По умолчанию— |
Поле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.008 / 1K токенов Вход · Чтение кэша $0.0005 / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
| КонфигурацияУровень 1 по длине запроса | Шкала ставок— | Токенов контекста больше0 | Токенов контекста не более, включительноБез верхней границы | Плата Вход · Входные токены $0.002 / 1K токенов Выход · Выходные токены $0.008 / 1K токенов Вход · Чтение кэша $0.0005 / 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":"openai/gpt-4.1: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 ['openai/gpt-4.1:batch', 'openai/gpt-4.1']: raise ValueError("body.model must be an exact documented caller or wire ID")
return {"endpoint":"/v1/chat/completions", "model":"openai/gpt-4.1: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}
Проверить статус задачи
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 openai/gpt-4.1:batch
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · OpenAI: GPT-4.1 (batch)
- Какие входные данные и результаты доступны?
POST /v1/batches·openai/gpt-4.1:batch:text→text- Какие поля использует запрос?
POST /v1/batches·openai/gpt-4.1:batch:endpoint,model,requests,completion_window,provider- Какие ограничения действуют?
POST /v1/batches·openai/gpt-4.1:batch:requests.min_items:1