Chuyển đến nội dung chính
Cổng API AI nằm giữa ứng dụng và nhà cung cấp mô hình. Cổng xác thực yêu cầu, chuyển đến mô hình được hỗ trợ và trả kết quả qua giao diện đã mô tả trong tài liệu. Cách này có thể giảm cấu hình lặp lại và tập trung theo dõi các lượt sử dụng được hỗ trợ. Nó không làm cho mọi mô hình có cùng hành vi. Dịch vụ OpenAPI có thể có gói đăng ký, cách xác thực và điểm cuối riêng; không nên mặc định gọi nó như mô hình trò chuyện.

​
So sánh với kết nối trực tiếp

Kết nối trực tiếp có thể phù hợp khi ứng dụng chỉ cần các tính năng gốc của một nhà cung cấp. Cổng là lựa chọn đáng xem xét khi đánh giá nhiều dòng mô hình hoặc muốn tập trung quản lý khóa và mức sử dụng. Hãy kiểm tra phạm vi hỗ trợ thực tế trước khi chuyển lưu lượng. URL cơ sở đầy đủ cho mô hình tương thích OpenAI của Rock API là https://rockapi.ai/v1. Khả năng tương thích áp dụng cho mô hình và yêu cầu được hỗ trợ. Một URL chung không tự bảo đảm chuyển đổi dự phòng, câu trả lời giống nhau hoặc mọi tính năng gốc.

​
Gửi yêu cầu đầu tiên với vai trò người mua

  1. Mở danh mục mô hình và giá hiện tại, chọn mô hình hỗ trợ trò chuyện và sao chép đúng ID. Kiểm tra quyền của tài khoản và nhóm đã chọn.
  2. Tạo tài khoản, kiểm tra yêu cầu số dư và tạo khóa tại trang khóa API. Lưu khóa phía máy chủ trong ROCK_API_KEY.
  3. Đặt ID đã sao chép vào ROCK_API_MODEL. SDK dùng URL cơ sở https://rockapi.ai/v1; curl gọi điểm cuối đầy đủ bên dưới.
  4. Bắt đầu bằng văn bản ngắn trước khi thêm công cụ, hình ảnh hoặc truyền luồng.
Cần đặt cả hai biến trong môi trường cục bộ trước khi chạy. ID phụ thuộc danh mục và quyền tài khoản; ví dụ không cam kết một mô hình cụ thể luôn khả dụng. Người mua chỉ cần khóa nền tảng và mô hình có quyền truy cập, không cần cấu hình kênh nhà cung cấp phía trên.

​
Kiểm tra phản hồi và khoản phí cuối cùng

Xem trạng thái HTTP, nội dung, mô hình và thông tin sử dụng trả về. Tìm bản ghi tương ứng trong bảng điều khiển để đối chiếu nhóm, loại sử dụng và mức tiêu thụ đã quyết toán. Hướng dẫn tính phí phân biệt tính theo sử dụng, theo lượt và động. Khoản tạm giữ có thể khác phí cuối cùng; không có mức giảm cố định áp dụng cho mọi mô hình. Với 401 hoặc 403, kiểm tra khóa và quyền; với 400 hoặc 404, kiểm tra mô hình, nội dung và đường dẫn. Với 429, xem hạn mức và giới hạn tốc độ trước khi thử lại. Giữ thời điểm và ID yêu cầu nếu có, loại bỏ bí mật rồi tra lỗi và giới hạn. Khi yêu cầu tối thiểu thành công, dùng hướng dẫn kiểm nhận khi chuyển API để thử tính năng ứng dụng thực sự sử dụng. Đọc bảo mật và quyền riêng tư cùng điều khoản áp dụng trước khi gửi dữ liệu riêng qua một bên trung gian mới.