Dùng Cursor với base URL của bạn

Cursor nói chuyện với các model qua OpenAI API. Đó chính là lý do nó nói chuyện được với gateway này: không phải vá gì, không phải bọc gì, không phải dựng proxy, cũng không cần thêm extension nào tồn tại. Hai ô trong phần cài đặt của chính Cursor là đủ để trỏ nó về đây, và mọi thứ Cursor vốn làm được vẫn làm y như cũ. Bài này là hai ô đó, tên của bốn model, và một câu lệnh nên chạy trước khi tin vào editor.

Hai ô cần điền

Mở phần cài đặt model của Cursor và tìm mục OpenAI — mục nhận API key. Trong đó có đúng hai thứ bạn cần: ô key, và chỗ ghi đè base URL, thường nằm sau một cái toggle ngay bên cạnh. Ở đây cố ý gọi tên cái mục thay vì chỉ đường bấm từng nút. Cursor đổi màn hình này giữa các bản phát hành, nên một lối đi bấm-từng-bước viết hôm nay sẽ thành câu trả lời sai chỉ sau một phiên bản; hai giá trị bạn gõ vào mới là phần sống lâu.

Chỗ ghi đè điền https://aifromu.com/v1. Key thì tạo trong portal khách hàng, và đó cũng đúng là cái key mà script của bạn đang dùng, vì đây vẫn là một API. Lưu cả hai là editor đã trỏ về đây — không phải đổi thêm cài đặt nào khác trong Cursor.

Đặt tên cho các model

Ở chỗ Cursor cho phép tự đặt tên model, thêm đúng bốn cái mà gateway này xếp chỗ: astra, sol, terra và luna. Đó là những cái tên API trả lời, và cũng là những cái tên hoá đơn của bạn liệt kê ra, nên một phiên làm việc trong editor và một dòng trong portal là cùng một chữ.

Tên kiểu OpenAI cũng dùng được. Một model đặt tên theo cách nhà cung cấp thượng nguồn đặt sẽ được đọc thành lớp năng lực của nó và bị tính đúng bằng chi phí của lớp đó ở đây, nghĩa là một cấu hình bê từ endpoint khác sang vẫn chạy mà không phải sửa. Gọi thẳng bốn cái tên của chúng tôi chỉ là phiên bản mà bạn nhìn ra được mình vừa hỏi lớp nào. Còn một lớp tốn bao nhiêu thì được đo theo từng lớp token trên từng model — input, cache read, cache write và output tính giá riêng — và toàn bộ phép tính đó nằm trong bài giải thích về giá.

Kiểm bằng terminal trước đã

Trước khi tin một editor, hãy hỏi thẳng API. Một câu lệnh, ngoài Cursor, với đúng cái key bạn vừa dán vào nó:

Bốn model sẽ trả về. Nếu có, key còn sống và base URL đúng, và mọi thứ vẫn hỏng sau đó là hỏng ở cài đặt của editor chứ không phải ở tài khoản của bạn — một base URL dính thêm đường dẫn ở đuôi, một cái key dán vào kèm dấu cách ở đầu, một mục OpenAI đã điền nhưng chưa bật. Nếu không trả về, terminal nói cho bạn biết vì sao trong đúng một dòng, và đó là cuộc trao đổi ngắn hơn nhiều so với cùng lỗi ấy nhìn qua một editor.

Khi Cursor hỏi một model ở đây không có

Nếu một tính năng nào đó của Cursor hỏi một model mà gateway này không xếp chỗ, câu trả lời là một lời từ chối rõ ràng, gọi tên bốn model mà nó có — hiện ngay trong chỗ báo lỗi của chính Cursor, nên một cấu hình sai là một câu thông báo chứ không phải một điều bí ẩn. Trong một editor, tên model có thể đến từ nhiều chỗ, và một tính năng lặng lẽ nối vào một cái tên không ai gõ vào chính là kiểu hỏng mà nếu không có câu thông báo ấy thì không tài nào tìm ra.

Gateway cũng ánh xạ những cái tên nội bộ của client mà nó biết. Bộ reviewer chạy nền của Codex CLI đã được ánh xạ sang terra, nên một client hỏi cái tên riêng của chính nó thì nhận về một model chứ không phải một lỗi. Lời từ chối là dành cho những cái tên mà ở đây không có gì trả lời thay được một cách thành thật; cái tên nào xếp được chỗ, chúng tôi xếp.