Tính năng được hỗ trợ
Điều kiện tiên quyết
- Node.js 18+
- Một tài khoản CometAPI với API key đang hoạt động — lấy tại đây
1
Cài đặt provider
Cài đặt
@cometapi/ai-sdk-provider cùng với gói lõi AI SDK:2
Thiết lập API key của bạn
Provider mặc định đọc biến môi trường
COMETAPI_KEY:Sử dụng biến môi trường để tránh hardcode thông tin xác thực trong mã nguồn của bạn.
3
Import provider
Import instance provider mặc định:Để ghi đè API key, base URL hoặc các thiết lập khác, hãy dùng
createCometAPI:Cách sử dụng
Tạo văn bản
Sử dụnggenerateText() cho phản hồi một lần:
Streaming văn bản
Sử dụngstreamText() để xuất nội dung theo từng phần trong thời gian thực:
Tạo embeddings
Sử dụngtextEmbeddingModel() để tạo vector embedding:
Tạo ảnh
Sử dụngimageModel() để tạo ảnh từ text prompt:
Cấu hình provider
createCometAPI chấp nhận các tùy chọn sau:
Các phương thức model
Provider cung cấp một số hàm khởi tạo model:
Xem danh sách đầy đủ các model ID hiện có trên trang Models.
Mẹo và khắc phục sự cố
Mẹo và khắc phục sự cố
- Lựa chọn model: Bất kỳ model nào từ danh mục model CometAPI đều hoạt động với phương thức model tương ứng — model chat qua
cometapi(), model embedding quatextEmbeddingModel(), model ảnh quaimageModel(). - Tinh chỉnh phản hồi: Truyền
temperature,maxTokens, vàtopPtrực tiếp vàogenerateText()hoặcstreamText(), ví dụ:generateText(\{..., temperature: 0.7\}). - Xử lý lỗi: Bọc các lệnh gọi trong
try/catchđể xử lý lỗi xác thực, giới hạn tốc độ hoặc sự cố mạng. - Bảo mật: Không bao giờ commit khóa API vào hệ thống quản lý phiên bản. Hãy dùng biến môi trường hoặc trình quản lý secrets.
- Giới hạn tốc độ: Theo dõi mức sử dụng trong CometAPI console.