Text
Gemini 4 Neon
Yêu cầu Gemini gốc, bốn mức suy luận, tạo câu trả lời dài với token tiếp tục, công cụ, đầu vào đa phương thức và streaming. Bao gồm giới hạn mô hình và trạng thái xác minh.
Dùng gemini-4-neon với định dạng Gemini gốc. Trang mô hình có Playground và giá hiện tại. Gemini 4 Neon nằm giữa Gemini 4 Hydrogen và Gemini 4 Carbon và dùng cùng định dạng yêu cầu generateContent gốc; hướng dẫn chuyển đổi của Google cho biết việc chuyển giữa các mô hình Gemini 4 không cần thay đổi schema yêu cầu.
ID mô hình
| ID mô hình | Cửa sổ ngữ cảnh | Mức nỗ lực mặc định |
|---|---|---|
gemini-4-neon | 1.048.576 token, dùng chung cho đầu vào, suy luận và đầu ra | high |
Dùng gemini-4-neon cho bậc Default, hoặc chọn một bậc gemini-4-neon:GROUP_NAME chỉ định rõ do cơ chế khám phá mô hình trả về. Kiểm tra các bậc khả dụng của bạn trước khi gửi yêu cầu.
Ví dụ nhanh
curl https://api.seedrouter.ai/v1beta/models/gemini-4-neon:generateContent \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"role":"user","parts":[{"text":"Audit this payment retry queue for race conditions and propose lock acquisition steps."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"high"},"maxOutputTokens":65536}}'Mô hình nằm trong URL. contents là bắt buộc. Câu trả lời có candidates, finishReason và usageMetadata gốc; giữ đầy đủ các phần nội dung, bao gồm thoughtSignature, cho lịch sử hội thoại. Prompt khó có thể chạy trong vài phút. Google khuyến nghị thời gian chờ phía máy khách là 20 phút. Dùng streaming để nhận đầu ra ngay khi có.
Endpoint
| Thao tác | Endpoint |
|---|---|
| Phản hồi JSON | POST /v1beta/models/gemini-4-neon:generateContent |
| Sự kiện do máy chủ gửi | POST /v1beta/models/gemini-4-neon:streamGenerateContent?alt=sse |
Đặc tả OpenAPI bao gồm mọi schema yêu cầu và phản hồi lồng nhau. Trường tùy chọn dùng giá trị mặc định của API khi bị bỏ qua. API gốc công khai giữ nguyên phần thân được gửi để Gemini xác thực. Playground cũng kiểm tra các ràng buộc trong tài liệu trước khi gửi và thực thi thiết lập an toàn của nó.
Tham số yêu cầu
URL cố định mô hình là gemini-4-neon. Hợp đồng yêu cầu có 11 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 khác với JSON null. JSON tùy ý có thể nhận null được giữ nguyên khi schema chính thức cho phép.
| Trường | Kiểu | Bắt buộc | Mặc định và ràng buộc |
|---|---|---|---|
contents | object[] | Có | Hội thoại không rỗng; mỗi nội dung có parts không rỗng |
systemInstruction | object | Không | Các phần chỉ có văn bản; không tự động chèn danh tính người dùng |
generationConfig | object | Không | Tham số tạo phản hồi trong bảng tiếp theo |
tools | object[] | Không | Khai báo hàm và cấu hình công cụ tích hợp |
toolConfig | object | Không | Cấu hình lựa chọn hàm và truy xuất |
safetySettings | object[] | Không | Một thiết lập cho mỗi danh mục; không trùng danh mục |
serviceTier | string | Không | unspecified, standard, flex, priority; xử lý thông thường là standard |
continuationToken | string | Không | Token trả về cùng finishReason: CONTINUATION hoặc MAX_TOKENS; gửi lại cùng yêu cầu với token đó để tiếp tục câu trả lời dài |
labels | object | Không | Giá trị chuỗi; khóa/giá trị viết thường, mỗi mục tối đa 63 điểm mã Unicode |
model | string | Không | Tên tài nguyên tùy chọn; URL xác định mô hình thực tế |
store | boolean | Không | Tùy chọn lưu trữ yêu cầu chung; tác động riêng trên mô hình chưa được xác minh |
Gemini 4 Neon không hỗ trợ lưu ngữ cảnh vào bộ nhớ đệm một cách tường minh (tài nguyên cachedContent và cachedContents). Bộ nhớ đệm ngầm được bật mặc định cho prompt có ít nhất 4.096 token.
Tham số tạo phản hồi
Trường trong generationConfig | Kiểu | Mặc định và ràng buộc |
|---|---|---|
maxOutputTokens | integer | Mặc định 65.536, bao gồm suy luận. Tối đa 1.048.576 trừ đầu vào khi dùng tiếp tục. Mỗi phản hồi streaming hoặc không streaming hỗ trợ tối đa 65.536 token; dùng tiếp tục cho đầu ra dài hơn |
thinkingConfig | object | thinkingLevel: low, medium, high, xhigh (mặc định high); chấp nhận cách viết hoa. includeThoughts: boolean, mặc định false. Dùng thinkingLevel; thinkingBudget đã ngừng khuyến nghị ánh xạ sang một mức kèm cảnh báo khi được cung cấp riêng, và không thể kết hợp với thinkingLevel |
stopSequences | string[] | Tối đa năm chuỗi |
responseMimeType | string | Mặc định text/plain; đầu ra schema JSON kiểu cũ yêu cầu application/json |
responseSchema | object | Biến thể schema chính thức; không thể dùng cùng responseJsonSchema |
responseJsonSchema | JSON | JSON Schema; không thể dùng cùng responseSchema |
responseFormat | object | Cấu hình định dạng văn bản; text.mimeType và text.schema tùy chọn. Schema yêu cầu kiểu MIME JSON |
responseModalities | string[] | Chỉ văn bản: TEXT; rỗng nghĩa là văn bản |
mediaResolution | enum | MEDIA_RESOLUTION_UNSPECIFIED, LOW, MEDIUM, HIGH với tiền tố MEDIA_RESOLUTION_ |
seed | integer | Giá trị 32 bit có dấu; hành vi tất định riêng trên mô hình chưa được xác minh |
presencePenalty | number | Trường chung; tác động/phạm vi riêng trên mô hình chưa được xác minh |
frequencyPenalty | number | Trường chung; tác động/phạm vi riêng trên mô hình chưa được xác minh |
responseLogprobs | boolean | Trường chung; khả năng sử dụng riêng trên mô hình chưa được xác minh |
logprobs | integer | 0–20; yêu cầu responseLogprobs: true; hỗ trợ trên mô hình chưa được xác minh |
enableEnhancedCivicAnswers | boolean | Trường chung; hỗ trợ trên mô hình chưa được xác minh |
enableAffectiveDialog | boolean | Trường chung; hỗ trợ trên mô hình chưa được xác minh |
audioTranscriptionConfig | object | Trường chung; các tùy chọn riêng trên mô hình chưa được xác minh |
translationConfig | object | Trường chung; các tùy chọn riêng trên mô hình chưa được xác minh |
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 mọi thông điệp, bao gồm audioMetadata, documentMetadata, spreadsheetMetadata và videoMetadata.contentLayers từ đặc tả khám phá v1beta. Các schema mô tả tham số chính thức; chúng không phải danh sách cho phép yêu cầu của SeedRouter. Trường và giá trị do bên gọi cung cấp được giữ nguyên. Trường được schema chấp nhận không chứng minh mọi tài khoản đều được hỗ trợ. Suy luận minimal không nằm trong các mức được liệt kê. Google cho biết temperature, topP, topK và candidateCount đã ngừng khuyến nghị và nên được loại bỏ; các giá trị lấy mẫu tùy chỉnh nằm trong phạm vi bị bỏ qua và giá trị ngoài phạm vi trả về 400. Nếu gửi trong JSON gốc, chúng vẫn được chuyển nguyên trạng để Gemini API xử lý.
Tạo câu trả lời dài theo từng phần
Một phản hồi Gemini 4 Neon trả về tối đa 65.536 token khi streaming và tối đa 65.536 token khi không streaming. Để đi xa hơn, đặt maxOutputTokens trên 65.536 và tự tiếp tục câu trả lời:
- Gửi yêu cầu. Nếu phản hồi kết thúc với
finishReason: "CONTINUATION", đọccandidates[0].continuationToken. - Gửi lại cùng yêu cầu với giá trị đó trong trường
continuationTokencấp cao nhất. Không nối đầu ra từng phần vàocontents; token mang trạng thái mô hình, bao gồm suy luận. - Lặp lại cho đến khi
finishReasonlàSTOPhoặcMAX_TOKENS. Nếu một lần gọi chạmMAX_TOKENSvà trả vềcontinuationToken, bạn chỉ có thể tiếp tục bằng cách tăngmaxOutputTokens; lặp lại cùng giới hạn sẽ trả về400 INVALID_ARGUMENT.
{
"contents": [{"role": "user", "parts": [{"text": "Generate a complete multi-module migration specification and verification checklist for this payment service."}]}],
"generationConfig": {"thinkingConfig": {"thinkingLevel": "high"}, "maxOutputTokens": 262144},
"continuationToken": "TOKEN_FROM_THE_PREVIOUS_RESPONSE"
}Một phần xử lý dành hoàn toàn cho suy luận có thể trả về văn bản rỗng với CONTINUATION; đó là tiến trình bình thường. Mỗi phần gửi lại prompt của bạn cùng toàn bộ nội dung đã tạo tới lúc đó cho mô hình, nên token đầu vào được đếm lại ở mọi phần sau (trong đó các tiền tố lặp lại đủ điều kiện dùng bộ nhớ đệm ngầm). SeedRouter tính phí mỗi phần như một yêu cầu riêng. Chế độ background phía máy chủ của Interactions API không thuộc endpoint này.
Đầu ra có cấu trúc
{
"contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
"generationConfig": {
"thinkingConfig": {"thinkingLevel": "low"},
"maxOutputTokens": 65536,
"responseMimeType": "application/json",
"responseJsonSchema": {
"type": "object",
"properties": {"ok": {"type": "boolean"}},
"required": ["ok"]
}
}
}Không thể dùng cùng các trường kiểu cũ responseSchema và responseJsonSchema. Cả hai yêu cầu responseMimeType: "application/json". Schema responseFormat.text mới hơn cũng phải chỉ định JSON. Dùng cách viết enum REST (APPLICATION_JSON và TEXT_PLAIN) trong thông điệp đó. Yêu cầu được chuyển nguyên trạng; kiểu MIME đa phương tiện và JSON hàm tùy ý 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ựa chọn hàm nằm trong toolConfig.functionCallingConfig; allowedFunctionNames yêu cầu ANY hoặc VALIDATED và các tên đã khai báo. Không yêu cầu mô hình qua chỉ dẫn hệ thống xuất lời gọi công cụ JSON dưới dạng văn bản thô khi chưa khai báo công cụ, vì điều đó có thể trả về MALFORMED_FUNCTION_CALL.
Ứng dụng của bạn thực thi các hàm được trả về và cung cấp kết quả trong lượt hội thoại tiếp theo. Giữ từng thoughtSignature, lệnh gọi hàm và phản hồi hàm gốc. Không sao chép chữ ký suy luận sang các phần functionCall song song, và không làm tròn định danh số khi tuần tự hóa các đối số hàm không trong suốt.
Google liệt kê Search, Maps, thực thi mã, ngữ cảnh URL, File Search và Computer Use cho Gemini 4 Neon. Tài nguyên File Search yêu cầu quyền truy cập theo thông tin xác thực phục vụ yêu cầu. Cấu hình MCP gốc có trong schema chung, nhưng khả năng sử dụng cho mô hình này chưa được xác lập. Kiểm tra hạn chế chính thức của từng công cụ trước khi kết hợp với đa phương tiện. Khi dùng grounding, Google tính chỉ dẫn công cụ nội bộ và khai báo hàm vào token đầu vào. 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 payload: văn bản, đa phương tiện nội tuyến, tham chiếu tệp, lệnh gọi/phản hồi hàm hoặc phần thực thi. Mục đó cũng có thể mang chữ ký hoặc siêu dữ liệu đa phương tiện (videoMetadata, audioMetadata, documentMetadata, spreadsheetMetadata, mediaResolution, mediaProcessing). Đầ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. Mô hình không tạo hình ảnh hay âm thanh và không có Live API.
Với byte nội tuyến, dùng inlineData.mimeType và data base64. Với tham chiếu tệp, dùng fileData.mimeType và fileUri. URL hợp lệ về 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 startOffset, endOffset, fps dương không lớn hơn 24 và contentLayers. Khả năng hiểu video theo tác nhân được chọn cho từng phần bằng mediaProcessing: "AGENTIC" cạnh fileData hoặc inlineData của video; xử lý tĩnh là mặc định.
Thiết lập an toàn dùng định dạng gốc chính thức và được chuyển qua API nguyên trạng. Trong Playground, cả bốn danh mục phải đặt ở BLOCK_MEDIUM_AND_ABOVE hoặc nghiêm ngặt hơn; ngưỡng thấp hơn chỉ khả dụng qua API.
Phản hồi JSON và streaming
generateContent trả về JSON gốc. streamGenerateContent?alt=sse phát JSON gốc trong sự kiện SSE data:. Các trường quan trọng gồm candidates[].content.parts, finishReason, continuationToken, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId và usageMetadata.
Giữ 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 quá trình tạo đã thất bại hay hoàn tất; kiểm tra kết quả từng phần và hồ sơ tài khoản trước khi gửi yêu cầu khác. Mức sử dụng luồng là lũy kế, vì vậy dùng bộ đếm mới nhất thay vì cộng mọi khối.
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, thay vì bị tính lại như đầu vào không được lưu đệm. Đầu ra tính phí gồm candidatesTokenCount cộng thoughtsTokenCount. Gemini 4 Neon mặc định ở mức suy luận high. Đặt mức rõ ràng khi so sánh mức sử dụng với mô hình khác.
Mô hình này không có bậc giá theo độ dài ngữ cảnh. Giá SeedRouter hiện tại dùng mức giá token Standard; chiết khấu Flex và phụ phí Priority chưa được cấu hình cho tích hợp này. Hỗ trợ các bậc xử lý đó vẫn cần xác minh. Grounding Google Search có thể phát sinh phí theo truy vấn ngoài mức sử dụng token; kiểm tra giá công cụ trước khi bật. Yêu cầu thất bại không bị tính phí. Xem bảng giá trực tiếp.
Nhóm tài khoản
Bậc Default dùng ID mô hình gemini-4-neon không có hậu tố. Các bậc bổ sung dùng gemini-4-neon:GROUP_NAME trong URL. Playground chọn bậc khả dụng; API cũng chấp nhận header được chỉ định rõ:
X-SeedRouter-Group: GROUP_NAMENhóm được chọn quyết định giá và năng lực khả dụng; lựa chọn rõ ràng không âm thầm chuyển sang nhóm khác. Bỏ header hoặc dùng auto để giữ hành vi mặc định của API key.
Kiểm tra các nhóm khả dụng của API key mà không tạo phản hồi:
curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-neon" \
-H "Authorization: Bearer YOUR_SEEDROUTER_KEY"Trạng thái xác minh
Tài liệu chính thức và bản khám phá REST 20261119 đã được kiểm tra vào ngày 20 tháng 11 năm 2026. Vào ngày đó, cơ chế khám phá mô hình chỉ đọc (GET /v1/models), khám phá nhóm (GET /api/seedrouter/llm/groups?model=gemini-4-neon) và bảng giá công khai (GET /v1/pricing) đã xác nhận cả bậc Default gemini-4-neon lẫn bậc chỉ định rõ gemini-4-neon:googlellm-vertext. Ba lệnh gọi kiểm tra nhanh có phí, mỗi lệnh một lần thử, qua api.seedrouter.ai cũng hoàn tất với HTTP 200: tạo JSON với mức suy luận low trên Default (54 token prompt, 28 đầu ra, 39 suy luận), SSE streaming với mức suy luận xhigh trên Default (50 token prompt, 13 đầu ra, 207 suy luận) và lệnh functionCall đã khai báo với mức suy luận low trên gemini-4-neon:googlellm-vertext (95 token prompt, 22 đầu ra, 49 suy luận, trả về thoughtSignature). Chuyển nguyên trạng phần thân gốc và danh sách cho phép trường phản hồi cần triển khai bản dựng backend đã cập nhật. Hiểu đa phương tiện, grounding, Computer Use, tiếp tục/tạo câu trả lời dài, các trường chung khác và các bậc xử lý vẫn chưa được xác minh, và các kiểm tra này không xác lập chất lượng hay độ trễ so sánh.
