Google: Gemini Embedding 2 Preview
Gemini Embedding 2 Preview 將文字、圖片、音訊、影片與 PDF 轉成同一多模態空間中的數值向量。另有文件記載的預覽規格，支援跨模態檢索與比較、8,192 token 輸入及彈性向量維度。
關於模型
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
Gemini Embedding 2 Preview 是 Google 原生多模態嵌入家族中具名的預覽版本。它將文字、圖片、影片、音訊與 PDF 映射至共用數值空間，表示超過 100 種語言的語意意圖。輸出是嵌入，也就是用於比較及檢索相關資料的向量。此預覽識別與穩定版 Gemini Embedding 2 不同，不代表權重可互換或向量空間相同。
最初發布說明將跨模態搜尋、分類、分群、情感分析及檢索增強生成列為後續應用。文字查詢能找到相關視覺項目，圖片或片段也能作為搜尋起點。應用程式儲存並比較表示，再回傳對應記錄；另一個語言模型可使用檢索來源資料起草答案。嵌入本身不包含自然語言解釋或逐字稿。
此版本自身的模型頁面記載 8,192 token 輸入上限，以及 128 至 3,072 的輸出維度，建議大小為 768、1,536、3,072。預覽公告列出預設為 3,072，並描述 Matryoshka Representation Learning，讓表示較短的前綴仍保留有用資訊。需比較的向量應統一選定維度，並將模型版本和資料集合一起保留，不要只因長度相符就合併表示。
預覽公告記載每個請求最多六張 PNG 或 JPEG 圖片、最長 120 秒 MP4 或 MOV 影片，以及最多六頁的 PDF 文件。也記載音訊可直接嵌入，不需經過中間文字轉錄。這些規格出自預覽版本自身公告，而非後續穩定版指南。該公告不能確定此確切預覽規格目前所有音訊時長、編解碼器或影格取樣限制。
交錯多模態輸入，讓表示反映媒體間的關係，例如圖片與說明文字。產品目錄中，若照片與核准說明描述同一個可檢索物件，請一起提供。文件集合應將來源拆成聚焦段落或頁面，並保留標題與位置。媒體庫應選擇使用者要找事件的對應片段，將原始時間範圍和儲存記錄一起保留。
實用檢索任務會明確定義預期關係。尋求解釋的問題、搜尋視覺相似項目、依主題分群，即使使用同一來源集合，也是不同任務。請一致準備內容，記錄版本與維度，並將每個向量連結至來源。相似度提供應用程式待檢視候選項，不是兩筆記錄敘述相同事實，或檢索來源完整回答問題的證明。
實際媒體搜尋請表示選定圖片或影片摘錄，再與所需內容的描述比較。請將相符來源連同說明文字或時間範圍呈現，讓使用者審查。知識助理應先檢索相關頁面或段落，再生成書面回覆。Preview 模型的角色，是支援這些選擇步驟的多模態數值表示；儲存、排名規則與最終答案，仍是周邊流程的一部分。
Ailoot Ultra · 嵌入向量 POST /v1/embeddings google/gemini-embedding-2-preview
google/gemini-embedding-2-preview
google/gemini-embedding-2-preview入門
Gemini Embedding 2 Preview 將文字、圖片、音訊、影片與 PDF 轉成同一多模態空間中的數值向量。另有文件記載的預覽規格，支援跨模態檢索與比較、8,192 token 輸入及彈性向量維度。
- 接受的輸入
- 文字
- 結果
- embedding
Ailoot 可用 · 輸入與方法
Ailoot Ultra · 嵌入向量 POST /v1/embeddings
- 輸入
text- 輸出
embedding- 上下文
- 8,192 tokens
- 輸出格式
- json
| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位model | 類型string | 要求必填 | 值與限制 google/gemini-embedding-2-preview | 預設值— |
欄位input | 類型string|string[] | 要求必填 | 值與限制 | 預設值— |
輸入素材組合
text_to_embedding
方法參數與生命週期
| 參數 | 規格 |
|---|---|
參數content_type | 規格application/json |
參數required | 規格model, input |
參數input_shapes | 規格string, string[] |
參數material_types | 規格text |
生命週期： synchronous_json
請保留每個回傳的向量與索引。
此最小文字設定檔不代表支援圖片／音訊／檔案物件。
方案
費率資訊不會增加請求選項。支援的參數列於所選方法中。
- 快速模式
- 未指定 選取快速模式時
- flex 模式
- 未指定 選取 flex 模式時
- 最高推理強度
- 未指定 最高推理強度採用 default 調整值時
Ailoot 費率
各設定的價格
| 設定 | 費率表 | 費用 |
|---|---|---|
| 設定詞元基本費率 | 費率表基本費率 | 費用 輸入 · 輸入 Token $0.0004 / 1K Token 輸出 · 輸出 Token $0 / 1K Token 輸入 · 讀取快取 — / 1K Token 輸入 · 寫入快取 — / 1K Token 輸入 · 寫入快取，1 小時 — / 1K Token |
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
請求範例
Ailoot Ultra · 嵌入向量
{
"model": "google/gemini-embedding-2-preview",
"input": [
"First document",
"Second document"
]
}set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > embedding-request.json <<'JSON_REQUEST'
{
"model": "google/gemini-embedding-2-preview",
"input": [
"First document",
"Second document"
]
}
JSON_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @embedding-request.json -o embedding-response.json
接收並儲存結果
Ailoot Ultra · 嵌入向量
json
保留所有已完成的結果
請保留所有完整傳回的回應、檔案與內容區塊。
保留每個向量及其索引。向量數量必須與輸入數量相同，且維度必須一致。
需要檢查原始回應時
此流程未引入嵌入向量任務端點。
回應欄位
| 欄位 | 類型 |
|---|---|
欄位object | 類型string |
欄位model | 類型string |
欄位data[].index | 類型integer |
欄位data[].embedding | 類型finite float[] |
欄位usage | 類型object |
錯誤與後續步驟
| 回應 | 條件 | 下一步 |
|---|---|---|
回應400 · invalid_request_error | 條件缺少 model，或 JSON 格式錯誤。 | 下一步請修正指出的欄位。 |
回應413 · invalid_request_error | 條件超過已設定的本文大小上限。 | 下一步請減少實際素材量。 |
回應422 · invalid_request_error | 條件輸入或控制選項違反目前的專用政策。 | 下一步請使用所示的最小文字輸入，切勿帶入繼承的控制選項。 |
回應503 · billing_error | 條件無法綁定使用許可或報價。 | 下一步請保留回應；切勿替換政策。 |
別名
模型別名
Ailoot Ultra google/gemini-embedding-2-preview
方法路徑別名
請使用上方列出的 API 方法路徑。
相關呼叫用 ID
FAQ · Google: Gemini Embedding 2 Preview
- 可以使用哪些輸入與結果？
POST /v1/embeddings·google/gemini-embedding-2-preview:text→embedding- 請求使用哪些欄位？
POST /v1/embeddings·google/gemini-embedding-2-preview:model,input- 適用哪些限制？
POST /v1/embeddings·google/gemini-embedding-2-preview:ctx:8192