Gemini Decision vs Gemini Decision 1: Một cái là tên, một cái là ID mô hình

Tìm kiếm Gemini Decision và bạn sẽ thấy bài đưa tin ra mắt, một mục trên bảng xếp hạng, một dòng giá và tài liệu tham chiếu API, tất cả đều dùng những từ hơi khác nhau cho cùng một thứ. Tìm kiếm Gemini Decision 1 và bạn sẽ thấy model id thực sự hoạt động. Hai chuỗi chỉ khác nhau một ký tự và hành xử hoàn toàn khác nhau trong mã: một chuỗi là cách mọi người gọi sản phẩm, còn chuỗi kia là giá trị duy nhất mà POST /v1beta/decisions sẽ chấp nhận. Nếu bạn đã dành cả một buổi chiều cho lỗi 404 và tự hỏi tại sao một model rõ ràng tồn tại lại không thể được tìm thấy, thì đây chính là bài viết đã có thể giúp bạn tránh được điều đó.

The confusion is not anyone's mistake in particular. G​oogle shipped a model, an endpoint and a family name in the same release on 11 November 2026, and the natural way to write about all three is to shorten them. The shortening works in prose and fails in a request body, and the gap between those two facts is where most of the support tickets in this category will come from over the next month.

Hai tên này phân giải thành gì

Hãy bắt đầu với việc ánh xạ, vì mọi thứ khác đều suy ra từ đó.

• Gemini Decision — a product name. It refers to the decision-model line, and in G​oogle's own documentation it appears as the family label in prose, in the model card heading, and in sentences like "available with G​emini Decision only". It is not a model id, there is no alias behind it, and passing it as model returns an unknown-model error rather than falling back to the newest member of the family.

• Gemini Decision 1 — the model, and the id gemini-decision-1. This is the value that works. It is the only model the Decisions API serves, and the documentation says so explicitly: the endpoint is available with G​emini Decision 1 only.

Two names, one model, and no alias between them. That last part is the unusual bit. Most G​oogle model families offer a moving alias and a pinned id — a -latest form for prototypes and a dated or numbered form for production. This one offers only the pinned form, so any code path built on the assumption that families have a floating head will fail here rather than silently tracking a new version.

Nơi tên thứ hai cứ liên tục xuất hiện

Lý do sự mơ hồ này vẫn dai dẳng là vì ba hệ thống riêng biệt mô tả mô hình này và không hệ thống nào trong số chúng dùng chung một quy ước đặt tên.

Trang định giá liệt kê nó dưới chính tên của mô hình, cùng với một mức giá và ghi chú rằng đầu ra không áp dụng. Tài liệu tham chiếu API mô tả endpoint và nêu tên mô hình trong câu về tính khả dụng thay vì trong bảng mô hình. Bảng xếp hạng độc lập đánh giá nó sử dụng tên dễ đọc trong hàng của bảng và trong biểu đồ. Không cái nào trong số này là sai, và không cái nào trong số chúng là model id, nên sao chép từ bất kỳ cái nào trong số đó vào body của yêu cầu sẽ tạo ra cùng một lỗi.

Có một nguồn biến thiên thứ tư sẽ càng trở nên quan trọng hơn khi thời gian trôi qua: cách viết của người khác. Các bài đưa tin ra mắt, hướng dẫn và câu trả lời trên diễn đàn đều rút gọn tên, và một số còn rút gọn nó thành thứ trông giống như một id — viết thường, có gạch nối, có vẻ hợp lý. Cách khắc phục là đừng tin bất kỳ cái nào trong số đó. Hãy hỏi endpoint.

Cách kiểm tra xem một key nhất định thực sự có thể gọi được những gì

Trước khi viết yêu cầu, hãy liệt kê các mô hình mà khóa được phép sử dụng. Lệnh gọi list-models tiêu chuẩn trên Generative Language API trả về các mô hình có sẵn cho dự án của bạn cùng với id của chúng, và chỉ cần chạy lệnh này một lần là giải quyết dứt điểm vấn đề đó cho khóa ấy.

Nếu gemini-decision-1 xuất hiện, bạn có quyền truy cập và chính chuỗi đó là thứ cần đưa vào yêu cầu. Nếu nó không xuất hiện, vấn đề là quyền sử dụng hoặc khu vực chứ không phải chính tả, và đổi tên bao nhiêu cũng không giúp ích. Điều bạn sẽ không thấy trong danh sách đó là một mục có tên gemini-decision, vì không có mô hình như vậy.

Kiểm tra thứ hai nằm ở phản hồi. Một phản hồi quyết định thành công cho biết mô hình nào đã phục vụ nó, vì vậy một pipeline ghi lại trường model cùng với request id của chính nó có thể trả lời "mô hình nào đã tạo ra câu trả lời này" sau nhiều tháng mà không cần đọc lại cấu hình. Nghe có vẻ chỉ là việc dọn dẹp nội bộ cho đến lần đầu tiên có người hỏi vì sao một quyết định thay đổi, và câu trả lời thật thà là do một alias đã được di chuyển.

Ba sai lầm mà sự mơ hồ này thực sự gây ra

• Lỗi 404 mô hình không xác định. Lỗi hiển nhiên. gemini-decision trong phần thân yêu cầu trả về một lỗi trông giống như vấn đề quyền truy cập nhưng không phải vậy. Nếu lỗi đề cập đến mô hình thay vì dự án, hãy kiểm tra chuỗi trước khi kiểm tra tài khoản thanh toán.

• Giả định ngầm về bí danh. Khó phát hiện hơn. Một nhóm đã tiếp thu các quy ước -latest sẽ viết một cấu hình với tên nhóm và một bước phân giải, và bước phân giải lặng lẽ trả về nguyên văn tên nhóm khi không có bí danh nào tồn tại. Sự cố sau đó xuất hiện ở yêu cầu thực tế đầu tiên thay vì khi triển khai, thời điểm tồi tệ nhất có thể đối với nó.

• Giả định sai về endpoint. Tinh tế hơn nữa, vì mô hình tồn tại và tên đúng: gemini-decision-1 gửi đến một endpoint generate-content thông thường vẫn thất bại. Mô hình hoàn toàn không thể gọi theo cách đó. Nó là một đích chỉ xác suất trên endpoint decisions, và một yêu cầu đòi nó viết văn xuôi là đang đòi hỏi điều nó không tạo ra. Bất kỳ thư viện client nào mặc định dùng chat completions sẽ cần một đường dẫn rõ ràng.

Điều này nói lên điều gì về mô hình, chứ không chỉ là tên của nó

Cách đặt tên chỉ là triệu chứng của quyết định thiết kế thực sự, đó là đây không phải một mô hình trò chuyện với định dạng đầu ra khác. Mô hình trò chuyện trả về văn bản, nên id của nó có thể được hoán đổi tự do giữa các nhà cung cấp, proxy và gateway đều dùng cùng một schema. Một mô hình trả về xác suất đã hiệu chỉnh cho các câu hỏi có kiểu do bạn tự định nghĩa thì không có schema chung như vậy, và id được gắn với một endpoint với một dạng yêu cầu.

Đó là lý do tại sao dòng họ này chưa có bí danh động và chưa có thành viên thứ hai: không có gì để tương thích với. Điều đó cũng giải thích tại sao mô hình không thể chỉ đơn giản được thêm vào một bộ định tuyến đa dụng. OrcaRouter không có gemini-decision-1, vì một endpoint chỉ trả xác suất không phải là mục tiêu chat-completions, và đặt nó sau một khóa sử dụng schema đó sẽ là một lời hứa mà lớp định tuyến không thể giữ. Thứ chúng tôi thực sự có trong không gian quyết định là typesafe/jev-1.14 của TypeSafe, một mô hình quyết định có thể gọi được qua cùng giao diện như mọi thứ khác trong danh mục.

Phần của một pipeline quyết định mà bộ định tuyến thực sự đảm nhiệm là nửa soạn thảo — lệnh gọi tạo sinh tạo ra câu trả lời ứng viên hoặc rubric mà bộ chấm điểm sau đó đánh giá. Lệnh gọi đó chạy trên hơn 200 mô hình qua một endpoint, với giá niêm yết của nhà cung cấp được chuyển nguyên với mức markup 0%, và đây là lệnh gọi mà ở đó việc hoán đổi nhà cung cấp là một thay đổi cấu hình chứ không phải viết lại. Ngược lại, lệnh gọi chấm điểm được gắn với một endpoint theo thiết kế, và một kiến trúc trung thực coi đó là một phụ thuộc cố định chứ không phải thứ gì đó để định tuyến vòng qua.

Nếu bạn đang chọn giữa hai chuỗi trên một biểu mẫu

There is a version of this question that is not about identifiers at all, and it is worth answering directly because the phrasing invites it: someone comparing "G​emini Decision" with "G​emini Decision 1" may believe they are looking at two products, an older one and a newer one, and want to know which to adopt. There is only one. Nothing called G​emini Decision shipped before G​emini Decision 1, and the shorter name is the family label for a family that currently has a single member.

Hệ quả thực tế là bất kỳ bảng so sánh, bài đánh giá hay benchmark nào bạn tìm thấy mà liệt kê cả hai như hai mục riêng biệt đều đang mô tả cùng một mẫu xe hai lần. Hai dòng, một mẫu, một mức giá. Nếu hai dòng đó mâu thuẫn với nhau về một con số, thì một trong hai đã lỗi thời chứ không phải là đang đo một thứ khác.

Điểm mấu chốt

Use gemini-decision-1 in every request body, endpoint path and config value, and use "G​emini Decision" only where a human reads it. There is no alias to fall back on, no second model hiding behind the shorter name, and no chat-completions path to the longer one. The cost of getting this wrong is small — one 404, one confused afternoon — but the cost of assuming an alias exists is larger, because that mistake survives review and fails in production. Pin the id, log the model the response names, and treat the family name as prose.