FAQ Uncensored API

Cơ bản

Uncensored API là gì trong một câu?

Đây là một endpoint chat completions chỉ văn bản, trả về một mô hình duy nhất, id uncensored, và không từ chối nội dung người lớn hợp pháp, tiểu thuyết hoặc các chủ đề gây tranh cãi.

Tôi gọi URL nào?

Sử dụng https://api.uncensoredapis.com/v1 làm Base URL. Yêu cầu chat gửi đến POST /v1/chat/completions và danh sách mô hình ở GET /v1/models. Bất kỳ đường dẫn nào khác sẽ trả về 404.

Tôi có phải học một SDK mới không?

Không. Cấu trúc yêu cầu và phản hồi tuân theo quy ước chat completions phổ biến, nên các gói Python và Node chính thức hoạt động sau khi bạn thay đổi Base URL và khóa. curl đơn giản cũng hoạt động, như tài liệu cho thấy.

Có cách nào dùng thử trước khi trả tiền không?

Có. Tài khoản mới nhận $0,50 tín dụng dùng thử miễn phí, có hiệu lực trong 7 ngày, và không yêu cầu thông tin thanh toán khi đăng ký. Đăng ký bằng email và mật khẩu trên trang khóa và khóa sẽ hiển thị ngay lập tức.

Tôi có thể chọn giữa nhiều mô hình không?

Không. Chỉ có chính xác một mô hình, và id của nó là uncensored. Gọi route mô hình trả về mục duy nhất này, nên không có gì để chọn hoặc chuyển đổi.

Dịch vụ này dành cho ai?

Nhà phát triển xây dựng sản phẩm cho người lớn, bao gồm công cụ tiểu thuyết, ứng dụng nhập vai và trợ lý nghiên cứu. Bạn chịu trách nhiệm về việc kiểm tra độ tuổi và quy tắc nội dung trong bất kỳ sản phẩm nào bạn phát triển dựa trên dịch vụ này.

Khóa và truy cập

Một tài khoản nhận được bao nhiêu khóa?

Một. Nếu bạn cần một giá trị mới, hãy tạo lại từ tài khoản; khóa cũ sẽ ngừng hoạt động cùng lúc, vì vậy hãy triển khai khóa thay thế ngay lập tức.

Khóa nên được lưu ở đâu?

Giữ nó trong biến môi trường hoặc trình quản lý bí mật trên máy chủ bạn kiểm soát. JavaScript trình duyệt và nhị phân di động có thể bị kiểm tra, vì vậy hãy định tuyến lưu lượng khách hàng qua backend của riêng bạn thay vì nhúng khóa.

Khóa được gửi như thế nào?

Trong tiêu đề Authorization: Bearer trên mọi yêu cầu. Giá trị thiếu hoặc sai sẽ trả về 401 với đối tượng lỗi JSON.

Tôi muốn một khóa API không kiểm duyệt cho nhóm. Chúng tôi có thể chia sẻ một khóa không?

Bạn có thể, nhưng mọi quy trình đều chia sẻ cùng mức giới hạn 300 yêu cầu mỗi phút và cùng số dư. Đặt một gateway nhỏ trước khóa và cấp cho mỗi đồng nghiệp quyền truy cập vào gateway thay vì khóa.

Giới hạn và giá cả

Prompt có thể lớn đến mức nào?

Cửa sổ ngữ cảnh là 100.000 token, dùng chung cho prompt và kết quả. Thân của một yêu cầu đơn lẻ không được vượt quá 8 MB. Một yêu cầu mà prompt cộng với max_tokens sẽ vượt quá cửa sổ sẽ bị từ chối bằng mã 400.

Phản hồi có thể dài bao lâu?

Giá trị mặc định là 2048 token. Bạn có thể tăng max_tokens lên tối đa 32.000 cho mỗi yêu cầu. Khi câu trả lời dừng do giới hạn, finish_reason có giá trị length.

Chi phí là bao nhiêu?

Token đầu vào là $0,25 trên mỗi triệu và token đầu ra là $1,00 trên mỗi triệu. Số dư là trả trước, không có gói đăng ký và số dư không bao giờ hết hạn. Xem trang giá cả để biết bảng.

Bạn có thể đưa ra ước tính nhanh không?

Giả sử một lượt trò chuyện với 1.500 token prompt và 300 token hoàn thành, chỉ để minh họa. Đó là $0,000375 cho đầu vào cộng với $0,0003 cho đầu ra, hoặc khoảng $0,000675 cho mỗi lượt, vì vậy $1 mua được khoảng 1.480 lượt như vậy.

Điều gì xảy ra khi tôi gửi quá nhiều yêu cầu?

Mỗi khóa có thể thực hiện 300 yêu cầu mỗi phút. Vượt quá giới hạn đó, bạn sẽ nhận được lỗi 429, và phản hồi đúng là giảm tốc độ và thử lại với độ trễ.

Câu hỏi tích hợp

Tôi có thể đặt những tham số lấy mẫu nào?

Các tham số tiêu chuẩn như temperature, top_p và stop được truyền trực tiếp vào quá trình sinh. Bạn hãy đặt chúng trong thân yêu cầu chính xác như cách bạn vẫn làm ở nơi khác.

API có nhớ các lượt hội thoại trước đó của tôi không?

Không. Mỗi yêu cầu là độc lập, vì vậy bạn phải gửi lại toàn bộ cuộc hội thoại trong messages mỗi lần. Hãy cắt bỏ các lượt hội thoại cũ nhất khi tổng số token tiến gần đến cửa sổ ngữ cảnh 100.000 token.

Tôi có thể truyền phát token về trình duyệt không?

Có, hãy gửi stream: true và đọc các sự kiện do máy chủ gửi (SSE). Hãy thực hiện từ máy chủ backend của bạn và chuyển tiếp văn bản đến trang web, để khóa API không bao giờ tiếp cận phía máy khách (client).

Có hỗ trợ tin nhắn hệ thống không?

Có. Đặt một tin nhắn với vai trò system đầu tiên trong mảng để thiết lập tông giọng, định dạng và ranh giới cho cuộc trò chuyện.

Tôi nên kiểm tra gì đầu tiên khi kết quả bị cắt ngang?

Hãy đọc finish_reason. Giá trị length có nghĩa là đã đạt giới hạn, vì vậy hãy tăng max_tokens hoặc rút ngắn prompt. Danh sách tất cả các giá trị có trong reference.

Số dư và thanh toán

Tôi nạp tiền như thế nào?

Bạn hãy nạp tiền vào số dư trả trước từ tài khoản của mình. Không có gói đăng ký nào, và số dư chưa sử dụng vẫn khả dụng vì nó không bao giờ hết hạn.

Điều gì xảy ra khi tín dụng dùng thử miễn phí hết?

Tín dụng dùng thử miễn phí có giá trị trong 7 ngày. Sau khi nó được sử dụng hết hoặc hết hạn, các yêu cầu sẽ trả về mã 402 với mã lỗi no_credit cho đến khi bạn nạp tiền vào số dư.

Tôi có thể xem chi phí của một yêu cầu không?

Mỗi phản hồi đều bao gồm một khối usage chứa thông tin về token prompt, token hoàn thành và tổng số token. Hãy nhân các con số này với giá trên mỗi triệu token để tính phí, và hãy tự theo dõi nếu bạn muốn có sổ cái.

Các yêu cầu bị lỗi có được thử lại miễn phí không?

Bạn có thể thử lại, nhưng hãy giới hạn số lần. Hãy dùng thời gian chờ tăng dần ngắn cho 429 và 503, và không lặp lại với 400, 401, 402 hoặc 403 vì chúng sẽ không tự sửa được. sách hướng dẫn lỗi có sẵn chính sách cho trường hợp này.

Nội dung và hành vi

Mô hình sẽ không làm gì?

Nội dung người lớn hợp pháp không bị từ chối, cũng như các chủ đề hư cấu hoặc gây tranh cãi. Ngoại lệ duy nhất là bất kỳ nội dung tình dục nào liên quan đến trẻ vị thành niên, sẽ bị chặn bằng mã 403 mỗi lần, bao gồm cả trong truyện và nhập vai. Dịch vụ này dành cho người từ 18 tuổi trở lên.

Các prompt của tôi có được dùng để huấn luyện mô hình không?

Không. Các prompt không được dùng để huấn luyện.

Điều này khác với việc định tuyến qua một nhà cung cấp trung gian (aggregator) như thế nào?

Bộ tổng hợp chuyển tiếp yêu cầu của bạn đến nhiều mô hình, mỗi mô hình có quy tắc riêng. Dịch vụ này là một mô hình nằm sau một chính sách. Hướng dẫn Uncensored OpenRouter phân tích chi tiết sự so sánh đó.

Nó có thể xem hình ảnh hoặc tạo embedding không?

Không. Nó chỉ xử lý văn bản, không có embedding, hình ảnh, âm thanh, video hoặc tinh chỉnh (fine-tuning).

Xử lý sự cố

Tôi nhận được mã 402 với lỗi no_credit. Bây giờ phải làm sao?

Số dư của bạn đã hết hoặc thời gian dùng thử đã hết hạn. Hãy nạp tiền vào số dư trả trước và gửi lại yêu cầu.

Một yêu cầu trả về mã 503 upstream_busy.

Nó mang tính tạm thời. Hãy đợi vài giây rồi thử lại, sử dụng độ trễ tăng dần và một chút ngẫu nhiên nếu bạn đang chạy nhiều tác vụ.

Luồng truyền của tôi kết thúc và tôi không thể tìm thấy số lượng token.

Khi bật streaming, một chunk cuối cùng chứa usage sẽ được thêm tự động, ngay trước data: [DONE]. Danh sách choices của nó trống, vì vậy hãy kiểm tra điều này trước khi đánh chỉ mục.

Các công cụ và gọi hàm có hoạt động không?

Có, theo định dạng tiêu chuẩn: hãy truyền một mảng tools và tìm kiếm tool_calls trong phản hồi.