Google DeepMind Thay Đổi Gemini API Mặc Định, Developer Cần Làm Gì Ngay?

Nếu bạn đang dùng Gemini API trong dự án, có một thay đổi lớn bạn không thể bỏ qua. Google DeepMind vừa đưa Interactions API thành giao diện mặc định cho Gemini từ tháng 6/2026, thay thế hoàn toàn generateContent API cũ.

Chuyện Gì Đã Xảy Ra?

Google DeepMind chính thức chuyển Interactions API thành giao diện mặc định cho Gemini vào tháng 6/2026. Đây không phải cập nhật nhỏ, đây là thay đổi kiến trúc cốt lõi. generateContent API từng là lựa chọn mặc định nay đã bị thay thế hoàn toàn.

Breaking changes đã có hiệu lực từ tháng 5 đến 6/2026. Schema cũ bị xóa ngày 8 tháng 6. Nếu bạn còn dùng Python SDK 1.x.x hoặc JS SDK 1.x.x, chúng đã ngừng hoạt động sau mốc đó.

Interactions API Khác Gì generateContent?

Thay vì trả về raw JSON responses như trước, Interactions API dùng "typed steps", tức là mỗi bước trong luồng xử lý được định nghĩa rõ ràng về kiểu dữ liệu. Hai điểm thay đổi quan trọng nhất bạn cần biết:

• Schema mới: outputs đã đổi thành steps
• response_format giờ là mặc định từ tháng 5 đến 6/2026

API này được thiết kế cho agentic workflows và server-side state management. Thay vì bạn tự quản lý trạng thái hội thoại phía client, Gemini xử lý ở phía server.

Khi Nào Dùng Interactions API?

Interactions API phù hợp với bạn nếu bạn đang xây dựng:

• Dự án mới từ đầu với Gemini
• Ứng dụng agentic, tức là AI tự quyết định và thực hiện nhiều bước liên tiếp
• Hệ thống cần quản lý hội thoại phía server
• App multi-modal multi-turn, ví dụ kết hợp text, hình ảnh, nhiều lượt trao đổi

Khi Nào Nên Giữ generateContent?

Bạn có thể giữ generateContent API nếu:

• Bạn có integration đang chạy ổn định và không muốn rủi ro downtime
• Dự án cần Batch API để xử lý khối lượng lớn
• Bạn cần explicit caching với kiểm soát thủ công

Lưu ý quan trọng: Interactions API vẫn đang ở giai đoạn beta. API có thể còn thay đổi, edge cases có thể xuất hiện trong môi trường production.

Bạn Cần Làm Gì Ngay Hôm Nay?

Ba bước bạn nên thực hiện ngay:

Bước 1: Kiểm tra phiên bản SDK bạn đang dùng. Python hoặc JS SDK ở version 1.x.x đã không còn hoạt động sau ngày 8/6/2026.

Bước 2: Nếu bạn có code dùng schema cũ với outputs, đổi sang steps theo schema mới của Interactions API.

Bước 3: Đánh giá xem dự án của bạn thuộc loại nào, agentic và server-side state thì migrate sang Interactions API, còn batch processing và explicit caching thì có thể giữ generateContent.

Bạn đang dùng Gemini API cho dự án nào, và bạn đã migrate sang Interactions API chưa?

#GeminiAPI #GoogleDeepMind #AIAgents #LLMDev #VibeAICoder