CoArena cho phép bạn sử dụng AI miễn phí với hạn mức trị giá 5 USD mỗi ngày. Theo công bố của nền tảng, chi phí sử dụng trong hạn mức này do CoArena chi trả. Đây là hạn mức gọi mô hình AI, không phải khoản tiền mặt được chuyển cho bạn.
Trong bài này, mình hướng dẫn cách tạo API key, chọn địa chỉ kết nối và gửi yêu cầu đầu tiên theo tài liệu của CoArena. Nếu bạn đang tìm API AI miễn phí để đưa vào công cụ hoặc mã nguồn của mình, đây là cách bắt đầu mà không cần cung cấp thẻ theo hướng dẫn hiện có.
Chuẩn bị
Bạn cần truy cập được CoArena và tạo API key tại trang quản lý API của nền tảng. Tài liệu ghi rõ việc tạo key là miễn phí, không cần thẻ. Hãy đọc điều khoản sử dụng và chính sách quyền riêng tư trước khi tiếp tục; trang chủ có thông báo việc tiếp tục đồng nghĩa với chấp thuận các chính sách này.
Trước khi thực hiện, bạn nên xác định mình sẽ dùng loại kết nối nào:
- OpenAI SDK: dùng base URL
https://coarena.ai/api/v1. - Anthropic SDK: dùng base URL
https://coarena.ai/api. - Gọi trực tiếp bằng curl: có thể làm theo ví dụ trong phần tiếp theo nếu môi trường của bạn đã có công cụ này.
Các lệnh bên dưới dùng biến môi trường COARENA_API_KEY để đại diện cho khóa của bạn. Bạn cần gán khóa đã tạo vào biến này trong môi trường đang sử dụng trước khi gọi API. Không chia sẻ khóa trong bình luận hoặc ảnh chụp màn hình.
Nguồn hướng dẫn: tài liệu Model API của CoArena.
Các bước thực hiện
Bước 1: Mở CoArena và tạo API key miễn phí
Truy cập trang chủ CoArena, tìm lựa chọn Get a free key. Trong phần Quick start của tài liệu, CoArena cũng hướng dẫn tạo khóa trên trang API của tài khoản.
Hoàn tất việc truy cập tài khoản theo giao diện đang hiển thị, sau đó tạo API key. Khóa này là thông tin bạn dùng để xác thực các yêu cầu gọi mô hình ở bước sau.
Bước 2: Xác định mô hình muốn sử dụng
CoArena cho phép lấy danh sách mô hình qua API mà không cần khóa. Bạn có thể dùng lệnh có trong tài liệu:
curl https://coarena.ai/api/v1/modelsKhi gửi yêu cầu, hãy điền đúng ID mô hình vào trường model. Ví dụ gọi API trong tài liệu sử dụng claude-fable-5. Việc kiểm tra danh sách trước khi cấu hình giúp bạn chọn theo thông tin mà API đang cung cấp, thay vì phụ thuộc vào số lượng mô hình được ghi trên trang giới thiệu.
Bước 3: Thiết lập kết nối cho SDK hoặc công cụ đang dùng
Nếu dùng OpenAI SDK, tài liệu cung cấp các biến môi trường sau. Giá trị API key được lấy từ biến COARENA_API_KEY đã chuẩn bị:
export OPENAI_BASE_URL=https://coarena.ai/api/v1
export OPENAI_API_KEY=$COARENA_API_KEYNếu dùng Anthropic SDK hoặc Claude Code, tài liệu đưa ra cấu hình:
export ANTHROPIC_BASE_URL=https://coarena.ai/api
export ANTHROPIC_AUTH_TOKEN=$COARENA_API_KEYBạn chọn phần cấu hình phù hợp với công cụ của mình. Hai nhóm biến trên tương ứng với hai kiểu kết nối khác nhau được CoArena mô tả.
Bước 4: Gửi yêu cầu AI đầu tiên
Để gọi trực tiếp bằng curl, bạn có thể làm theo ví dụ dưới đây từ tài liệu chính thức. Yêu cầu gửi lời chào Hello đến mô hình được chỉ định:
curl https://coarena.ai/api/v1/chat/completions \
-H "Authorization: Bearer $COARENA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "claude-fable-5",
"messages": [{"role": "user", "content": "Hello"}]}'Sau khi gửi, kiểm tra nội dung API trả về. Nếu nhận thông báo lỗi, hãy đọc thông báo đó trước khi tiếp tục gửi yêu cầu. Phần bên dưới giải thích trường hợp chạm giới hạn được tài liệu đề cập.
Bước 5: Kiểm tra mức sử dụng và giới hạn tài khoản
CoArena cung cấp endpoint để xem mức sử dụng trong ngày cùng các giới hạn áp dụng cho tài khoản. Lệnh kiểm tra trong tài liệu là:
curl https://coarena.ai/api/v1/limits \
-H "Authorization: Bearer $COARENA_API_KEY"Bước này giúp bạn đối chiếu hạn mức của tài khoản khi sử dụng API AI miễn phí, nhất là trước khi đưa khóa vào công cụ gửi nhiều yêu cầu.
Lưu ý và xử lý lỗi
Theo mục Limits trong tài liệu CoArena, hạn mức miễn phí là 5 USD giá trị sử dụng mô hình mỗi ngày, với giới hạn 30 yêu cầu mỗi phút và 2 yêu cầu đồng thời. Một tài khoản cũng có thể được CoArena đặt thêm giới hạn số yêu cầu trong ngày.
Vì hạn mức được tính theo giá trị sử dụng, bạn không nên diễn giải ưu đãi này thành một số lượt hỏi cố định. Hãy kiểm tra thông tin tài khoản qua endpoint giới hạn khi cần biết tình trạng sử dụng.
Khi chạm giới hạn, API có thể trả lỗi 429. Ví dụ hết hạn mức ngày trong tài liệu có mã insufficient_quota và thông báo Daily free limit reached. Phản hồi cũng kèm thông tin về cách gửi yêu cầu tăng giới hạn.
CoArena cho phép đề nghị tăng hạn mức sau lần gọi đầu tiên, nhưng việc gửi đề nghị không đồng nghĩa tài khoản đã được duyệt mức mới. Bạn nên xem trạng thái yêu cầu và giới hạn thực tế trước khi tiếp tục sử dụng.
Câu hỏi thường gặp
Kết luận
Để bắt đầu sử dụng AI miễn phí trên CoArena, bạn hãy tạo API key, chọn đúng base URL và gửi yêu cầu thử theo các bước trên. Sau đó, kiểm tra mức sử dụng để biết giới hạn đang áp dụng cho tài khoản của mình.
Nếu gặp vướng mắc, bạn có thể bình luận tại Tuong.Me kèm tên công cụ, phiên bản SDK nếu có và thông báo lỗi đã che API key. Những thông tin này giúp việc đối chiếu cấu hình rõ ràng hơn.
Bình luận (0)