Gemini 3.8 Flash

Dùng gemini-3.8-flash với định dạng Gemini gốc. Trang mô hình có Playground và giá hiện tại; hướng dẫn so sánh mô hình đối chiếu các thiết lập được ghi trong tài liệu với Gemini 3.1 Pro.

ID mô hình

Ví dụ nhanh

curl https://api.seedrouter.ai/v1beta/models/gemini-3.8-flash:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Explain a mutex in one sentence."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"low"},"maxOutputTokens":1024}}'

Mô hình được đặt trong URL. contents là trường bắt buộc. Câu trả lời có các trường gốc candidates, finishReason và usageMetadata; hãy giữ nguyên toàn bộ các phần nội dung, bao gồm thoughtSignature, trong lịch sử hội thoại.

Điểm cuối

Đặc tả OpenAPI bao gồm mọi lược đồ yêu cầu và phản hồi lồng nhau. Các trường tùy chọn dùng giá trị mặc định của API khi bị bỏ qua. SeedRouter chuyển tiếp nguyên phần thân đã gửi, không lọc trường không xác định, loại bỏ trường không được hỗ trợ hay xác thực giá trị tham số mô hình. Gemini API quyết định có chấp nhận yêu cầu hay không.

Tham số yêu cầu

URL cố định mô hình là gemini-3.8-flash. Đặc tả yêu cầu có 12 trường cấp cao nhất. Các trường là tùy chọn trừ khi được đánh dấu bắt buộc; bỏ qua trường khác với JSON null. JSON tùy ý có thể nhận null được giữ nguyên ở những nơi lược đồ chính thức cho phép.

Tham số tạo nội dung

Tài liệu OpenAPI liệt kê kiểu lồng nhau, enum, thuộc tính bắt buộc và giới hạn được ghi trong tài liệu cho từng thông điệp. Các lược đồ mô tả tham số chính thức, không phải danh sách trường yêu cầu được SeedRouter cho phép. Trường và giá trị do bên gọi gửi được giữ nguyên. Một trường được lược đồ chấp nhận không chứng minh mọi mô hình hay tài khoản đều hỗ trợ. Không hỗ trợ suy luận minimal. Temperature, topP, topK và candidateCount không phải thiết lập chính thức của mô hình này. Nếu được gửi trong JSON gốc, chúng vẫn chuyển tiếp nguyên trạng để Gemini API xử lý. Kết thúc hội thoại bằng nội dung người dùng; API chính thức không hỗ trợ lượt cuối điền sẵn nội dung mô hình. Lượt người dùng chỉ có phản hồi hàm vẫn hợp lệ.

Đầu ra có cấu trúc

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 1024,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

Không thể dùng đồng thời hai trường cũ responseSchema và responseJsonSchema. Cả hai yêu cầu responseMimeType: "application/json". Lược đồ responseFormat.text mới hơn cũng phải chỉ định JSON. Dùng cách viết enum của REST (APPLICATION_JSON và TEXT_PLAIN) trong thông điệp đó. Yêu cầu được chuyển tiếp nguyên trạng; kiểu MIME của nội dung đa phương tiện và JSON tùy ý của hàm không bị viết lại.

Hàm và công cụ tích hợp

Dùng tools[].functionDeclarations với tên và một trong hai trường parameters hoặc parametersJsonSchema, không dùng cả hai. Lược đồ phản hồi cũng tuân theo quy tắc loại trừ lẫn nhau này. Cấu hình lựa chọn hàm nằm trong toolConfig.functionCallingConfig; allowedFunctionNames yêu cầu ANY hoặc VALIDATED cùng các tên đã khai báo.

Mô hình hỗ trợ gọi hàm. Ứng dụng của bạn thực thi hàm được trả về và cung cấp kết quả trong lượt hội thoại tiếp theo. Giữ nguyên từng thoughtSignature, lời gọi hàm và phản hồi hàm ban đầu. Không làm tròn định danh dạng số khi tuần tự hóa các đối số hàm không cần diễn giải.

Google liệt kê Search, Maps, thực thi mã và ngữ cảnh URL là khả năng của mô hình. Tài liệu mô hình ghi nhận hỗ trợ File Search. Tài nguyên bộ nhớ đệm và tìm kiếm tệp hiện có yêu cầu quyền truy cập theo thông tin xác thực phục vụ yêu cầu. Computer Use được liệt kê ở trạng thái Preview. Cấu hình MCP gốc xuất hiện trong lược đồ chung nhưng chưa xác nhận khả năng dùng trên mô hình này. Google Maps yêu cầu đầu vào và đầu ra chỉ là văn bản; kiểm tra các hạn chế API chính thức trước khi kết hợp Maps với nội dung đa phương tiện. Playground không thực thi hàm tùy chỉnh của bạn.

Đầu vào đa phương thức và an toàn

Một mục contents[].parts[] chứa đúng một loại dữ liệu: văn bản, nội dung đa phương tiện nội tuyến, tham chiếu tệp, lời gọi/phản hồi hàm hoặc phần thực thi. Mục này cũng có thể mang chữ ký hay siêu dữ liệu đa phương tiện. Đầu vào hỗ trợ văn bản, hình ảnh, âm thanh, video và PDF; đầu ra chỉ là văn bản.

Với byte nội tuyến, dùng inlineData.mimeType và data dạng base64. Với tham chiếu tệp, dùng fileData.mimeType và fileUri. URL đúng cú pháp không chứng minh mô hình có thể truy xuất. Siêu dữ liệu video có thể chỉ định độ lệch bắt đầu/kết thúc và fps dương không quá 24. Độ phân giải đa phương tiện chung và theo từng phần là các thiết lập riêng. Agentic Video được hỗ trợ qua videoMetadata.processingMode: "AGENTIC".

Dùng JSON gốc cho nội dung đa phương tiện nội tuyến, hoặc tham chiếu tệp có thể truy cập cho nội dung lớn hơn. Giới hạn chính xác về định dạng tệp, thời lượng và nội dung đa phương tiện mỗi yêu cầu vẫn phụ thuộc tài liệu chính thức và xác minh thực tế.

Thiết lập an toàn dùng định dạng gốc chính thức. Khi bỏ qua, giá trị mặc định của Gemini API có hiệu lực; thiết lập được gửi tường minh chuyển tiếp nguyên trạng.

Phản hồi JSON và truyền luồng

generateContent trả về JSON gốc. streamGenerateContent?alt=sse phát JSON gốc trong các sự kiện SSE data:. Các trường quan trọng gồm candidates[].content.parts, finishReason, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId và usageMetadata.

Giữ nguyên toàn bộ nội dung gốc trong lịch sử hội thoại. Bản tóm tắt suy luận khác với chữ ký suy luận. Mất kết nối không chứng minh lượt tạo đã thất bại hay hoàn tất; hãy kiểm tra kết quả từng phần và bản ghi tài khoản trước khi gửi yêu cầu khác. Mức sử dụng trong luồng là lũy kế, vì vậy dùng bộ đếm mới nhất thay vì cộng từng đoạn.

Chưa xác nhận khả năng tiếp tục đầu ra dài cho Gemini 3.8 Flash. Không xây dựng vòng lặp tiếp tục chỉ vì lược đồ phản hồi chung có trường token.

Mức sử dụng và giá

promptTokenCount bao gồm đầu vào từ bộ nhớ đệm. cachedContentTokenCount được tính theo giá đầu vào từ bộ nhớ đệm, không bị tính lại như đầu vào không từ bộ nhớ đệm. Đầu ra tính phí gồm candidatesTokenCount cộng thoughtsTokenCount. Token đầu vào dùng công cụ được báo cáo cũng được tính vào đầu vào.

Mô hình này không có bước tăng giá ngữ cảnh dài ở 200,000 token. Các nhóm tài khoản khả dụng dùng cùng biểu thức giá mô hình và hệ số hiện tại riêng. Xem bảng giá trực tiếp.

Flex và Priority là các cấp xử lý riêng. Flex dùng một nửa giá đầu vào, đầu ra và đầu vào từ bộ nhớ đệm của Standard; Priority dùng mức giá gấp 1.8 lần. Giá ưu đãi ban đầu do Google công bố kết thúc ngày 31 tháng 12 năm 2026; luôn kiểm tra bảng SeedRouter hiện tại thay vì giả định giá trong tương lai. Kết quả được báo cáo là Standard không được chịu phụ phí Priority. Nếu yêu cầu Priority không có phản hồi xác nhận cấp thực tế, tích hợp này dùng giá token Standard. Phí công cụ và lưu trữ bộ nhớ đệm tường minh tách biệt với giá token tạo nội dung; không cam kết hạn mức công cụ miễn phí dùng chung. Yêu cầu thất bại không bị tính phí.

Nhiều nhóm tài khoản

Mô hình dùng googlellm và googlellm-vertext, giữ nguyên quyền tài khoản và giá hiện có. Tên từng nhóm phải viết chính xác. Chọn nhóm khả dụng trong Playground hoặc dùng tiêu đề API tùy chọn:

X-SeedRouter-Group: googlellm

Dùng googlellm-vertext để chọn nhóm thứ hai. Nhóm được chọn quyết định giá và năng lực khả dụng; lựa chọn tường minh không âm thầm chuyển sang nhóm khác. Bỏ tiêu đề hoặc dùng auto để giữ hành vi mặc định của khóa API.

Kiểm tra các nhóm khả dụng của khóa API mà không tạo câu trả lời:

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-3.8-flash"   -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

Trạng thái xác minh

Các thành phần điều khiển và tài liệu tuân theo định dạng gốc chính thức. Gemini API chịu trách nhiệm xác thực tham số. Kiểm tra truyền tải và tính phí ngoại tuyến không chứng minh khả năng dùng trong môi trường thực tế. Tạo nội dung thực tế, cả hai nhóm tài khoản, hiểu nội dung đa phương tiện, tài nguyên bộ nhớ đệm, công cụ tích hợp và các cấp xử lý vẫn cần xác minh đầu cuối có trả phí. Không đưa ra so sánh chất lượng hay độ trễ đã đo với Gemini 3.1 Pro.

Tài liệu tham khảo

• Đặc tả mô hình Google
• Thay đổi của Gemini 3.8
• Tài liệu tham khảo REST GenerateContent
• Đầu ra có cấu trúc
• Suy luận
• Giá