Khác biệt tham số và giao thức của Gemini

Tìm hiểu khác biệt tham số và cách dùng mô hình Gemini qua các giao thức tương thích.

Chỉnh suy nghĩ, công cụ, đệm Gemini theo trang này. Cấu trúc: Generate Content, Stream Generate Content, Chat Completions; yêu cầu gốc thường và streaming dùng chung quy tắc.

Mô hình áp dụng

Mô hình	Điểm sử dụng
gemini-4-argon	Mức gốc `LOW/MEDIUM/HIGH`, mặc định `MEDIUM`; chỉ đệm ngầm, đầu ra dài qua tiếp tục
gemini-3.8-flash	Cũng ba mức, mặc định `MEDIUM`, không hỗ trợ `MINIMAL` gốc; đệm ngầm và tường minh
gemini-3.7-flash	Ba mức, mặc định `MEDIUM`, không `MINIMAL` gốc. Google Developer API đã ngừng khuyến nghị để chuyển 3.8; quyết định riêng dịch vụ Google, không có nghĩa nền tảng ngừng hay tự thay

Khác biệt Generate Content

Trường	Khác biệt
`thinkingConfig.thinkingLevel`	Cả ba không thể tắt suy nghĩ bằng `MINIMAL` hoặc ngân sách bằng không kiểu cũ; dùng `LOW` để giảm độ sâu, không áp dụng cách tắt của Gemini 2.5
`thinkingConfig.thinkingBudget`	Mới tích hợp dùng `thinkingLevel`, hai trường loại trừ nhau. Developer API Argon ánh xạ ngân sách cũ riêng lẻ sang mức gần nhất và cảnh báo
`temperature/topP/topK`	Bỏ qua cấu hình lấy mẫu cũ; không cần truyền, không chỉnh được lấy mẫu
`candidateCount`	Gemini 3 trở lên không hỗ trợ, xóa khỏi yêu cầu
`frequencyPenalty/presencePenalty`	Google Cloud 3.7 Flash nói rõ truyền gây lỗi, khác lấy mẫu bỏ qua âm thầm ở trên
`thinkingConfig.includeThoughts`	Bật thì `parts[].thought` phân biệt tóm tắt và câu trả lời; tóm tắt không phải gốc hay thay chữ ký
`parts[].thoughtSignature`	Giữ đầy đủ Parts nguyên trạng; lịch sử công cụ bắt buộc chữ ký. Không gộp khối có/không chữ ký
`functionCall/functionResponse`	Ghép `id`, `name` kết quả hàm với từng gọi thực tế, không thiếu/sai kết quả song song
Điền sẵn model	Không kết thúc bằng model chưa xong; 3.8 còn cần văn bản không rỗng ở user cuối
`maxOutputTokens`	Gồm suy nghĩ/trả lời. REST trực tiếp Argon tối đa `32768` mỗi đoạn thường, `65536` streaming; vượt cần tiếp tục, không chỉ tăng số để trả một lần
`continuationToken`	Chỉ Argon tiếp tục dài ở đây: `CONTINUATION` giữ đầu vào, công cụ, tổng ngân sách và gửi token mới nhất; sau `MAX_TOKENS`, tăng trên token đã dùng. Không thêm đầu ra giữa vào `contents`

Khác biệt Chat Completions

Quy tắc Chat tương thích chính thức Google, không có nghĩa mọi kênh nền tảng chuyển đổi giống nhau.

Trường	Khác biệt
`reasoning_effort`	Mô hình này dùng `low/medium/high`, mặc định `medium`; Argon nhận thêm `minimal`, ánh xạ `low`
`extra_body.google.thinking_config`	Truyền cấu hình Gemini như `thinking_level`, `include_thoughts`; không cùng `reasoning_effort`
`tool_calls[].extra_content`	Giữ `google.thought_signature` cùng toàn bộ lịch sử công cụ; chỉ tên/đối số sẽ mất chữ ký
`response_format`	Hỗ trợ JSON cấu trúc theo tập con Gemini, không mọi hành vi OpenAI. Trường gốc xem Generate Content Reference
Tiếp tục đầu ra dài	Chat tương thích chính thức Google không hỗ trợ tiếp tục dài; dùng Generate Content hoặc Stream Generate Content gốc

Khác biệt bộ nhớ đệm

Trường	Khác biệt
Đệm ngầm định	Mặc định bật, không công tắc; Argon và 3.8 Flash cần tiền tố tối thiểu `4096` token giống nhau, không đảm bảo trúng
`cachedContent`	Argon tạo/tham chiếu đệm tường minh gây lỗi; 3.8 Flash hỗ trợ. 3.7 Flash trên Google Cloud cũng hỗ trợ
Tham chiếu đệm Chat	Lớp Google dùng `extra_body.google.cached_content` tham chiếu đệm gốc, không `prompt_cache_options` OpenAI. Đổi Chat không thêm đệm tường minh cho Argon
Mức sử dụng đệm	Xem `usageMetadata.cachedContentTokenCount` gốc để xác nhận trúng, không chỉ bật cấu hình

Khác biệt đầu vào đa phương tiện

Đầu vào	Khối giao thức	Khác biệt
Hình ảnh	`inlineData` gốc	Dùng Base64 kèm `mimeType` đúng
Tệp	`fileData` gốc	Ảnh, âm thanh, video, PDF: URI máy chủ đọc được, không đường dẫn cục bộ; tham chiếu Files từ dịch vụ tương ứng
Hình ảnh	Chat `image_url`	URL ảnh hỗ trợ hoặc Base64 Data URL, không cấu trúc Parts gốc
Âm thanh	Chat `input_audio`	Ví dụ chính thức dùng âm thanh Base64 và `format`, không cấu hình sinh âm thanh

Trường	Khác biệt
`mediaResolution`	Điều chỉnh độ chính xác xử lý đầu vào; cấu trúc cấp yêu cầu và Part riêng, riêng lẻ ưu tiên toàn cục. Không phải độ phân giải ảnh đầu ra
`responseModalities`	Cả ba chỉ xuất văn bản, dùng `TEXT`; `IMAGE/AUDIO`, `imageConfig`, `speechConfig` Schema chung không dùng sinh ảnh/giọng cho chúng

Ví dụ gọi

Thay MODEL_ID bằng ID đầy đủ; cả hai ví dụ dùng mức trung bình, ngân sách rõ, không tự tiếp tục.

curl 'https://api.agtcloud.ai/v1beta/models/MODEL_ID:generateContent' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "contents": [{"role": "user", "parts": [{"text": "Giải thích cách xử lý thời gian chờ API bằng ba ý"}]}],
    "generationConfig": {
      "thinkingConfig": {"thinkingLevel": "MEDIUM"},
      "maxOutputTokens": 32768
    }
  }'