Google: Gemini 3.8 Flash (batch)

Gemini 3.8 Flash là mô hình đa phương thức chủ lực của Google dành cho kỹ thuật phần mềm kéo dài, tác tử và tác vụ kiến thức phức tạp. Mô hình nhận văn bản, hình ảnh, âm thanh, video và PDF, trả văn bản, có mức suy luận low, medium hoặc high cùng công cụ và đầu ra có cấu trúc. Giới hạn đầu vào/đầu ra được ghi trong tài liệu là 1,048,576/65,536 token.

Ailoot Ultra · Xử lý hàng loạt POST /v1/batches google/gemini-3.8-flash:batch

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 3.8 Flash là mô hình đầu ra văn bản của Google dành cho kỹ thuật phần mềm kéo dài, tác tử nhiều bước và quy trình kiến thức phức tạp. Mô hình phát triển từ Gemini 3.7 Flash, cải thiện kỹ thuật phần mềm và công việc kiến thức theo tác tử. Mô hình nhận văn bản, hình ảnh, âm thanh, video và PDF, nên tác vụ có thể kết hợp mục tiêu viết với tài liệu thực tế cần để giải quyết. Kết quả hữu ích là thay đổi mã, phân tích có giải thích, câu trả lời viết hoặc bản ghi có cấu trúc.

Với nhiệm vụ lập trình, cung cấp yêu cầu, tệp liên quan, hành vi quan sát được và ràng buộc cần giữ. Ảnh chụp màn hình có thể xác lập giao diện mong muốn, còn nhật ký hoặc ví dụ tái hiện cho thấy lỗi. Với gỡ lỗi, yêu cầu mô hình truy nguyên sai khác giữa trạng thái hiển thị của biểu mẫu và giá trị lưu, xác định đường mã chịu trách nhiệm và đề xuất sửa tập trung. Giữ sản phẩm cuối dự kiến rõ ràng để chuỗi tìm hiểu và sử dụng công cụ dài hơn vẫn có điều kiện hoàn thành cụ thể.

Với công việc kéo dài, dùng bước suy luận nhỏ hơn, lời gọi công cụ lặp theo tiến trình và kiểm tra kết quả trung gian. Các mức suy luận low, medium và high điều khiển lượng suy luận; medium là mặc định được ghi trong tài liệu. Low phù hợp bản thảo nhanh hoặc phân tích có giới hạn, còn high dành cho toán khó, lập trình hoặc tác vụ nhiều bước. Gemini 3.8 Flash không hỗ trợ mức suy luận minimal. Vì vậy, gỡ lỗi kéo dài và trích xuất trường đơn giản cần lựa chọn suy luận khác nhau, thay vì cùng một thiết lập cho mọi yêu cầu.

Các công cụ được ghi trong tài liệu gồm gọi hàm, thực thi mã, tìm kiếm tệp, sử dụng kết quả tìm kiếm làm căn cứ, sử dụng thông tin Google Maps làm căn cứ và ngữ cảnh URL, với Computer Use được liệt kê là khả năng xem trước. Đầu ra có cấu trúc định nghĩa kết quả máy có thể đọc. Hàm cần có mục đích và định nghĩa tham số rõ ràng: mô hình có thể yêu cầu hàm, còn ứng dụng kết nối thực hiện thao tác và trả kết quả. Giữ định danh hàm và tài liệu thực tế trả về qua các lượt. Câu trả lời cuối hữu ích giải thích bằng chứng nào hỗ trợ chỉnh sửa đề xuất hoặc giá trị trích xuất.

Hướng dẫn chuyển đổi 3.8 dùng tùy chọn mức suy luận thay cho cấu hình ngân sách suy luận cũ và khuyên bỏ tham số lấy mẫu đã ngừng khuyến nghị cùng các lượt model điền sẵn. Hướng dẫn còn yêu cầu giữ chữ ký suy luận trong quy trình không trạng thái liên quan và ghép phản hồi hàm với lời gọi theo định danh và tên. Những chi tiết này quan trọng khi tiếp tục tác vụ nhiều bước: lượt sau cần ngữ cảnh trước thực tế thay vì bản kể lại đã làm mất kết quả công cụ hoặc chữ ký. Giữ câu hỏi và đầu ra yêu cầu tường minh trong lượt user mới.

Với công việc kiến thức đa phương thức, xác định trang tài liệu, biểu đồ, khoảng âm thanh hoặc sự kiện video liên quan và nêu cách nó đóng góp vào câu trả lời. So sánh tài liệu có thể yêu cầu bảng khác biệt kèm đoạn trích nguồn; câu hỏi biểu đồ có thể hỏi giá trị nhìn thấy và kết luận chúng hỗ trợ. Phân tích video có thể yêu cầu mô tả các sự kiện làm căn cứ cho phát hiện. Mô hình trả văn bản từ những đầu vào này. Tạo hình ảnh, giọng nói và tương tác âm thanh Live thuộc các cấu hình mô hình riêng.

Giới hạn Gemini API là 1,048,576 token đầu vào và 65,536 token đầu ra, tương ứng với ngữ cảnh đến 1M và đầu ra văn bản 64K của mô hình gốc. Chỉ dẫn, lịch sử hội thoại và phương tiện được cung cấp dùng ngữ cảnh đầu vào, còn suy luận hoặc sản phẩm cuối dài phải nằm trong hạn mức đầu ra được ghi trong tài liệu. Google còn liệt kê bộ nhớ đệm, xử lý theo lô, xử lý Flex và Priority cho cấu hình nhà sản xuất này. Với các mục độc lập, giữ định danh mục ổn định và định dạng đầu ra rõ ràng để mỗi kết quả vẫn gắn với nguồn.

Hạn chế có thể gồm bịa đặt thông tin, đôi khi chậm hoặc hết thời gian và sử dụng nhiều token hơn ở mức nỗ lực cao. Mốc cập nhật kiến thức là tháng 3 năm 2026, một số lĩnh vực vẫn giới hạn ở tháng 1 năm 2025. Cung cấp bằng chứng hiện hành hoặc dùng công cụ cung cấp thông tin làm căn cứ được ghi trong tài liệu khi tác vụ phụ thuộc thông tin mới hơn. Đối chiếu trích dẫn nguồn, phép tính và mã đề xuất với đầu vào thực tế và kết quả thực thi. Sản phẩm cuối hữu ích cần phân biệt phát hiện có căn cứ với câu hỏi chưa giải quyết, không giả định câu trả lời trôi chảy chứng minh đã đạt kết quả yêu cầu.

Ailoot Ultra · Xử lý hàng loạt POST /v1/batches google/gemini-3.8-flash:batch

google/gemini-3.8-flash:batch

Google /google/gemini-3.8-flash:batch

Bắt đầu

Đầu vào được chấp nhận: Văn bản
Kết quả: Văn bản

Có trên Ailoot · đầu vào & phương thức

Ailoot Ultra · Xử lý hàng loạt POST /v1/batches

Đầu vào: text
Đầu ra: text
Định dạng đầu ra: JSON nội tuyến tại results[].response.body

Trường	Loại	Yêu cầu	Giá trị & giới hạn	Mặc định
Trường`endpoint`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn /v1/chat/completions	Mặc định—
Trường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn google/gemini-3.8-flash:batch	Mặc định—
Trường`requests`	Loại`batch_item[]`	Yêu cầuBắt buộc	Giá trị & giới hạn Số mục tối thiểu: 1	Mặc định—
Trường`requests[].custom_id`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn	Mặc định—
Trường`requests[].body.messages`	Loại`message[]`	Yêu cầuBắt buộc	Giá trị & giới hạn	Mặc định—
Trường`completion_window`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn 24h	Mặc định—
Trường`provider`	Loại`object\|null`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn	Mặc định—
Trường`requests[].body.model`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn google/gemini-3.8-flash:batch, google/gemini-3.8-flash	Mặc định—
Trường`provider.only`	Loại`string[]`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn google-vertex/global	Mặc định—
Trường`provider.allow_fallbacks`	Loại`boolean\|null`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn false, null	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 đồngendpoint, model, requests
Tham số`material_types`	Hợp đồngtext
Tham số`representation`	Hợp đồngrequests[] nội tuyến; mỗi phần tử có custom_id và body
Tham số`request_endpoint_profile`	Hợp đồng/v1/chat/completions
Tham số`file_material`	Hợp đồngBên gọi có thể đọc dữ liệu JSONL UTF-8 thực tế trên máy cục bộ vào requests[]. Không sử dụng mục đích tải lên, input_file_id hay tham chiếu tệp. Nếu thiếu tài liệu của khách hàng hoặc tài liệu rỗng, dừng khâu chuẩn bị trước POST.
Tham số`serialization_order`	Hợp đồngendpoint, model, provider (nếu được cung cấp), completion_window (nếu được cung cấp), requests ở cuối
Tham số`optional_controls`	Hợp đồngprovider.only, provider.allow_fallbacks, completion_window
Tham số`schema_scope`	Hợp đồngPhần thân yêu cầu Chat Completions dạng văn bản trong cấu trúc Batch nội tuyến được mô tả trong tài liệu.

Vòng đời: asynchronous

GET /v1/batches/{operation_id} · response.id thực tế từ phản hồi tạo gốc; cùng người dùng/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.00075 / 1K token Đầu ra · Token đầu ra $0.00375 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.000075 / 1K token Đầu vào · Ghi bộ nhớ đệm $0.0000833333333333334 / 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.00075 / 1K token Đầu ra · Token đầu ra $0.00375 / 1K token Đầu vào · Đọc bộ nhớ đệm $0.000075 / 1K token Đầu vào · Ghi bộ nhớ đệm $0.0000833333333333334 / 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 · Xử lý hàng loạt

curl · mẫu kiểm thử đã lưuPython HTTP · JSONL thực tế của khách hàngPython · lưu từng kết quả đã hoàn tất

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":"google/gemini-3.8-flash: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 ['google/gemini-3.8-flash:batch', 'google/gemini-3.8-flash']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.8-flash: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.

Nhận và lưu kết quả

Ailoot Ultra · Xử lý hàng loạt

JSON nội tuyến tại results[].response.body

GET /v1/batches/{operation_id}

Kiểm tra trạng thái tác vụ

curl · trạng thái thao tác gốc

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

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ữ lại toàn bộ JSON trạng thái gốc, mọi kết quả/custom_id và toàn bộ phần thân phản hồi hoặc lỗi. Lưu results[] đã hoàn tất dưới dạng JSONL mà không lọc.

Nếu cần kiểm tra phản hồi gốc

Giữ nguyên ID thao tác gốc. Phản hồi 503 result_pending_check có X-Should-Retry:false; tuyệt đối không gửi lại lô gốc có trạng thái chưa xác định.

Trường phản hồi

Trường	Loại
Trường`results[].custom_id`	Loạistring
Trường`results[].response.body.choices[].message.content`	Loạistring\|null
Trường`results[].error`	Loạiobject\|null
Trường`usage`	Loạiobject\|null
Trường`id`	Loạistring
Trường`model`	Loạistring
Trường`endpoint`	Loạistring
Trường`status`	Loạistring
Trường`request_counts`	Loạiobject
Trường`results[].id`	Loạistring
Trường`results[].response.status_code`	Loạiinteger
Trường`results[].response.request_id`	Loạistring

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ệnCấu trúc nội tuyến không đúng tài liệu, có khóa trùng, định danh phần tử không hợp lệ hoặc xung đột với khả năng đã cấu hình của mô hình.	Bước tiếp theoSửa các trường được chỉ ra trước khi gửi bất kỳ yêu cầu mới nào.
Phản hồi401 · `authentication_error`	Điều kiệnKhóa API không hợp lệ.	Bước tiếp theoSử dụng khóa Ailoot đã được cấp quyền.
Phản hồi403 · `permission_error`	Điều kiệnNhóm xử lý hàng loạt không khả dụng.	Bước tiếp theoKiểm tra quyền sử dụng của khóa/nhóm.
Phản hồi422 · `invalid_request_error`	Điều kiệnXử lý hàng loạt tính phí từ số dư; yêu cầu tạo qua gói thuê bao bị từ chối.	Bước tiếp theoSử dụng nhóm đã được cấp quyền và tính phí từ số dư.
Phản hồi422 · `price_unavailable`	Điều kiệnKhông thể báo giá cho dữ liệu đầu vào của lô.	Bước tiếp theoGiữ lại phản hồi; sử dụng dữ liệu đầu vào của họ API được mô tả trong tài liệu.
Phản hồi402 · `billing_error`	Điều kiệnKhoản dự trữ cho xử lý hàng loạt không khả dụng.	Bước tiếp theoKhắc phục vấn đề về điều kiện tiếp nhận trước khi gửi yêu cầu mới.
Phản hồi503 · `price_unavailable`	Điều kiệnGiá phương thức xử lý hàng loạt/đơn giá gốc không khả dụng.	Bước tiếp theoGiữ lại phản hồi; không thay thế đơn giá.
Phản hồi503 · `api_error`	Điều kiệnTuyến cụ thể tới nhà cung cấp không khả dụng.	Bước tiếp theoGiữ lại phản hồi để sửa tuyến.
Phản hồi503 · `result_pending_check`	Điều kiệnKết quả gốc cần được kiểm tra; X-Should-Retry:false.	Bước tiếp theoGiữ lại operation_id/id gốc và truy xuất trạng thái của thao tác đó; tuyệt đối không lặp lại POST gốc.
Phản hồi404 · `not_found`	Điều kiệnKhông tìm thấy thao tác kiểm tra trạng thái lô hoặc thao tác thuộc một danh tính khác.	Bước tiếp theoSử dụng đúng id gốc và cùng người dùng/khóa/nhóm.

Bí danh

Bí danh mô hình

Ailoot Ultra google/gemini-3.8-flash: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

google/gemini-3.8-flash:batch

FAQ · Google: Gemini 3.8 Flash (batch)

Có những đầu vào và kết quả nào?: POST /v1/batches · google/gemini-3.8-flash:batch: text → text
Yêu cầu sử dụng những trường nào?: POST /v1/batches · google/gemini-3.8-flash:batch: endpoint, model, requests, completion_window, provider
Áp dụng những giới hạn nào?: POST /v1/batches · google/gemini-3.8-flash:batch: requests.min_items: 1

Google: Gemini 3.8 Flash (batch)