Cách thêm Gemini 2.5 Pro vào Cursor miễn phí

Gemini 2.5 Pro đại diện cho sự tiến bộ mới nhất của Google trong trí tuệ nhân tạo, thể hiện những cải tiến đáng kể trong khả năng suy diễn và lập trình. Mô hình tiên tiến này cung cấp cho các nhà phát triển năng suất cao hơn và quy trình lập trình được tinh gọn ngay trong môi trường IDE của họ. Bằng cách tích hợp Gemini 2.5 Pro vào Cursor, bạn sẽ có quyền truy cập vào quá trình tạo mã hiệu quả hơn, gợi ý thông minh và khả năng giải quyết vấn đề được cải thiện mà không phải trả bất kỳ phí đăng ký nào.

Mô hình xuất sắc trong việc hiểu các mẫu lập trình phức tạp, gỡ lỗi các vấn đề và cung cấp những giải thích toàn diện cho các khái niệm kỹ thuật. Khác với các phiên bản trước, Gemini 2.5 Pro thể hiện nhận thức ngữ cảnh tuyệt vời, cho phép nó duy trì tính mạch lạc trong các phiên lập trình dài. Khả năng phân tích và tạo mã ở nhiều ngôn ngữ lập trình khiến nó trở thành một công cụ vô giá cho các nhà phát triển làm việc trên những dự án đa dạng.

Mặc dù Cursor cung cấp một đăng ký cao cấp bao gồm quyền truy cập vào nhiều mô hình AI khác nhau, nhưng hướng dẫn này tập trung cụ thể vào việc thêm Gemini 2.5 Pro vào cài đặt Cursor của bạn mà không phát sinh thêm chi phí nào. Bằng cách tận dụng API miễn phí của Google, bạn có thể trải nghiệm đầy đủ khả năng của mô hình tiên tiến này trong môi trường phát triển ưa thích của bạn.

Là một người dùng Cursor AI IDE đã sử dụng các công cụ phát triển tiên tiến, bạn sẽ thấy cách tiếp cận mạnh mẽ của Apidog đối với phát triển API thật đáng giá.

Thay thế hoàn chỉnh cho Postman kết hợp thiết kế API, thử nghiệm, tài liệu và hợp tác trong một giao diện mượt mà mà bổ sung cho quy trình làm việc của bạn trong Cursor.

Khi Cursor nâng cao trải nghiệm lập trình của bạn với sự trợ giúp của AI, Apidog đơn giản hóa quá trình quản lý vòng đời API với những tính năng như máy chủ mô phỏng tự động, xây dựng yêu cầu trực quan và chuyển đổi môi trường một cách liền mạch.

Nền tảng hỗ trợ các giao thức REST, GraphQL, WebSocket và SOAP, khiến nó trở thành bạn đồng hành hoàn hảo với Cursor khi xây dựng các ứng dụng phụ thuộc vào API. Cùng nhau, những công cụ hiện đại này tạo ra một hệ sinh thái phát triển tối đa hóa năng suất trong khi giảm thiểu việc chuyển đổi ngữ cảnh giữa các dự án của bạn.

Hướng dẫn từng bước thêm Gemini 2.5 Pro vào Cursor

Bước 1: Truy cập Cài đặt Cursor

Bước đầu tiên trong quá trình tích hợp là truy cập bảng điều khiển cài đặt của Cursor, nơi quản lý tất cả các tùy chọn cấu hình. Phương pháp sẽ hơi khác nhau tùy thuộc vào hệ điều hành của bạn:

Đối với macOS:

1. Mở ứng dụng Cursor từ thư mục Ứng dụng hoặc dock của bạn
2. Nhấp vào menu "Cursor" trong thanh ứng dụng ở trên cùng màn hình của bạn
3. Chọn "Cài đặt" từ menu xổ xuống
4. Chọn "Cài đặt Cursor" từ các tùy chọn tiếp theo

Đối với Windows/Linux:

1. Mở Cursor từ menu Bắt đầu, biểu tượng trên desktop, hoặc trình khởi chạy ứng dụng
2. Nhấp vào menu "Tệp" ở góc trên bên trái của cửa sổ ứng dụng
3. Chọn "Tùy chọn" từ menu xổ xuống
4. Nhấp vào "Cài đặt" từ submenu xuất hiện

Điều này sẽ mở bảng cài đặt nơi bạn có thể cấu hình nhiều khía cạnh của IDE Cursor. Bảng điều khiển thường xuất hiện như một tab mới trong giao diện của trình soạn thảo, cho phép bạn duy trì không gian làm việc trong khi thực hiện các điều chỉnh.

Bước 2: Điều hướng đến phần Mô hình hoặc Tiện ích mở rộng

Khi ở trong bảng cài đặt, bạn sẽ cần tìm phần cụ thể quản lý cấu hình mô hình AI:

1. Tìm kiếm menu điều hướng ở phía bên trái của bảng cài đặt
2. Cuộn qua các danh mục có sẵn để tìm một danh mục có liên quan đến chức năng AI
3. Phần này có thể được gán nhãn là "Mô hình," "Nhà cung cấp AI," "Tiện ích mở rộng," hoặc "Cấu hình AI"
4. Trong các phiên bản mới hơn của Cursor, bạn có thể tìm thấy nó dưới "Cài đặt AI" hoặc "Mô hình ngôn ngữ"
5. Nhấp vào phần này để truy cập giao diện quản lý mô hình

Cách gán nhãn chính xác có thể thay đổi tùy theo phiên bản Cursor của bạn, nhưng các cài đặt liên quan đến AI thường được nhóm lại với nhau để dễ dàng truy cập. Nếu bạn gặp khó khăn khi tìm kiếm phần chính xác, bạn có thể sử dụng chức năng tìm kiếm ở đầu bảng cài đặt bằng cách nhập từ khóa như "mô hình" hoặc "AI" để lọc các tùy chọn liên quan.

Bước 3: Hiểu đúng tên mô hình

Khi cấu hình Gemini 2.5 Pro trong Cursor, việc sử dụng đúng mã định danh mô hình là quan trọng cho việc tích hợp thành công. Mã định danh mô hình chính xác cho Gemini 2.5 Pro Experimental là:

gemini-2.5-pro-exp-03-25

Chuỗi này cần được nhập chính xác như được chỉ ra, bao gồm tất cả các dấu nối và số. Bất kỳ sự sai lệch nào, ngay cả những khác biệt nhỏ trong chính tả hoặc thay đổi chữ hoa chữ thường, có thể ngăn cản việc kết nối hoạt động đúng cách. Mã định danh mô hình phục vụ như là tham chiếu duy nhất cho phép Cursor giao tiếp với phiên bản cụ thể của Gemini mà bạn muốn sử dụng.

Google đôi khi cập nhật các phiên bản mô hình của họ, vì vậy nếu bạn gặp vấn đề kết nối, hãy xác nhận mã định danh mô hình cập nhật nhất trên trang tài liệu của Google AI Studio. Tuy nhiên, tính đến thời điểm viết, mã định danh được cung cấp ở trên là chính xác để truy cập vào khả năng thử nghiệm của Gemini 2.5 Pro.

Bước 4: Lấy khóa API Google (Phương pháp Trực tiếp)

Để kết nối Cursor với Gemini 2.5 Pro, bạn sẽ cần một khóa API từ Google. Khóa này xác thực các yêu cầu của bạn tới dịch vụ AI của Google. Làm theo các bước chi tiết này để lấy khóa của bạn:

1. Mở trình duyệt web của bạn và truy cập Google AI Studio:

• URL chính: https://aistudio.google.com/
• URL thay thế nếu URL trên không hoạt động: https://ai.google.dev/

2. Đăng nhập bằng tài khoản Google của bạn

• Nếu bạn chưa có tài khoản Google, bạn cần phải tạo một tài khoản trước
• Bất kỳ tài khoản Google tiêu chuẩn nào cũng sẽ hoạt động, bao gồm cả tài khoản Gmail

3. Sau khi đăng nhập, hãy tìm tùy chọn "Nhận khóa API"

• Thường thì nó nằm ở góc trên bên trái của giao diện
• Nó cũng có thể xuất hiện dưới dạng "Khóa API" trong menu bên hoặc trong cài đặt tài khoản

4. Nhấp vào "Nhận khóa API" và chọn "Tạo khóa API" từ các tùy chọn được trình bày

• Bạn có thể được yêu cầu chọn "Tạo trong dự án mới" nếu được nhắc, đặc biệt nếu đây là lần đầu tiên bạn sử dụng Google AI Studio
• Một số người dùng có thể được yêu cầu xác minh danh tính bằng số điện thoại vì lý do bảo mật.

• Hệ thống sẽ tạo một khóa API duy nhất cho tài khoản của bạn. Việc này có thể mất vài giây để hoàn tất

5. Sao chép khóa API mới được tạo của bạn và lưu nó an toàn

• Xem xét việc lưu tạm thời trong một trình quản lý mật khẩu hoặc ứng dụng ghi chú an toàn
• Bạn sẽ cần dán khóa này vào Cursor ngay thôi

LƯU Ý BẢO MẬT QUAN TRỌNG:

• Không bao giờ chia sẻ khóa này hoặc cam kết nó với các hệ thống kiểm soát phiên bản như GitHub
• Khóa này cấp quyền truy cập vào các tài nguyên Google Cloud của bạn và có thể có giới hạn sử dụng
• Nếu khóa của bạn bị xâm phạm, hãy ngay lập tức thu hồi nó và tạo khóa mới
• Google cung cấp một tầng miễn phí cho quyền truy cập API, nhưng việc sử dụng quá mức có thể phát sinh phí

Định dạng khóa API của Google thường giống như một chuỗi dài các chữ cái, số và ký hiệu. Khi bạn đã bảo vệ được khóa của mình, bạn đã sẵn sàng tiến hành cấu hình Cursor.

Bước 5: Thêm mô hình tùy chỉnh trong Cursor

Với khóa API trong tay, hãy quay lại bảng cài đặt Cursor để cấu hình mô hình tùy chỉnh:

1. Trong phần cài đặt liên quan đến AI mà bạn đã xác định ở Bước 2, hãy kiểm tra giao diện để tìm các tùy chọn liên quan đến việc thêm hoặc tùy chỉnh các mô hình
2. Tìm kiếm cụ thể các tùy chọn như:

• "Nhà cung cấp tùy chỉnh"
• "Thêm Mô hình"
• "Cấu hình Mô hình tùy chỉnh"
• "Ghi đè URL Cơ bản của OpenAI"

1. Nếu bạn thấy nút có nhãn "Thêm" hoặc "+" gần danh sách mô hình nào đó, hãy nhấp để bắt đầu thêm cấu hình mô hình mới
2. Nếu bạn thấy "Ghi đè URL Cơ bản của OpenAI," điều này đặc biệt quan trọng

• Điều này cho thấy Cursor chủ yếu hoạt động với các API tương thích với OpenAI
• Bạn sẽ cần điều chỉnh cài đặt này để làm việc với API Gemini của Google
• Không phải tất cả các phiên bản của Cursor đều gán nhãn chức năng này giống nhau

Giao diện để thêm các mô hình tùy chỉnh có chút khác nhau giữa các phiên bản Cursor, nhưng chức năng cốt lõi vẫn giữ nguyên: bạn cần cung cấp chi tiết kết nối cho mô hình Gemini.

Bước 6: Nhập tên mô hình

Khi bạn đã tìm được phần thích hợp để thêm mô hình tùy chỉnh:

1. Tìm kiếm một trường có nhãn "Tên mô hình," "ID mô hình," hoặc điều gì đó tương tự
2. Nhấp vào trường này để kích hoạt nó cho việc nhập văn bản
3. Nhập chính xác: gemini-2.5-pro-exp-03-25
4. Kiểm tra kỹ phần nhập của bạn cho:

• Chính tả đúng của "gemini"
• Tất cả các dấu nối ở vị trí chính xác
• Chuỗi số chính xác "2.5" và "03-25"
• Không có khoảng trắng bổ sung trước hoặc sau định danh

Định danh chính xác này đảm bảo rằng Cursor yêu cầu đúng phiên bản mô hình từ dịch vụ API của Google. Bất kỳ lỗi nào trong chuỗi này sẽ dẫn đến kết nối thất bại hoặc hành vi không mong muốn.

Bước 7: Ghi đè URL Cơ bản của OpenAI

Nhiều trình biên soạn mã AI, bao gồm cả Cursor, ban đầu được thiết kế để hoạt động chủ yếu với các mô hình của OpenAI. Để sử dụng các mô hình Gemini của Google, bạn cần định hướng các yêu cầu này đến điểm cuối API của Google:

Tìm cài đặt để ghi đè URL cơ bản OpenAI mặc định

• Có thể được gán nhãn là "URL Cơ bản API," "Điểm cuối," hoặc "URL Tương thích OpenAI"
• Nó có thể xuất hiện dưới dạng một trường văn bản gần nơi bạn đã nhập tên mô hình

Nhập URL sau cho API Gemini trong ngữ cảnh tương thích với OpenAI:

<https://generativelanguage.googleapis.com/v1beta/openai/>

Đảm bảo rằng URL được nhập chính xác như được chỉ ra, bao gồm dấu gạch chéo ở cuối

• Điểm cuối này cho phép Cursor giao tiếp với dịch vụ API của Google bằng các định dạng mà nó đã hiểu

Một số phiên bản của Cursor có thể có menu thả xuống để chọn "Google" làm nhà cung cấp thay thế

• Nếu tùy chọn này có sẵn, hãy chọn nó thay vì nhập URL bằng tay
• Điều này cho thấy phiên bản Cursor của bạn đã có hỗ trợ gốc cho các dịch vụ của Google

Sự định hướng URL này rất quan trọng vì nó cho biết Cursor cần gửi các yêu cầu API của nó ở đâu. Nếu không có thay đổi này, Cursor sẽ cố gắng yêu cầu mô hình Gemini từ máy chủ của OpenAI, điều này sẽ thất bại.

Bước 8: Nhập Khóa API Google

Tiếp theo, bạn sẽ cần cung cấp khóa API Google của mình để xác thực các yêu cầu:

1. Tìm một trường có nhãn "Khóa API," "Khóa API Google," hoặc "Mã xác thực"

• Trường này có thể ở phần tương tự như tên mô hình và URL cơ bản
• Trong một số phiên bản, nó có thể dưới phần "Khóa API" riêng

1. Nhấp vào trường này để kích hoạt nó cho việc nhập văn bản
2. Cẩn thận dán khóa API mà bạn đã nhận từ Google AI Studio ở Bước 4

• Sử dụng Ctrl+V (Windows/Linux) hoặc Cmd+V (Mac) để dán khóa
• Hoặc, nhấp chuột phải và chọn "Dán" nếu phím tắt không được kích hoạt

1. Xác minh rằng toàn bộ khóa đã được dán chính xác

• Đảm bảo rằng không có khoảng trắng bổ sung ở đầu hoặc cuối
• Kiểm tra rằng không có ký tự nào bị thiếu hoặc bị trùng lặp
• Khóa nên khớp chính xác với những gì Google đã cung cấp

1. Một số phiên bản của Cursor có thể cung cấp tùy chọn "Kiểm tra Kết nối" sau khi nhập khóa

• Nếu có sẵn, hãy sử dụng tính năng này để xác minh rằng cấu hình của bạn hoạt động
• Một bài kiểm tra thành công sẽ xác nhận rằng tất cả các chi tiết đều chính xác

Khóa API này phục vụ như là thông tin xác thực của bạn và là yêu cầu cho mỗi yêu cầu mà Cursor thực hiện đến dịch vụ Gemini. Nếu không có khóa hợp lệ, việc tích hợp sẽ thất bại ngay cả khi tất cả các cài đặt khác đều đúng.

Bước 9: Lưu Cài đặt

Sau khi nhập tất cả thông tin cần thiết, bạn cần lưu cấu hình của bạn:

1. Tìm nút "Lưu," "Áp dụng," hoặc "OK" ở phía dưới bảng cài đặt

• Trong một số phiên bản, các thay đổi có thể được lưu tự động khi bạn thực hiện chúng
• Nếu lưu tự động được kích hoạt, bạn có thể thấy một chỉ báo cho thấy "Đang lưu..." hoặc "Thay đổi đã được lưu"

2. Nhấp vào nút lưu để cam kết các thay đổi của bạn

• Bảng cài đặt có thể hiển thị một chỉ báo tải trong thời gian ngắn trong khi áp dụng các thay đổi
• Một số phiên bản có thể yêu cầu khởi động lại Cursor để thực hiện đầy đủ cấu hình mới

3. Nếu được nhắc khởi động lại Cursor để thay đổi có hiệu lực, hãy chọn "Khởi động lại ngay"

• Điều này đảm bảo tất cả các thành phần của Cursor nhận ra cấu hình mới
• Công việc của bạn nên được tự động lưu trước khi khởi động lại

4. Sau khi lưu (và khởi động lại nếu cần), Cursor sẽ tải với cấu hình mới của bạn

• Mô hình Gemini 2.5 Pro giờ đây nên có sẵn để sử dụng trong trình soạn thảo

Sự lưu chính xác của các cài đặt là rất cần thiết cho cấu hình bền vững. Nếu không có bước này, các thay đổi của bạn có thể bị mất khi bạn đóng và mở lại Cursor.

Bước 10: Kiểm tra tích hợp

Bước cuối cùng là xác minh rằng tích hợp Gemini 2.5 Pro của bạn hoạt động đúng:

1. Mở hoặc tạo một tệp mã trong IDE Cursor

• Bất kỳ ngôn ngữ lập trình nào cũng sẽ hoạt động để kiểm tra, nhưng Python hoặc JavaScript là những lựa chọn tốt do tính phổ biến của chúng

2. Tìm giao diện trợ lý AI trong Cursor

• Nó thường có sẵn dưới dạng bảng trò chuyện ở bên phải
• Hoặc như một bảng lệnh có thể được kích hoạt bằng các phím tắt

3. Hãy thử sử dụng các tính năng được hỗ trợ bởi AI:

• Hoàn thành mã: Bắt đầu nhập một hàm hoặc khai báo biến và xem xem Gemini có cung cấp gợi ý không
• Tương tác trò chuyện: Mở bảng trò chuyện và đặt một câu hỏi lập trình
• Gọi lệnh: Sử dụng Ctrl/Cmd + K để gọi các chức năng AI trực tiếp

4. Nếu Cursor cung cấp tùy chọn để chọn mô hình AI nào để sử dụng, hãy đảm bảo "gemini-2.5-pro-exp-03-25" có sẵn và chọn nó

• Tùy chọn này có thể có sẵn dưới dạng menu thả xuống trong giao diện trò chuyện
• Hoặc như một tùy chọn trong bảng lệnh

5. Gửi một gợi ý thử nghiệm như "Viết một hàm để tính toán dãy Fibonacci trong Python"

• Quan sát chất lượng phản hồi, độ chính xác của mã và độ rõ ràng của giải thích
• Một Gemini 2.5 Pro hoạt động tốt sẽ cung cấp mã có cấu trúc tốt với các giải thích chi tiết

Nếu mô hình phản hồi phù hợp với các gợi ý của bạn, chúc mừng bạn! Bạn đã thành công trong việc tích hợp Gemini 2.5 Pro với Cursor miễn phí.

Phương pháp thay thế: Sử dụng OpenRouter (Có thể miễn phí)

Nếu bạn gặp khó khăn với phương pháp khóa API trực tiếp, bạn có thể tận dụng OpenRouter như một nền tảng trung gian giúp đơn giản hóa việc kết nối với các mô hình AI khác nhau, bao gồm cả Gemini 2.5 Pro.

Bước 1: Thiết lập OpenRouter

1. Truy cập trang web OpenRouter: https://openrouter.ai/
2. Tạo một tài khoản và đăng nhập

• Thông thường, bạn có thể đăng ký bằng Google, GitHub hoặc xác thực qua email
• Hoàn thành bất kỳ bước xác minh nào cần thiết trong quá trình tạo tài khoản

3. Điều hướng đến bảng điều khiển của bạn sau khi đăng nhập

• Tìm phần "Khóa API" hoặc "Thông tin xác thực"
• Nhấp vào "Tạo Khóa API" hoặc một tùy chọn tương tự

4. Đặt tên cho khóa API của bạn thành điều gì đó dễ nhớ như "Tích hợp Cursor"

• Điều này giúp bạn xác định mục đích của khóa này trong tương lai

5. Đặt bất kỳ hạn chế sử dụng nào nếu muốn

• OpenRouter cho phép bạn giới hạn mức chi tiêu của mỗi khóa
• Đối với các dự án cá nhân, nên đặt giới hạn thấp để tránh các khoản phí không mong muốn

6. Tạo và sao chép khóa API OpenRouter của bạn

• Lưu trữ nó an toàn như cách bạn đã làm với khóa API Google trực tiếp

Bước 2: Cấu hình Cursor với OpenRouter

Truy cập cài đặt Cursor như đã mô tả ở Bước 1 của phương pháp trực tiếp

Điều hướng đến phần cho các mô hình tùy chỉnh hoặc khóa API

• Đây là cùng một phần mà bạn sẽ sử dụng cho phương pháp API Google trực tiếp

Kích hoạt tùy chọn "Ghi đè URL Cơ bản của OpenAI"

• Điều này rất quan trọng để định hướng các yêu cầu qua OpenRouter

Nhập khóa API OpenRouter của bạn vào trường thích hợp

• Điều này thay thế khóa API Google mà bạn đã sử dụng trong phương pháp trực tiếp

Đặt điểm cuối/API tùy chỉnh/URL cơ bản thành:

<https://openrouter.ai/api/v1>

Khi thêm mô hình tùy chỉnh, nhập:

google/gemini-2.5-pro-exp-03-25:free

(Ghi chú: Xác minh mã định danh mô hình chính xác này trên trang web OpenRouter vì nó có thể thay đổi)

Lưu các cài đặt như đã mô tả ở Bước 9 của phương pháp trực tiếp

Kiểm tra tích hợp như đã mô tả trong Bước 10

• Gửi một gợi ý thử nghiệm để xác minh rằng kết nối hoạt động
• Kiểm tra xem các phản hồi có khớp với chất lượng mong đợi của Gemini 2.5 Pro không

Phương pháp OpenRouter có một số lợi ích so với cách tiếp cận trực tiếp:

• Quản lý API đơn giản hóa
• Khả năng giảm chi phí thông qua các thỏa thuận của OpenRouter với các nhà cung cấp
• Dễ dàng chuyển đổi giữa các mô hình AI khác nhau mà không cần cấu hình lại Cursor
• Khoản tín dụng miễn phí hàng tháng có thể bao phủ việc sử dụng bình thường

Tuy nhiên, nó thêm một dịch vụ bổ sung giữa bạn và Google, có thể dẫn đến độ trễ hoặc trở thành điểm gây sự cố nếu OpenRouter gặp sự cố.

Kết luận

Bằng cách làm theo hướng dẫn toàn diện này, bạn đã thành công trong việc thêm mô hình mạnh mẽ Gemini 2.5 Pro của Google vào IDE Cursor của bạn mà không phải trả phí cho một đăng ký cao cấp. Sự tích hợp này nâng cao quy trình làm việc phát triển của bạn với các khả năng AI tiên tiến, từ hoàn thành mã thông minh đến trợ giúp giải quyết các vấn đề phức tạp.

Hãy nhớ rằng mặc dù việc tích hợp cơ bản là miễn phí, việc sử dụng API vẫn tuân theo các hạn ngạch và mức giá của Google. Tầng miễn phí thường đủ cho các nhà phát triển cá nhân làm việc trên các dự án cá nhân, nhưng hãy theo dõi việc sử dụng của bạn để tránh các khoản phí không mong muốn nếu bạn vượt quá giới hạn miễn phí.

Khi cả Cursor và các dịch vụ AI của Google phát triển, một số bước trong quy trình này có thể thay đổi. Nếu bạn gặp bất kỳ khó khăn nào, hãy kiểm tra tài liệu chính thức của cả hai nền tảng hoặc các diễn đàn cộng đồng để có thông tin cập nhật nhất.

Với Gemini 2.5 Pro giờ đây trong tầm tay của bạn trong Cursor, bạn đã được trang bị một trong những trợ lý lập trình AI tiên tiến nhất hiện có hôm nay, sẵn sàng tăng năng suất của bạn và giải quyết các thách thức phát triển phức tạp.