Hướng dẫn tích hợp từng bước của API LLM uncensored.com

Điều kiện tiên quyết: SDK và Thiết lập Môi trường

Cài đặt SDK ngôn ngữ ưa thích của bạn để giao tiếp với endpoint. Hầu hết các nhà phát triển sử dụng SDK OpenAI chính thức cho Python, Node.js hoặc Go. Điều này hoạt động vì API tuân theo lược đồ hoàn thành chat tiêu chuẩn của OpenAI.

Đảm bảo môi trường của bạn có Python 3.8+ hoặc Node.js 18+. Cài đặt gói qua pip hoặc npm. Bạn sẽ cần một API key từ bảng điều khiển. Không cần số điện thoại để đăng ký.

• Python: pip install openai
• Node.js: npm install openai

Lưu khóa API của bạn vào biến môi trường. Điều này ngăn ngừa việc vô tình làm lộ khóa trong hệ thống kiểm soát phiên bản. Khóa cho phép truy cập vào mô hình không kiểm duyệt.

Cấu hình URL cơ sở

Điểm SDK client của bạn đến URL gốc chính xác. Đây là bước quan trọng nhất để tích hợp thành công. URL gốc OpenAI mặc định sẽ không hoạt động cho dịch vụ này.

Đặt URL cơ sở thành HTTPS://api.uncensoredaicom.com/v1. Điều này hướng các yêu cầu đến cơ sở hạ tầng LLM không kiểm duyệt. Id mô hình bạn phải gửi là "uncensored". Đây là một mô hình trọng lượng mở được tinh chỉnh để từ chối tối thiểu.

Xác minh kết nối bằng cách gọi điểm cuối models. Điều này xác nhận thông tin xác thực và URL gốc của bạn là chính xác. Phản hồi thành công trả về id mô hình và loại đối tượng.

Xác thực và Thiết lập Header

Đặt khóa API của bạn trong tiêu đề Authorization. Sử dụng lược đồ Bearer cho tất cả các yêu cầu. Tiêu đề này xác thực tài khoản tín dụng trả trước của bạn.

Đặt tiêu đề (header) như sau: Authorization: Bearer YOUR_API_KEY. SDK tự động xử lý điều này nếu bạn chuyển khóa vào hàm tạo client. Đảm bảo không có khoảng trắng thừa. Khóa không hợp lệ sẽ trả về lỗi 401 Unauthorized.

Bạn nhận được một khóa hoạt động cho mỗi tài khoản. Tạo khóa mới sẽ vô hiệu hóa khóa trước đó. Điều này đơn giản hóa việc xoay khóa và quản lý bảo mật. Giữ khóa của bạn an toàn trong môi trường triển khai của bạn.

Gửi Yêu cầu Trò chuyện Tiêu chuẩn

Gửi yêu cầu POST đến /v1/chat/completions. Gửi tin nhắn của bạn dưới dạng mảng các đối tượng role và content. Hệ thống hỗ trợ các vai trò user, assistant và system.

Cấu trúc ví dụ: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API trả về phần hoàn thiện văn bản. Cửa sổ ngữ cảnh là 100.000 token tổng cộng. Đầu ra tối đa là 16.000 token cho mỗi yêu cầu.

Lỗi và từ chối không tiêu thụ tín dụng. Điều này bảo vệ số dư tín dụng trả trước của bạn. Đặt temperature và top_p để kiểm soát. Các giá trị mặc định hoạt động cho hầu hết các trường hợp sử dụng.

Bật Streaming cho Đầu Ra Theo Thời Gian Thực

Đặt stream: true trong thân yêu cầu của bạn. Điều này kích hoạt Sự kiện được gửi bởi máy chủ (SSE). Token đến tăng dần thay vì chờ đợi phần hoàn chỉnh đầy đủ.

Phân tích luồng SSE để hiển thị văn bản theo thời gian thực. Chunk cuối cùng chứa thống kê sử dụng token. Điều này cho phép theo dõi tính phí chính xác. Luồng giảm độ trễ cảm nhận đối với người dùng cuối.

Xử lý các gián đoạn mạng một cách khéo léo. Kết nối lại nếu luồng bị ngắt. API không kiểm duyệt hỗ trợ phát trực tuyến ổn định. Theo dõi trạng thái kết nối. Sử dụng điều này cho các giao diện trò chuyện hoặc tạo nội dung dài.

Sử dụng Công cụ và Function Calling

Định nghĩa các công cụ trong thân yêu cầu. Truyền một danh sách các lược đồ hàm. Mô hình có thể gọi các hàm này dựa trên ý định của người dùng. Điều này cho phép hành vi giống như tác nhân.

Chỉ định tool_choice để kiểm soát việc chọn hàm. Sử dụng auto cho phát hiện tự động. API hỗ trợ các định nghĩa công cụ tiêu chuẩn. Phân tích các đối số gọi hàm từ phản hồi.

Triển khai thực thi hàm trong mã của bạn. Gửi kết quả lại dưới dạng tin nhắn. Mô hình tiếp tục cuộc hội thoại. Điều này cho phép các quy trình làm việc phức tạp. Kiểm tra đảm bảo phân tích đối số chính xác.

Xử lý Phản hồi Chế độ JSON

Đặt response_format: {"type": "json_object"}. Điều này buộc mô hình xuất ra JSON hợp lệ. Sử dụng điều này cho việc trích xuất dữ liệu có cấu trúc. Nó ngăn chặn các lỗi phản hồi bị lỗi cú pháp.

Phân tích chuỗi JSON trong mã của bạn. Xử lý các lỗi phân tích tiềm ẩn. Chế độ JSON cải thiện độ tin cậy cho các tích hợp API. Nó lý tưởng cho các quy trình xử lý dữ liệu.

Kết hợp chế độ JSON với prompt hệ thống. Hướng dẫn mô hình xuất ra các lược đồ cụ thể. Điều này đảm bảo định dạng nhất quán. Xác thực đầu ra trước khi sử dụng. Điều này giảm lỗi ở các quy trình xử lý dữ liệu.

Giới hạn và Lỗi khi Giám sát

Hãy tôn trọng các giới hạn tốc độ. Bạn được 300 yêu cầu mỗi phút trên mỗi khóa. Tối đa 8 yêu cầu đồng thời. Kích thước thân yêu cầu giới hạn ở 8 MB.

Theo dõi mã trạng thái HTTP. 429 cho biết vượt quá giới hạn tốc độ. 400 cho biết yêu cầu không hợp lệ. 500 cho biết lỗi máy chủ. Triển khai cơ chế backoff theo cấp số nhân cho các lần thử lại. Điều này ngăn chặn việc làm quá tải API.

Theo dõi mức sử dụng token trong chunk streaming cuối cùng. Điều này giúp quản lý credit trả trước của bạn. Lỗi không tiêu thụ token. Điều này bảo vệ số dư của bạn. Giám sát thường xuyên đảm bảo hoạt động trơn tru.

Tính toán chi phí và việc sử dụng token

Giá cả minh bạch và trả trước. Token đầu vào tốn $0.15 cho mỗi triệu token. Token đầu ra tốn $0.50 cho mỗi triệu token. Tín dụng không bao giờ hết hạn. Không áp dụng phí hàng tháng.

Nạp tiền bằng crypto duy nhất. USDT (TRC20) hoặc USDC (Base). Các khoản từ $20 đến $500. Credit bonus được áp dụng cho các khoản nạp lớn hơn. +5% từ $50, +10% từ $100, +15% từ $200.

Tính chi phí trước khi sử dụng nặng. Ước tính số lượng token cho các lời nhắc của bạn. Điều này giúp lập ngân sách hiệu quả. Lỗi miễn phí. Hoàn tiền không được cấp, nhưng sai sót sẽ được sửa. Sử dụng bảng điều khiển để theo dõi chi tiêu.