Google: Gemini Embedding 2 (batch)
Gemini Embedding 2 Batch gửi các nhóm yêu cầu embedding văn bản thành một lô Ailoot. Theo dõi từng mục bằng custom_id và lấy toàn bộ kết quả của thao tác gốc.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Gemini Embedding 2 Batch sử dụng /v1/batches với đúng ID mô hình google/gemini-embedding-2:batch. Đặt endpoint thành /v1/embeddings và cung cấp requests; mỗi mục chứa custom_id cùng body có input là một chuỗi văn bản hoặc mảng chuỗi. Giữ ổn định các mã định danh để ứng dụng ghép kết quả với bộ tài liệu đã chuẩn bị.
Lô được xử lý bất đồng bộ. Giữ ID thao tác gốc được trả về và dùng GET /v1/batches/{operation_id} để theo dõi đúng thao tác đó bằng cùng danh tính gọi. Bộ kết quả hoàn tất có thể chứa phản hồi hoặc lỗi cho từng custom_id, vì vậy hãy kiểm tra kết quả từng mục cùng trạng thái tổng thể.
Lưu toàn bộ kết quả hoàn tất dưới dạng JSONL, giữ mọi custom_id và phản hồi hoặc lỗi đầy đủ tương ứng. Ghép các vector thành công với ID tài liệu đã gửi trước khi cập nhật chỉ mục. Giữ bản ghi thao tác gốc cùng bản ghi từng mục để điều tra mục chưa hoàn tất hay thất bại mà không mất các kết quả đã trả về.
Ailoot Ultra · Batch POST /v1/batches google/gemini-embedding-2:batch
google/gemini-embedding-2:batch
google/gemini-embedding-2:batchBắt đầu
Gemini Embedding 2 Batch gửi các nhóm yêu cầu embedding văn bản thành một lô Ailoot. Theo dõi từng mục bằng custom_id và lấy toàn bộ kết quả của thao tác gốc.
- Đầu vào được chấp nhận
- Văn bản
- Kết quả
- embedding
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · Batch POST /v1/batches
- Đầu vào
text- Đầu ra
embedding
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn google/gemini-embedding-2:batch Điều kiện: Dùng chính xác bộ chọn định tuyến Ailoot này. | Mặc định— |
Trườngendpoint | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn /v1/embeddings Điều kiện: | Mặc định— |
Trườngrequests | Loạiarray | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: | Mặc định— |
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, endpoint, requests |
Tham sốoptional | Hợp đồng |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốconditions | Hợp đồngDùng chính xác bộ chọn định tuyến Ailoot này. |
Vòng đời: asynchronous
GET /v1/batches/{operation_id} · response.id gốc thực tế, cùng bên gọi/khóa/nhóm
Bảng giá
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
- Giá lưu đệm tường minh
- Chưa bật Khi yêu cầu lưu đệm tường minh
Mức phí Ailoot
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Token ngữ cảnh, lớn hơn | Token ngữ cảnh, tối đa và bao gồm | Phí |
|---|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Token ngữ cảnh, lớn hơn— | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào $0.0002 / 1K token Đầu ra · Token đầu ra $0 / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
| Cấu hìnhBậc 1 theo độ dài yêu cầu | Biểu mức phí— | Token ngữ cảnh, lớn hơn0 | Token ngữ cảnh, tối đa và bao gồmKhông có giới hạn trên | Phí Đầu vào · Token đầu vào $0.0002 / 1K token Đầu ra · Token đầu ra $0 / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
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
Nhận và lưu kết quả
Ailoot Ultra · Batch
GET /v1/batches/{operation_id}
Lưu tất cả kết quả đã hoàn tất
Lưu mọi phản hồi hoàn chỉnh, tệp và phần nội dung được trả về.
Giữ nguyên trạng thái gốc, mọi custom_id và toàn bộ phản hồi/lỗi. Lưu tất cả results[] đã hoàn tất dưới dạng JSONL; không suy ra rằng có quy trình tải lên/tải xuống qua Files.
Nếu cần kiểm tra phản hồi gốc
Giữ nguyên ID thao tác gốc và chỉ đọc lô gốc đó. Hết thời gian chờ, lỗi hoặc trạng thái không xác định đều không cho phép tạo lại.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngresults[] | Loạiarray |
Trườngresults[].custom_id | Loạistring |
Trườngresults[].response | Loạiobject |
Trườngresults[].error | Loạiobject |
Lỗi và bước tiếp theo
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnTrường bắt buộc, bộ chọn mô hình, kiểu dữ liệu hoặc cách biểu diễn đầu vào không hợp lệ. | Bước tiếp theoXem chi tiết kết quả kiểm tra tính hợp lệ được trả về trước khi chuẩn bị một yêu cầu riêng. |
Phản hồi | Điều kiệnYêu cầu hoặc kết quả gốc chưa xác định hoặc cần kiểm tra. | Bước tiếp theoGiữ nguyên các mã định danh và trường tiêu đề gốc; chỉ đọc các bản ghi trạng thái/thư viện được hỗ trợ. Không gửi lại yêu cầu tạo. |
Bí danh
Bí danh mô hình
Ailoot Ultra google/gemini-embedding-2:batch
Bí danh đường dẫn phương thức
Dùng các đường dẫn phương thức hiển thị ở trên.
ID gọi liên quan
FAQ · Google: Gemini Embedding 2 (batch)
- Có những đầu vào và kết quả nào?
POST /v1/batches·google/gemini-embedding-2:batch:text→embedding- Yêu cầu sử dụng những trường nào?
POST /v1/batches·google/gemini-embedding-2:batch:model,endpoint,requests