Chuyển đến nội dung chính
API tương thích OpenAI hỗ trợ các dạng yêu cầu và phản hồi kiểu OpenAI đã được tài liệu hóa. Bạn có thể tái sử dụng ứng dụng khách cho thao tác được hỗ trợ, nhưng đổi URL cơ sở chỉ là bước đầu. ID mô hình, tham số, công cụ, sự kiện truyền luồng và cách xử lý lỗi vẫn phải được kiểm tra riêng.

Chuẩn bị tài khoản và tham số

Chọn mô hình trò chuyện trong danh mục hiện tại, sao chép đúng ID và xác nhận quyền của tài khoản cùng nhóm. Tạo khóa Rock API tại trang khóa API; khóa của nhà cung cấp gốc không thay thế được. Đọc hướng dẫn tính phí và kiểm tra số dư cần thiết. Lưu khóa phía máy chủ trong ROCK_API_KEY, đặt ID đã chọn vào ROCK_API_MODEL. Các ví dụ giả định máy đã có curl hoặc gói openai cho ngôn ngữ đang dùng. Chúng minh họa Chat Completions, không xác nhận mọi phương thức SDK hay API gốc đều được hỗ trợ. Người mua không cần cấu hình kênh nhà cung cấp.

Tạo yêu cầu tối thiểu làm mốc

URL cơ sở đầy đủ của SDK là https://rockapi.ai/v1. Không thêm một /v1 nữa và không đưa /chat/completions vào thiết lập URL cơ sở. curl dùng điểm cuối đầy đủ:

Ví dụ Python

Ví dụ Node.js

Kiểm nhận từng tính năng ứng dụng cần

Bắt đầu không có tham số tùy chọn, sau đó thêm từng chức năng cần thiết. Ghi lại phiên bản SDK, ID mô hình, dữ liệu vào và kết quả mong đợi để tái hiện khác biệt. Một câu trả lời văn bản thành công không xác nhận hình ảnh hoặc công cụ. Mỗi mô hình có thể có chức năng và hành vi khác nhau dù dùng chung điểm cuối. Xem đánh giá mô hình theo nhiệm vụ.

Chuyển dần và giữ khả năng quay lại

Phát lại các yêu cầu đại diện đã loại dữ liệu nhạy cảm trong môi trường thử nghiệm. So sánh chất lượng, độ trễ, lỗi và chi phí mỗi kết quả đạt. Giới hạn số lần thử lại để tránh công việc trùng và chi phí mất kiểm soát; không lặp vô hạn lỗi xác thực. Tra lỗi và giới hạn, giữ thời điểm và ID nhưng không lưu khóa hay lời nhắc riêng tư vào báo cáo. Chỉ tăng lưu lượng thật sau khi kiểm nhận, đồng thời giữ cấu hình cũ để khôi phục. Đối chiếu mức sử dụng đã quyết toán; giảm số dư tạm thời hoặc lỗi HTTP không đủ để xác định khoản phí cuối cùng.