Google: Gemini Embedding 2 (batch)
Gemini Embedding 2 Batchは、複数のテキスト埋め込みリクエストを1つのAilootバッチとして送信します。各項目をcustom_idで追跡し、元の処理から完全な結果を取得してください。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Gemini Embedding 2 Batchは、正確なモデルIDであるgoogle/gemini-embedding-2:batchを指定して/v1/batchesを使用します。endpointを/v1/embeddingsに設定し、requestsを渡します。各項目にはcustom_idとbodyを含め、bodyのinputに文字列または文字列配列を指定してください。結果を準備済みの文書集へ対応付けられるよう、識別子を固定して保持します。
バッチは非同期です。最初に返された処理IDを保持し、同じ呼び出し元でGET /v1/batches/{operation_id}を使って、その同じ処理を追跡してください。完了した結果にはcustom_idごとのresponseまたはerrorが含まれるため、全体のstatusだけでなく各項目の結果も確認します。
各custom_idと完全なresponseまたはerrorを保持したまま、完了した結果をすべてJSONLとして保存してください。インデックスを更新する前に、成功したベクトルを送信時の文書IDに対応付けます。元の処理記録と各項目の記録をまとめて保持すると、すでに返された結果を失わずに、未完了または失敗した項目を調べられます。
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は、複数のテキスト埋め込みリクエストを1つの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の料金
設定別の価格
各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。
| 設定 | 料金表 | コンテキストトークン数が次の値を超える場合 | コンテキストトークン数が次の値以下の場合 | 料金 |
|---|---|---|---|---|
| 設定基本トークン料金 | 料金表基本料金 | コンテキストトークン数が次の値を超える場合— | コンテキストトークン数が次の値以下の場合上限なし | 料金 入力 · 入力トークン $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 によるアップロードやダウンロードの経路があるとは推定しません。
元のレスポンスを確認する場合
元の操作 ID を保持し、その元のバッチだけを読み取ってください。タイムアウト、エラー、または不明な状態は、別の作成を許可するものではありません。
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールド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