Google: Gemini Embedding 2 (batch)
Gemini Embedding 2 Batch отправляет группы запросов на текстовые эмбеддинги одним пакетом Ailoot. Отслеживайте каждый элемент по custom_id и получите полные результаты исходной операции.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Gemini Embedding 2 Batch использует /v1/batches с точным ID модели google/gemini-embedding-2:batch. Установите endpoint в /v1/embeddings и передайте requests; каждый элемент содержит custom_id и body с input в виде строки текста или массива строк. Сохраняйте идентификаторы неизменными, чтобы приложение могло сопоставить результаты с подготовленной коллекцией документов.
Пакет обрабатывается асинхронно. Сохраните исходный ID операции из ответа и используйте GET /v1/batches/{operation_id}, чтобы отслеживать эту же операцию от имени того же вызывающего клиента. Готовый набор результатов может содержать response или error для каждого custom_id, поэтому проверяйте результаты отдельных элементов вместе с общим статусом.
Сохраните все готовые результаты в JSONL, не теряя ни одного custom_id и полного response или error. Свяжите успешно полученные векторы с отправленными идентификаторами документов до обновления индекса. Храните исходную операцию и записи элементов вместе, чтобы незавершённый или неуспешный элемент можно было исследовать без потери уже полученных результатов.
Ailoot Ultra · Batch POST /v1/batches google/gemini-embedding-2:batch
google/gemini-embedding-2:batch
google/gemini-embedding-2:batchНачало
Gemini Embedding 2 Batch отправляет группы запросов на текстовые эмбеддинги одним пакетом Ailoot. Отслеживайте каждый элемент по custom_id и получите полные результаты исходной операции.
- Допустимые входные данные
- Текст
- Результаты
- embedding
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Batch POST /v1/batches
- Входные данные
text- Результат
embedding
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения google/gemini-embedding-2:batch Условия: Используйте этот селектор маршрутизации Ailoot в точности. | По умолчанию— |
Полеendpoint | Типstring | ТребованиеОбязательно | Значения и ограничения /v1/embeddings Условия: | По умолчанию— |
Полеrequests | Типarray | ТребованиеОбязательно | Значения и ограничения Условия: | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, endpoint, requests |
Параметрoptional | Контракт |
Параметрmaterial_types | Контрактtext |
Параметрconditions | КонтрактИспользуйте этот селектор маршрутизации Ailoot в точности. |
Жизненный цикл: asynchronous
GET /v1/batches/{operation_id} · Фактический исходный response.id, тот же отправитель запроса, ключ и группа
Тарифы
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
- Цены явного кэширования
- Не включено Когда запрошено явное кэширование
Ставки Ailoot
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Токенов контекста больше | Токенов контекста не более, включительно | Плата |
|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Токенов контекста больше— | Токенов контекста не более, включительноБез верхней границы | Плата Вход · Входные токены $0.0002 / 1K токенов Выход · Выходные токены $0 / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
| КонфигурацияУровень 1 по длине запроса | Шкала ставок— | Токенов контекста больше0 | Токенов контекста не более, включительноБез верхней границы | Плата Вход · Входные токены $0.0002 / 1K токенов Выход · Выходные токены $0 / 1K токенов Вход · Чтение кэша — / 1K токенов Вход · Запись в кэш — / 1K токенов Вход · Запись в кэш, 1 час — / 1K токенов |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Batch
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"endpoint": "/v1/embeddings", "model": "google/gemini-embedding-2:batch", "requests": [{"custom_id": "embedding-1", "body": {"input": "The quick brown fox jumps over the lazy dog"}}]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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 @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_BATCH'
import json,os,subprocess
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path("result.json").read_text()); operation=r["id"]
subprocess.run(["curl","--fail-with-body","--silent","--show-error","https://api.ailoot.ai/v1/batches/"+quote(operation,safe=""),"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
s=json.loads(Path("status.json").read_text())
if s.get("status")=="completed": Path("results.jsonl").write_text("".join(json.dumps(x,ensure_ascii=False)+"\n" for x in s.get("results",[])))
# Repeat only this same original GET while pending; never repeat creation.
PY_BATCH
Получить и сохранить результаты
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Сохраняйте все готовые результаты
Сохраняйте каждый полностью полученный ответ, файл и элемент содержимого.
Сохраните исходный статус, каждый custom_id и полный ответ или ошибку. Сохраните все завершённые результаты results[] в формате JSONL; наличие пути загрузки или скачивания через Files не предполагается.
Если нужно проверить исходный ответ
Сохраните исходный идентификатор операции и читайте только исходный пакет. Тайм-аут, ошибка или неизвестное состояние не разрешают повторное создание.
Поля ответа
| Поле | Тип |
|---|---|
Полеresults[] | Типarray |
Полеresults[].custom_id | Типstring |
Полеresults[].response | Типobject |
Полеresults[].error | Типobject |
Ошибки и дальнейшие шаги
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ400 · invalid_request_error | УсловиеОбязательное поле, селектор модели, тип или представление входных данных недопустимы. | Следующий шагИзучите возвращённые сведения о проверке данных перед подготовкой отдельного запроса. |
Ответ | УсловиеИсходный запрос или результат неизвестен либо требует проверки. | Следующий шагСохраните исходные идентификаторы и заголовки; читайте только поддерживаемые записи статуса или библиотеки. Не отправляйте запрос на создание повторно. |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra google/gemini-embedding-2:batch
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · Google: Gemini Embedding 2 (batch)
- Какие входные данные и результаты доступны?
POST /v1/batches·google/gemini-embedding-2:batch:text→embedding- Какие поля использует запрос?
POST /v1/batches·google/gemini-embedding-2:batch:model,endpoint,requests