KIẾN THỨC CƠ BẢN

Tham khảo API

Xác thực ứng dụng, tạo văn bản và hình ảnh, tạo embeddings, và tự động hóa quy trình làm việc của nhà cung cấp, thiết bị và người sáng tạo.

Xem dưới dạng Markdown

Bắt đầu tại đâyChọn API phù hợp và hiểu các lỗi chung.Nhà phát triểnỦy quyền ứng dụng, giới hạn chi tiêu của khách hàng, khôi phục hóa đơn và tích hợp suy luận.Nhà cung cấpQuản lý danh mục provider và giá cả, sau đó kiểm soát từng thiết bị riêng lẻ.Người sáng tạoXác thực creator, bộ sưu tập, gói model và thẻ.

Thực hiện yêu cầu API đầu tiên của bạn

Tạo một khóa API ShareAI, chọn một mô hình sẵn có và gửi yêu cầu trò chuyện từ máy chủ của bạn với xác thực Bearer.

Chọn API và thông tin xác thực phù hợp

Tìm các điểm cuối API của ShareAI cho Xác thực ứng dụng, trò chuyện, Phản hồi, nhúng, hình ảnh, Nhà cung cấp, Thiết bị và Người sáng tạo, với URL và thông tin xác thực chính xác.

Đăng ký ứng dụng của bạn

Tạo một ứng dụng, chọn mô hình triển khai của nó và chỉ kích hoạt các khả năng của ShareAI mà ứng dụng cần.

Ủy quyền tài khoản với PKCE

Sử dụng mã ủy quyền cùng với S256 PKCE cho các ứng dụng công khai và bảo mật.

Chọn phạm vi Đăng nhập, Thanh toán và AI

Đăng nhập, thanh toán sản phẩm và phụ phí suy luận yêu cầu các khả năng riêng biệt và sự ủy quyền của khách hàng.

Làm mới mã truy cập

Xoay vòng mã làm mới mà không mở rộng phạm vi được ủy quyền của khách hàng.

Đọc danh tính và khám phá các điểm cuối Auth

Sử dụng ShareAI Auth discovery, JWKS và UserInfo để xác thực đăng nhập ứng dụng và đọc danh tính được phép bởi một OAuth access token.

Thu hồi mã và kiểm tra ủy quyền phía máy chủ

Thu hồi các mã truy cập và làm mới không sử dụng. Các tích hợp bảo mật cũng có thể kiểm tra trạng thái mã.

Hiểu các thỏa thuận thanh toán được chấp nhận

Giữ giá đăng ký, khoảng thời gian và phụ phí AI gắn liền với các điều khoản mà mỗi khách hàng đã chấp nhận.

Tạo một hoàn thành hội thoại

Gửi yêu cầu hoàn thành trò chuyện ShareAI với khóa API Bearer và hiểu các mô hình được hỗ trợ, tin nhắn và trường luồng.

Gửi yêu cầu hội thoại với OAuth

Sử dụng một mã thông báo truy cập OAuth ShareAI đã được phê duyệt cho các hoàn thành trò chuyện do khách hàng tài trợ và xử lý hết hạn mã thông báo, sự đồng ý và ranh giới tài khoản.

Truyền phát phản hồi hội thoại

Đọc các sự kiện server-sent của ShareAI chat-completions, nối các delta nội dung một lần và xử lý hoàn tất, lỗi và luồng bị gián đoạn.

Kiểm tra quyền truy cập khóa và danh tính tài khoản

Đọc thông tin khóa API ShareAI để kiểm tra các hạn chế của mô hình và nhà cung cấp cũng như danh tính tài khoản liên kết với thông tin xác thực suy luận.

Tạo phản hồi văn bản

Sử dụng API Phản hồi ShareAI để tạo văn bản không trạng thái, lịch sử hội thoại rõ ràng và các sự kiện phát trực tuyến Phản hồi.

Tạo nhúng văn bản

Tạo nhúng văn bản với ShareAI để tìm kiếm ngữ nghĩa, truy xuất và tương đồng, với các định dạng đầu vào được hỗ trợ và yêu cầu mô hình.

Tạo một hình ảnh

Tạo hình ảnh với API Hình ảnh ShareAI bằng cách sử dụng mô hình được hỗ trợ, lời nhắc văn bản và các tùy chọn tạo hình ảnh đã được xác thực.

Xác thực API Nhà cung cấp

Kích hoạt Truy cập Từ xa Nhà cung cấp và sử dụng UUID nhà cung cấp cùng mã thông báo truy cập giới hạn để yêu cầu danh mục và giá cả.

Liệt kê các mô hình nhà cung cấp và mạng lưới

Đọc danh mục mạng ShareAI Provider API, danh mục nhà cung cấp của bạn và chi tiết chính xác của mô hình bằng cách sử dụng provider_models:read.

Cập nhật giá mô hình nhà cung cấp

Đặt các mức giá đầu vào, đầu ra và bộ nhớ cache của mô hình nhà cung cấp ShareAI bằng token API Nhà cung cấp được phân phạm vi và một identifier mô hình chính xác.

Xác thực API Thiết bị

Tạo một token Điều khiển Từ xa dành riêng cho thiết bị và hiểu các kiểm tra nhà cung cấp, thiết bị và trạng thái được kích hoạt cho các yêu cầu API Thiết bị ShareAI.

Đọc phiên thiết bị và lịch sử tác vụ

Liệt kê các phiên thiết bị ShareAI và kiểm tra lịch sử tác vụ của một phiên bằng token Điều Khiển Từ Xa dành riêng cho thiết bị.

Bắt đầu và dừng chia sẻ thiết bị

Gửi các lệnh chia sẻ thiết bị ShareAI, phân biệt các lệnh được chấp nhận với trạng thái quan sát được và xác minh kết quả trong Console.

Xác thực API Người sáng tạo

Sử dụng thông tin đăng nhập Remote Access theo phạm vi của Creator và hiểu các phạm vi collection, model và settings có sẵn trong ShareAI Creator API.

Đọc và quản lý bộ sưu tập mô hình

Liệt kê, tạo và cập nhật các collection model của ShareAI Creator với các phạm vi yêu cầu và ranh giới quyền sở hữu và xem xét rõ ràng.

Tạo một gói mô hình

Tạo siêu dữ liệu mô hình ShareAI Creator, một bộ sưu tập và các thẻ mô hình cùng nhau, với chính sách truy cập rõ ràng và thông tin xác thực API được giới hạn phạm vi.

Quản lý các mô hình trong một bộ sưu tập

Liệt kê, đọc, tạo và cập nhật các thẻ mô hình của ShareAI Creator trong khi bảo toàn quyền sở hữu bộ sưu tập và chính sách phục vụ hiệu quả của chúng.

Xử lý lỗi API và thử lại

Chẩn đoán lỗi xác thực, phạm vi, truy cập mô hình và khả dụng của ShareAI mà không ghi đè trùng lặp hoặc thử lại làm mới không an toàn.

Hiểu về người tạo mô hình, định danh và thẻ

Chọn mã định danh mô hình ShareAI dựa trên Creator chính xác, khám phá họ của nó và so sánh các nhà cung cấp có thể chạy nó.

Chọn nhà cung cấp thực thi cho một yêu cầu API

Sử dụng đối tượng nhà cung cấp ShareAI để chọn nhà cung cấp thực thi độc lập với Creator của mô hình trên tất cả bốn điểm cuối suy luận.

Tham chiếu chính sách nhà cung cấp

Tham khảo các trường, mặc định, giới hạn và lỗi của nhà cung cấp ShareAI để chọn nhà cung cấp thực thi trong các yêu cầu suy luận.

Sắp xếp nhà cung cấp và kiểm soát dự phòng

Hiểu xếp hạng giá, độ trễ và thông lượng của ShareAI, nhà cung cấp được sắp xếp, các phép đo không khả dụng và giới hạn dự phòng an toàn.

Hiểu danh tính của khách hàng

Mỗi OAuth client nhận một định danh khác nhau cho cùng một khách hàng ShareAI.

Thanh toán cho sản phẩm và đăng ký

Tạo thanh toán ví, để khách hàng xác nhận trong ShareAI, sau đó xác minh kết quả đã thanh toán trước khi thực hiện.

Xử lý lỗi thanh toán và giới hạn chi tiêu của khách hàng

Phân biệt giữa tín dụng không đủ và giới hạn chi tiêu của ứng dụng, cung cấp liên kết khôi phục nhận biết vai trò và xử lý đúng các lỗi phát trực tuyến.