Chuyển đến nội dung chính
Rock API, còn được viết là RockAPI, là cổng API AI và chợ OpenAPI tại rockapi.ai. Bạn dùng bảng điều khiển để quản lý khóa API, xem dịch vụ khả dụng, kiểm tra mức sử dụng và theo dõi chi phí. Tài liệu này giúp cấu hình ứng dụng khách và hiểu hành vi của các giao diện bạn gọi.

​
Nền tảng cung cấp gì

Cổng mô hình định tuyến các yêu cầu được hỗ trợ đến nhà cung cấp thượng nguồn đã cấu hình. Ứng dụng khách tương thích OpenAI có thể dùng địa chỉ cơ sở sau cho những giao diện được hỗ trợ:
Cổng còn có bộ điều hợp riêng cho từng nhà cung cấp và các bước chuyển đổi định dạng yêu cầu. Điều này không có nghĩa mọi mô hình hay tính năng thượng nguồn đều dùng được qua mọi giao diện. Trước khi tích hợp, kiểm tra danh mục mô hình để biết mã mô hình chính xác, nhóm khả dụng, đơn vị tính giá và điều kiện hiện tại. Hướng dẫn Mô hình và nhà cung cấp giúp đánh giá khả năng truy cập mô hình. Chợ OpenAPI cung cấp các dịch vụ API được niêm yết theo gói đăng ký và điều khoản riêng. Hãy kiểm tra giao diện, yêu cầu xác thực, giới hạn sử dụng và điều kiện đăng ký của dịch vụ đã chọn tách biệt với giá token của mô hình.

​
Xác minh tương thích trước khi chuyển đổi

Với lệnh gọi kiểu OpenAI được hỗ trợ, cấu hình khóa Rock API và địa chỉ cơ sở: SDK Python dùng base_url, còn SDK Node.js dùng baseURL. Bạn cũng cần chọn mã mô hình khả dụng và xác nhận điểm cuối, các trường yêu cầu cũng như cách xử lý phản hồi được hỗ trợ. Chỉ đổi địa chỉ không đủ để xác lập tính tương thích. Kiểm tra các chức năng ứng dụng thực sự dùng, như phản hồi luồng, gọi công cụ, đầu ra có cấu trúc hoặc đầu vào đa phương tiện khi phù hợp. Làm theo hướng dẫn API tương thích OpenAI, rồi thử một yêu cầu nhỏ trước khi chuyển lưu lượng vận hành thực tế.

​
Gửi yêu cầu đầu tiên

  1. Tạo tài khoản và đăng nhập bảng điều khiển. Kiểm tra số dư khả dụng hoặc gói áp dụng trước khi gọi dịch vụ có phí.
  2. Mở trang Khóa API, tạo khóa cho ứng dụng và lưu trên máy chủ. Xem Xác thực để biết cách xử lý thông tin xác thực.
  3. Chọn một mô hình từ danh mục hiện tại. Ghi lại mã chính xác, nhóm sử dụng, giao diện được hỗ trợ và đơn vị tính phí.
  4. Cấu hình ứng dụng khách bằng khóa và địa chỉ. Làm theo Bắt đầu nhanh, dùng mô hình đã chọn để gửi một yêu cầu ngắn không chứa dữ liệu nhạy cảm.
  5. Kiểm tra nội dung trả về và thông tin sử dụng. Tìm bản ghi tương ứng trên bảng điều khiển, rồi đối chiếu mức tiêu thụ đã quyết toán với quy tắc tính giá áp dụng. Giữ mã yêu cầu để xử lý sự cố.

​
Kiểm tra chi phí và cách xử lý dữ liệu

Giá phụ thuộc vào mô hình, nhóm và quy tắc tính phí áp dụng. Xem Giá và thanh toán để hiểu cách tính theo mức sử dụng, theo lượt và theo quy tắc động. Giá cơ sở hiển thị hoặc giá của một mô hình không phải mức giảm chung cho toàn nền tảng hay báo giá cho mọi lệnh gọi. Yêu cầu đi qua cổng đến dịch vụ thượng nguồn. Đọc Bảo mật và quyền riêng tư trước khi xử lý nội dung nhạy cảm, rồi xác nhận việc lưu giữ, sử dụng để huấn luyện và yêu cầu về khu vực cho tuyến thực tế. Nếu lệnh gọi thất bại, dùng hướng dẫn Lỗi và giới hạn tốc độ để kiểm tra phản hồi và chọn bước xử lý tiếp theo.

​
Tên miền chính thức và hỗ trợ

Bảng điều khiển và danh mục dịch vụ nằm tại rockapi.ai, tài liệu nằm tại docs.rockapi.ai. Với câu hỏi về tài khoản, dịch vụ hoặc quyền riêng tư, hãy dùng kênh hỗ trợ trên trang Giới thiệu của website chính. Cung cấp mã yêu cầu và mô tả đã che thông tin nhạy cảm thay vì khóa API đầy đủ hoặc nội dung yêu cầu riêng tư.