Để cách thêm API Key vào TraeCode, bạn chỉ cần vào Settings → Models → Add Model, chọn nhà cung cấp có sẵn hoặc Custom Model, sau đó nhập API Key, Model ID, định dạng API và địa chỉ Request URL. Sau khi lưu cấu hình, model mới sẽ xuất hiện trong danh sách để bạn chọn và sử dụng trực tiếp trong TraeCode. Cả quá trình mất khoảng 2-3 phút. Cùng theo dõi bài viết để biết cách thực hiện chi tiết nhé!
TraeCode là gì và khi nào cần kết nối API?
TraeCode là một môi trường phát triển tích hợp AI (AI IDE) hỗ trợ lập trình viên viết code, sửa lỗi, giải thích mã nguồn và xây dựng dự án nhanh hơn bằng các mô hình AI. IDE này do ByteDance phát triển, có khả năng tích hợp trợ lý AI trực tiếp vào quy trình lập trình, cho phép người dùng trao đổi bằng ngôn ngữ tự nhiên, tạo hoặc chỉnh sửa nhiều file và kết nối thêm các model bên ngoài thông qua API. Nhờ đó, Trae phù hợp cả với lập trình viên chuyên nghiệp lẫn người mới muốn phát triển ứng dụng với sự hỗ trợ của AI.
Khi nói “kết nối Trae API”, người dùng thường muốn đưa API key của một nhà cung cấp AI vào Trae để dùng model riêng, thay cho danh sách model có sẵn. Trae không bán một API riêng cho bạn gọi từ bên ngoài.
Bạn nên kết nối khi:
- Model có sẵn trong Trae chưa đáp ứng nhu cầu. Trae cho phép thêm model tùy chỉnh theo hai cách: chọn nhà cung cấp có sẵn rồi nhập API key, hoặc tự cấu hình định dạng API, đường dẫn yêu cầu, mã model và thông tin xác thực.
- Bạn đã có tài khoản hoặc gói đăng ký ở nhà cung cấp khác và muốn tận dụng hạn mức sẵn có.
- Bạn muốn tự kiểm soát chi phí theo từng nhà cung cấp.
Xem thêm: Top 10+ nền tảng tổng hợp API model AI
Cần chuẩn bị gì trước khi kết nối API với TreaCode?
Trước khi cấu hình, bạn nên chuẩn bị bốn thông tin quan trọng:
- API Key: khóa xác thực do nhà cung cấp model cấp.
- API Endpoint hoặc Base URL: địa chỉ mà TRAE sẽ gửi request.
- Model ID: tên chính xác của model cần sử dụng.
- API Format: chuẩn giao tiếp mà dịch vụ hỗ trợ.
Ví dụ, một dịch vụ tương thích OpenAI có thể cung cấp thông tin dạng:
- API Base URL: https://api.example.com/v1
- Model ID: example-model
- API Key: sk-xxxxxxxx
Lưu ý:
- Tên Model ID phải được nhập chính xác theo tài liệu của nhà cung cấp. Không nên tự suy đoán tên model dựa trên tên hiển thị trên website.
- Ngoài ra, API Key thường được tính phí và quản lý riêng bởi nhà cung cấp model. Gói TRAE đang sử dụng không đồng nghĩa với việc API của OpenAI, Anthropic, OpenRouter hoặc dịch vụ khác được miễn phí.
Hướng dẫn cách thêm API Key vào TraeCode
Bước 1: Lấy API Key từ nhà cung cấp model
Trước tiên, hãy truy cập nền tảng cung cấp model mà bạn muốn kết nối.
Ví dụ:
- OpenAI
- Anthropic
- OpenRouter
- DeepSeek
- Kimi
- GLM
- một dịch vụ API tương thích OpenAI
- một máy chủ model nội bộ
Sau đó tạo API Key và lưu lại tại nơi an toàn.
Bước 2: Tải phần mềm TraeCode (nếu chưa có)
Truy cập vào https://www.trae.ai/ và tải về ứng dụng TraeCode. Sau đó, cài đặt như các phần mềm thông thường.
Sau khi cài đặt hoàn tất, mở TraeCode và đăng nhập tài khoản.
Bước 3: Mở phần quản lý Model trong TraeCode
Trong TraeCode, vào Settings → Models → chọn Add Model.
Bước 4: Chọn nhà cung cấp hoặc Custom Model
TRAE cung cấp hai cách thêm model.
Cách 1: Chọn nhà cung cấp có sẵn
Nếu dịch vụ bạn sử dụng xuất hiện trong danh sách của TRAE, hãy chọn trực tiếp nhà cung cấp đó.
Tiếp theo bạn chỉ cần:
- Chọn provider.
- Chọn model.
- Nhập API Key.
- Lưu cấu hình.
Đây là lựa chọn đơn giản nhất cho người mới.
Cách 2: Chọn Custom Model
Nếu nhà cung cấp không xuất hiện trong danh sách hoặc bạn đang sử dụng API proxy, API gateway, model self-hosted hay dịch vụ trung gian, hãy chọn Custom Model.
TraeCode cho phép tự cấu hình API Format, Request URL, Model ID, tên hiển thị và API Key. (tham khảo các bước tiếp theo).
Bước 4: Chọn đúng API Format (nếu Custom API)
Đây là bước rất quan trọng. Theo tài liệu TraeCode hiện tại, Custom Model trên bản thông thường hỗ trợ hai định dạng chính.
OpenAI Chat Completions
Chuẩn endpoint phổ biến: /v1/chat/completions
Phù hợp với nhiều dịch vụ như:
- OpenAI-compatible API
- OpenRouter
- DeepSeek
- Kimi
- GLM
- một số Ollama server
- API gateway tương thích OpenAI
Anthropic Messages
Chuẩn endpoint: /v1/messages
Phù hợp với:
- Anthropic Claude
- API gateway hỗ trợ Anthropic Messages
- các dịch vụ proxy Claude tương thích chuẩn Anthropic
Nếu nhà cung cấp hỗ trợ nhiều chuẩn, hãy ưu tiên chuẩn được họ công bố chính thức cho model đang sử dụng.
TRAE có hỗ trợ OpenAI Responses API không?
Tài liệu TraeCode dành cho người dùng thông thường hiện liệt kê OpenAI Chat Completions và Anthropic Messages cho Custom Model. Trong khi đó, tài liệu TRAE Enterprise đã bổ sung OpenAI Responses API /v1/responses bên cạnh hai chuẩn trên.
Vì vậy, hãy kiểm tra trực tiếp danh sách API Format trong phiên bản TRAE đang sử dụng thay vì mặc định chọn Responses API.
Bước 5: Nhập Request URL (nếu Custom API)
TRAE hiện cung cấp hai cách nhập Request URL.
Trường hợp 1: Bật Full URL
Khi bật Full URL, bạn cần nhập toàn bộ endpoint. Ví dụ:
- Với OpenAI-compatible API: https://api.example.com/v1/chat/completions
- Với Anthropic-compatible API: https://api.example.com/v1/messages
Trường hợp 2: Tắt Full URL
Bạn chỉ nhập địa chỉ cơ sở. Ví dụ: https://api.example.com/v1
TraeCode sẽ ghép request path dựa trên API Format mà bạn đã chọn. Đây là cơ chế được tài liệu chính thức mô tả cho Custom Model.
Lưu ý quan trọng
Đây cũng là một trong những vị trí dễ cấu hình sai nhất.
Nếu nhà cung cấp yêu cầu https://api.example.com/v1/chat/completions nhưng bạn bật Full URL rồi chỉ nhập https://api.example.com/v1, request có thể không đi đến đúng endpoint.
Ngược lại, khi TRAE đang tự ghép endpoint, việc nhập thêm /chat/completions một lần nữa cũng có thể tạo đường dẫn sai.
Do đó, cần kiểm tra trạng thái Full URL trước khi điền địa chỉ.
Bước 6: Nhập Model ID và API Key
Tiếp theo, nhập Model ID. và API Key
TraeCode cũng cho phép đặt Model Display Name để dễ nhận biết model trong danh sách. Nếu bỏ trống, hệ thống có thể sử dụng Model ID làm tên hiển thị.
Tên hiển thị chỉ phục vụ việc nhận diện trong TRAE và không thay đổi Model ID được gửi tới API.
Bước 7: Lưu và kiểm tra kết nối
Nhấn Add Model để lưu Custom Model. Sau khi hoàn tất:
- Quay lại cửa sổ chat.
- Nhấn vào tên model ở góc khu vực nhập prompt.
- Chọn model vừa thêm.
- Gửi một yêu cầu đơn giản để kiểm tra.
Ví dụ:
Hãy tạo một file HTML hiển thị dòng chữ Hello World.
Nếu model phản hồi bình thường, quá trình kết nối API với TRAE đã hoàn tất.
TraeCode cho phép bật, tắt, chỉnh sửa hoặc xóa Custom Model sau khi thêm.
Cấu hình nâng cao cho Custom Model
Ngoài thông tin API cơ bản, TraeCode còn cho phép thiết lập một số thông số nâng cao.
Tùy model và phiên bản, khu vực Advanced Settings có thể bao gồm:
- Model Series
- Context Window
- hỗ trợ image input
- Temperature
- Top P
- Top K
Theo tài liệu TRAE, cấu hình do người dùng thiết lập cho context window, khả năng nhận ảnh và một số sampling parameter sẽ được ưu tiên.
Người mới không cần chỉnh toàn bộ thông số ngay từ đầu. Cách an toàn hơn là:
- Kết nối API thành công trước.
- Kiểm tra model phản hồi bình thường.
- Sau đó mới điều chỉnh context window hoặc sampling parameter khi cần.
Nếu đặt context window cao hơn khả năng provider hỗ trợ, request có thể thất bại hoặc bị giới hạn bởi phía API.
Các lỗi thường gặp khi kết nối TraeCode
Lỗi 401 Unauthorized
Nguyên nhân thường gặp:
- API Key sai.
- API Key hết hiệu lực.
- Key bị thu hồi.
- Key không có quyền truy cập model.
- Copy dư khoảng trắng.
Cách xử lý:
- Tạo API Key mới.
- Copy lại key.
- Kiểm tra quyền sử dụng model.
- Kiểm tra tài khoản API còn hoạt động.
Lỗi 404 Not Found
Lỗi 404 thường liên quan đến:
- Request URL sai.
- Endpoint sai.
- Model ID không tồn tại.
- TRAE ghép thêm path vào URL không đúng.
Hãy kiểm tra đặc biệt mục Full URL.
Ví dụ, nếu provider yêu cầu https://api.example.com/v1/chat/completions hãy xác định TRAE đang cần Base URL hay Full URL trước khi nhập.
Lỗi 405 Method Not Allowed
Lỗi này thường xuất hiện khi request được gửi đến sai endpoint hoặc endpoint không hỗ trợ phương thức request mà client đang sử dụng.
Hãy kiểm tra:
- API Format.
- Full URL.
- endpoint /chat/completions.
- endpoint /messages.
- hướng dẫn của provider.
Lỗi 429 Too Many Requests
Một số nguyên nhân phổ biến:
- hết credit.
- vượt quota.
- vượt rate limit.
- gửi quá nhiều request trong thời gian ngắn.
Hãy kiểm tra phần Billing, Usage hoặc Rate Limits của provider.
Model Request Failed
Nếu TRAE chỉ hiển thị thông báo model request thất bại, hãy kiểm tra lần lượt:
- API Key.
- Model ID.
- API Format.
- Request URL.
- Full URL.
- quota API.
- context window.
- trạng thái dịch vụ của provider.
Không nên thay đổi nhiều thông số cùng lúc. Hãy sửa từng trường và kiểm tra lại để dễ xác định nguyên nhân.
Một số lưu ý khi sử dụng API trên TraeCode
- Luôn lấy Model ID từ tài liệu chính thức của provider.
- Không chia sẻ API Key trong ảnh chụp màn hình hoặc repository công khai.
- Kiểm tra Full URL trước khi chỉnh endpoint.
- Không mặc định mọi API OpenAI-compatible đều hỗ trợ toàn bộ tính năng giống OpenAI.
- Theo dõi token và chi phí trực tiếp tại provider.
- Nếu dùng proxy hoặc gateway, hãy kiểm tra giao thức mà gateway hỗ trợ.
- Nên thử model bằng một prompt đơn giản trước khi chạy Agent với tác vụ lớn.
- Với tài khoản doanh nghiệp, quyền thêm Custom Model có thể do quản trị viên kiểm soát. TRAE Enterprise có tùy chọn cho phép hoặc chặn thành viên tự thêm model.
Có nên kết nối API riêng với TraeCode?
Kết nối API riêng phù hợp khi bạn:
- muốn sử dụng model không có trong danh sách mặc định;
- đã có API Key của OpenAI, Anthropic hoặc provider khác;
- muốn dùng OpenRouter để truy cập nhiều model;
- sử dụng model qua API gateway của doanh nghiệp;
- có model self-hosted hỗ trợ OpenAI-compatible API;
- muốn chủ động lựa chọn model cho từng dự án;
- muốn quản lý chi phí API trực tiếp qua provider.
Ngược lại, nếu model tích hợp sẵn trong TRAE đã đáp ứng nhu cầu, người mới có thể sử dụng model mặc định để giảm bớt khâu cấu hình.
Kết luận
Với khả năng thêm Custom Model, TraeCode trở nên linh hoạt hơn đáng kể khi bạn muốn kết hợp môi trường AI coding với GPT, Claude, DeepSeek, Kimi, GLM, OpenRouter hoặc hạ tầng model riêng của doanh nghiệp. Hãy thử thêm một model ngay hôm nay và đổi qua lại giữa các model để tìm lựa chọn phù hợp nhất với công việc của bạn.
Những câu hỏi thường gặp
Kết nối Trae API có mất phí không?
Việc thêm model vào Trae không tốn phí. Chi phí phát sinh từ nhà cung cấp, tính theo lượng token bạn dùng hoặc theo gói đăng ký.
Trae hỗ trợ những nhà cung cấp nào?
Trae có danh sách nhà cung cấp cài sẵn và thay đổi theo từng phiên bản. Nhà cung cấp nào ngoài danh sách vẫn thêm được qua Custom Model nếu dịch vụ tương thích chuẩn OpenAI hoặc Anthropic.
Có thể kết nối OpenRouter với Trae không?
Có thể, miễn là cấu hình sử dụng endpoint, API Key, Model ID và giao thức tương thích mà OpenRouter cung cấp. Tài liệu TRAE cũng liệt kê OpenRouter trong nhóm dịch vụ thường sử dụng OpenAI Chat Completions.
Tại sao đã dán đúng key mà vẫn báo lỗi?
Nguyên nhân thường là key thuộc nhà cung cấp khác, tài khoản hết quota, hoặc cấu hình Custom Model sai URL và Model ID. Hãy đọc nhật ký lỗi trong cửa sổ Add Model để xác định đúng nguyên nhân.
