Xây dựng với CometAPICần một API cho nhiều mô hình?Kiểm thử quy trình trong Playground, sau đó tạo API key khi mô hình và chi phí phù hợp với trường hợp sử dụng của bạn.
Tìm hiểu cách sử dụng Muse Wonder miễn phí với khoản tín dụng đăng ký của CometAPI. Thiết lập khóa API của bạn, sửa một lỗi JavaScript, kiểm tra kết quả và xem lại mức sử dụng token thực tế.
Tạo tài khoản CometAPI miễn phí, dùng khoản tín dụng đăng ký $0.10, và gửi một yêu cầu tới muse-wonder. Không cần thẻ tín dụng hay gói thuê bao hàng tháng để bắt đầu. Phần dưới đây sẽ hướng dẫn bạn sửa một lỗi nhỏ trong JavaScript để lần thử đầu tiên tạo ra kết quả bạn có thể kiểm tra và sử dụng.
Những điểm chính
Sử dụng khoản tín dụng khi đăng ký của CometAPI để thử Muse Wonder mà không cần thanh toán ban đầu.
Tạo khóa API và gọi muse-wonder qua endpoint Chat Completions của CometAPI.
Bắt đầu với một tác vụ độc lập nhỏ và kiểm thử kết quả trước khi chuyển sang dự án lớn hơn.
Quyền truy cập miễn phí đến từ khoản tín dụng khởi đầu; việc sử dụng tiếp theo sẽ được tính phí theo mức tiêu thụ.
Đã được xem xét về độ rõ ràng, ghi nguồn và thuật ngữ API hiện tại.
Cách kiểm thử Muse Wonder với một bản sửa lỗi JavaScript
Chúng tôi khuyến nghị dùng yêu cầu Muse Wonder đầu tiên để giải quyết một vấn đề nhỏ có thể tự kiểm chứng. Sửa lỗi là điểm khởi đầu phù hợp: bạn có thể cung cấp toàn bộ hàm, xác định hành vi mong muốn và kiểm tra xem mã trả về có hoạt động không.
Trong hướng dẫn này, chúng ta sẽ sửa hàm average(). Hàm này tính giá trị trung bình của một mảng không rỗng, nhưng trả về NaN cho mảng rỗng:
function average(xs) {
return xs.reduce((a, b) => a + b, 0) / xs.length;
}
Chúng ta muốn Wonder giữ nguyên phép tính thông thường và ném RangeError khi mảng rỗng. Điều đó tạo ra mục tiêu rõ ràng cho lần thử: một hàm đã chỉnh sửa vượt qua ba kiểm tra.
Năm bước để thử Muse Wonder bằng tín dụng miễn phí của CometAPI: tạo tài khoản, tạo khóa API, gửi yêu cầu sửa mã, chạy ba kiểm tra và xem lại mức sử dụng token cùng chi phí.
Hình 1. Một lần thử tập trung đưa bạn từ khoản tín dụng khởi đầu đến kết quả có thể kiểm chứng. Bố cục giải thích gốc kết hợpOpenMojivới thu phóng theo tỉ lệ và sắp xếp mới. Được cấp phép theoCC BY-SA 4.0; đầy đủ nguồn ảnh và giấy phép.
Cách sử dụng Muse Wonder miễn phí trên CometAPI
Bước 1 Tạo tài khoản và nhận tín dụng
Mở trang đăng ký CometAPI và tạo tài khoản. Sau khi đăng nhập, mở Wallet để xem $0.10 signup credit. Khoản này được tự động cộng; không có bước đổi riêng.
Khoản tín dụng này chi trả cho các yêu cầu Muse Wonder đầu tiên của bạn. Bạn có thể để phần thiết lập thanh toán cho sau và làm theo ví dụ với số dư khởi đầu.
Thích bắt đầu ngay trên trình duyệt? Mở trang model Wonder và chọn Playground. Bạn có thể gửi hàm và yêu cầu về mảng rỗng tại đó bằng chính khoản tín dụng tài khoản; các bước API dưới đây hướng dẫn cách thực hiện yêu cầu từ terminal của bạn.
Bước 2 Tạo khóa API
Mở API Keys, nhấp Create API Key, đặt tên khóa như wonder-trial, rồi nhấp Create. Sao chép khóa và thiết lập trong terminal cục bộ:
export COMETAPI_KEY="YOUR_COMETAPI_KEY"
Thay thế placeholder bằng khóa của bạn. Không đưa khóa thật vào mã chạy phía trình duyệt hoặc kho công khai. API quickstart hiển thị các màn hình tạo tài khoản và khóa.
Bước 3 Gửi yêu cầu sửa lỗi
Lệnh sau hoạt động trong terminal Bash hoặc Zsh có cài curl. Nó gọi Muse Wonder bằng model ID muse-wonder qua endpoint /v1/chat/completions của CometAPI:
curl "https://api.cometapi.com/v1/chat/completions" \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "muse-wonder",
"messages": [
{
"role": "user",
"content": "Fix this JavaScript function. For non-empty arrays, preserve the arithmetic mean. For an empty array, throw a RangeError. The function must return 4 for [2, 4, 6], return 0 for [-2, 0, 2], and throw RangeError for []. Return only the corrected JavaScript function named average, without Markdown fences, explanations, or tests. Use no external packages. Function: function average(xs) { return xs.reduce((a, b) => a + b, 0) / xs.length; }"
}
]
}'
Prompt cung cấp mã và hành vi yêu cầu trong một yêu cầu, và chỉ yêu cầu hàm. Điều đó giúp câu trả lời tập trung và để các kiểm tra bên dưới độc lập với mã kiểm thử của chính model.
Trong phản hồi JSON, câu trả lời nằm ở choices[0].message.content, như trong định dạng phản hồi Chat Completions. Sao chép hàm trả về vào một tệp tên average-test.cjs.
Bước 4 Kiểm tra xem bản sửa có hoạt động không
Đọc hàm trước: nó nên kiểm tra mảng rỗng trước khi chia cho độ dài. Sau đó đặt các kiểm tra này bên dưới trong average-test.cjs:
Nếu cả ba đều vượt qua, bạn có một câu trả lời hoạt động theo đặc tả nhỏ này. Chúng không chứng minh hàm đã sẵn sàng cho mọi đầu vào: chuỗi, đối số bị thiếu và các trường hợp khác cần yêu cầu và kiểm thử riêng. Hãy giữ phạm vi rõ ràng khi đánh giá kết quả của model.
Nếu một kiểm tra thất bại, hãy phản hồi với lỗi cụ thể và hàm đã trả về. Lỗi cụ thể giúp Wonder có mục tiêu chỉnh sửa rõ ràng hơn so với “try again”.
Bước 5 Xem lại mức tiêu thụ của yêu cầu
Mở Logs trong tài khoản CometAPI và mở rộng bản ghi của yêu cầu. Xem lại mức tiêu thụ token và chi phí, sau đó kiểm tra số dư còn lại trong Wallet. Hướng dẫn tài khoản giải thích nơi tìm công thức tính chi tiết.
Giờ bạn đã có đủ hai phần cho một lần thử hữu ích: một kết quả có thể đánh giá và bản ghi cho biết nó tiêu thụ gì. Hãy giữ cả hai khi quyết định bước tiếp theo.
Cách giảm lượng token khi kiểm thử Muse Wonder
Một prompt tập trung sẽ làm được nhiều việc hơn mỗi yêu cầu. Trong ví dụ, hàm, yêu cầu xử lý lỗi và ca kiểm thử đều có ngay từ đầu. Hãy áp dụng cùng mẫu cho tác vụ của bạn: cung cấp đầu vào liên quan, nói rõ cần thay đổi gì và định nghĩa cách bạn sẽ đánh giá kết quả.
Với bài viết, điều đó có thể là chỉnh một đoạn văn trong khi giữ nguyên mọi tên và con số. Với tài liệu, có thể là trích xuất một vài trường được nêu tên từ một đoạn ngắn. Hãy chọn một tác vụ mà nguồn và kết quả mong đợi bạn có thể tự kiểm tra.
Giữ cho các tin nhắn tiếp theo thật cụ thể. “Kiểm tra mảng rỗng vẫn thất bại; đây là lỗi” cho model mục tiêu tốt hơn “try again”. Với tác vụ không liên quan, hãy bắt đầu một yêu cầu mới để bạn không gửi lại lịch sử hội thoại mà tác vụ mới không cần.
Bạn có thể thử được bao nhiêu với khoản tín dụng miễn phí
Muse Wonder hiện có giá $3.20 cho mỗi triệu token đầu vào và $16 cho mỗi triệu token đầu ra trên CometAPI.
Để hình dung, một yêu cầu giả định có 2,000 token đầu vào chưa được cache và 500 token đầu ra tính phí sẽ tốn:
(2,000 × $3.20 + 500 × $16) ÷ 1,000,000 = $0.0144
Đây là ví dụ ước tính ngân sách, không phải phép đo cho yêu cầu sửa mã ở trên. Khối lượng công việc mà tín dụng của bạn chi trả phụ thuộc vào token tính phí thực tế và mọi lần gọi bổ sung. Hãy dùng mức tiêu thụ được ghi lại của yêu cầu đầu tiên để lên kế hoạch cho tác vụ tiếp theo, thay vì quy đổi số dư thành số lượng thông điệp cố định.
Việc sử dụng tiếp theo cần được nạp tiền. Hãy kiểm tra số dư còn lại trước khi tiếp tục: một yêu cầu cuối có thể tốn nhiều hơn phần tín dụng còn lại và khiến số dư âm.
Kết luận
Tạo tài khoản CometAPI, dùng khoản tín dụng đăng ký và giao cho Muse Wonder một công việc hữu ích. Với hướng dẫn này, thành công nghĩa là một hàm đã được sửa vượt qua ba kiểm tra, cùng mức tiêu thụ được ghi lại trong Logs.
Khi sẵn sàng kết nối Wonder với ứng dụng của bạn, hãy tiếp tục với CometAPI Muse Wonder API guide. Khi đó bạn đã có khóa API, một yêu cầu hoạt động và ví dụ cụ thể về cách bạn muốn model hỗ trợ.