Điểm chính
- API không kiểm duyệt tuân theo cú pháp OpenAI tiêu chuẩn nhưng thiếu các tính năng nâng cao như embedding hoặc định tuyến nhiều mô hình, vì vậy client của bạn phải được cấu hình cho một endpoint duy nhất.
- Các phản hồi truyền phát yêu cầu xử lý SSE cụ thể; nếu SDK của bạn mặc định phân tích cú pháp JSON, bạn sẽ gặp lỗi phân tích cú pháp trên các đầu ra không kiểm duyệt lớn.
- Gọi hàm hoạt động nhưng yêu cầu tuân thủ nghiêm ngặt lược đồ JSON vì mô hình có thể bịa đặt đối số thường xuyên hơn các mô hình đã tinh chỉnh chỉ dẫn.
- Bạn bị giới hạn ở 300 yêu cầu mỗi phút và kích thước thân 8MB, điều này đòi hỏi các chiến lược nhóm cẩn thận cho các ứng dụng có khối lượng lớn.
Hiểu về Endpoint API AI không kiểm duyệt
Khi tích hợp API AI không kiểm duyệt, sai lầm đầu tiên là giả định nó hoạt động giống hệt các mô hình thương mại tiêu chuẩn. Endpoint của chúng tôi là một dịch vụ chat-completions tương thích OpenAI được lưu trữ. Nó phục vụ một mô hình ngôn ngữ lớn không kiểm duyệt chuyên dụng duy nhất. Điều này có nghĩa là bạn không cần quản lý định tuyến mô hình hoặc phiên bản. Bạn gửi yêu cầu đến POST /v1/chat/completions và nhận lại văn bản.
Khác với các bộ tổng hợp gói hình ảnh, video và nhiều nhà cung cấp, dịch vụ này tập trung hoàn toàn vào việc tạo văn bản không giới hạn hiệu suất cao. Mô hình là mô hình trọng số mở và được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp. Tuy nhiên, nó không phải là GPT, Claude, Gemini hoặc bất kỳ mô hình của nhà cung cấp nào khác. Nó chạy trên các máy chủ GPU của chúng tôi.
Base URL là https://api.uncensoredgptapi.com/v1. Để sử dụng nó, bạn thay đổi base_url trong các SDK OpenAI hiện có hoặc bất kỳ client tương thích OpenAI nào và cung cấp khóa API của bạn. Model ID bạn phải gửi chỉ đơn giản là "uncensored". Sự đơn giản này giảm thời gian tích hợp nhưng yêu cầu bạn xác minh rằng client của bạn có thể xử lý một endpoint mô hình đơn mà không mong đợi các fallback.
Các lỗi xác thực phổ biến
Các lỗi xác thực thường bắt nguồn từ các tiêu đề được cấu hình sai hoặc khóa hết hạn. API sử dụng xác thực token Bearer tiêu chuẩn. Bạn phải bao gồm khóa API của mình trong tiêu đề Authorization cho mọi yêu cầu.
Một lỗi phổ biến là lưu trữ khóa API mà không xác minh tính hợp lệ của nó. Nếu bạn tạo lại khóa, khóa cũ sẽ bị thu hồi ngay lập tức. Bạn phải cập nhật cấu hình client của mình để sử dụng khóa mới. Nếu bạn nhận được lỗi 401 Unauthorized, hãy kiểm tra hai điều: đầu tiên, đảm bảo khóa được sao chép chính xác mà không có khoảng trắng dẫn hoặc theo sau. Thứ hai, xác minh rằng bạn đang sử dụng base URL chính xác. Ngay cả một sự sai lệch nhỏ trong tên miền hoặc đường dẫn cũng sẽ dẫn đến lỗi xác thực.
Một vấn đề thường xuyên khác là sử dụng model ID sai. Endpoint mong đợi "uncensored". Nếu bạn gửi "gpt-4" hoặc một model ID tiêu chuẩn khác, endpoint có thể từ chối yêu cầu hoặc trả về lỗi vì nó chỉ phục vụ một mô hình. Luôn kiểm tra kỹ trường model trong tải trọng yêu cầu của bạn.
curl https://api.uncensoredgptapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'Xử lý đúng các phản hồi truyền phát
Các phản hồi truyền phát qua Server-Sent Events (SSE) được hỗ trợ nhưng thường bị xử lý sai bởi các nhà phát triển quen với các phản hồi JSON đồng bộ. Khi bạn đặt "stream": true trong yêu cầu của mình, API trả về một luồng các đối tượng JSON riêng lẻ, không phải một phản hồi JSON hoàn chỉnh duy nhất.
Nếu client của bạn cố gắng phân tích cú pháp toàn bộ phản hồi dưới dạng JSON cùng một lúc, nó sẽ thất bại. Bạn phải đọc luồng từng dòng. Mỗi dòng bắt đầu bằng data: và chứa một đối tượng JSON riêng lẻ. Dòng cuối cùng là data: [DONE]. Mã của bạn nên tổng hợp các chunk này để tái tạo văn bản cuối cùng.
Một số SDK xử lý điều này một cách tự động, nhưng các triển khai tùy chỉnh cần phân tích cú pháp SSE rõ ràng. Đảm bảo bộ đệm client của bạn có thể xử lý các đầu ra lớn mà không bị hết thời gian chờ. Mô hình không kiểm duyệt có thể tạo ra các phản hồi dài, và truyền phát giúp quản lý việc sử dụng bộ nhớ. Nếu bạn gặp phải các kết nối bị ngắt, hãy cân nhắc triển khai backoff theo cấp số nhân cho logic thử lại.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)Lỗi cấu hình gọi hàm
Gọi hàm được hỗ trợ, nhưng mô hình không kiểm duyệt có thể bịa đặt đối số thường xuyên hơn các mô hình đã tinh chỉnh chỉ dẫn. Điều này yêu cầu xác thực nghiêm ngặt hơn từ phía bạn. Khi xác định các công cụ, hãy đảm bảo lược đồ JSON của bạn chính xác. Mô hình sẽ cố gắng điền vào các đối số, nhưng nó có thể bỏ qua các trường bắt buộc hoặc cung cấp các loại không chính xác.
Luôn xác thực các đối số gọi công cụ trước khi thực hiện hàm. Nếu mô hình trả về JSON không hợp lệ cho các đối số, bạn phải xử lý lỗi một cách nhẹ nhàng. Đừng giả định rằng đầu ra sẽ được cấu trúc hoàn hảo. Bạn có thể cần triển khai cơ chế thử lại hoặc bước xử lý sau để làm sạch các đối số.
Ngoài ra, hãy lưu ý rằng mô hình không kiểm duyệt có thể bỏ qua các định nghĩa công cụ nếu prompt phức tạp. Nếu bạn gặp vấn đề, hãy đơn giản hóa các mô tả công cụ và đảm bảo prompt hệ thống hướng dẫn rõ ràng mô hình sử dụng các công cụ khi thích hợp. Hãy thử nghiệm với một vài đầu vào mẫu để xác minh hành vi.
Giới hạn cửa sổ ngữ cảnh (100k token)
API không kiểm duyệt hỗ trợ cửa sổ ngữ cảnh 100,000 token, kết hợp cả prompt và completion. Điều này lớn hơn đáng kể so với nhiều mô hình tiêu chuẩn, cho phép các cuộc hội thoại rộng rãi hoặc xử lý tài liệu lớn. Tuy nhiên, nó không phải là vô hạn. Nếu đầu vào của bạn vượt quá giới hạn này, API sẽ trả về lỗi.
Để tránh chạm vào giới hạn này, hãy theo dõi việc sử dụng token của bạn. Hầu hết các SDK đều cung cấp các tiện ích để đếm token. Hãy theo dõi số token tích lũy trong lịch sử hội thoại của bạn. Nếu bạn đang xử lý các tài liệu lớn, hãy cân nhắc chia nhỏ chúng hoặc tóm tắt các phần trước của cuộc hội thoại để giải phóng không gian ngữ cảnh.
Hãy nhớ rằng cửa sổ ngữ cảnh bao gồm tất cả các messages trong mảng messages. Mỗi message đóng góp vào tổng số. Nếu bạn gửi nhiều message nhỏ, chi phí bổ sung có thể tích lũy. Hãy tối ưu hóa cấu trúc prompt của bạn để giảm thiểu các token không cần thiết. Ví dụ, tránh lặp lại các chỉ dẫn hệ thống trong mỗi lượt nếu chúng không thay đổi.
Giải thích giới hạn tốc độ (300 RPM)
API áp dụng giới hạn tốc độ 300 yêu cầu mỗi phút cho mỗi khóa. Đây là giới hạn cứng để đảm bảo sử dụng công bằng cho tất cả người dùng. Nếu bạn vượt quá giới hạn này, bạn sẽ nhận được lỗi 429 Too Many Requests. Client của bạn nên xử lý điều này bằng cách triển khai chiến lược thử lại.
Một lỗi phổ biến là không tính đến lưu lượng truy cập burst. Nếu bạn gửi 300 yêu cầu liên tiếp, bạn có thể chạm vào giới hạn ngay cả khi tốc độ trung bình của bạn thấp hơn. Hãy trải đều các yêu cầu của bạn trong suốt một phút. Nếu bạn đang xử lý một bộ dữ liệu lớn, hãy cân nhắc nhóm các yêu cầu hoặc sử dụng hàng đợi để quản lý luồng.
Giới hạn tốc độ được áp dụng cho từng khóa API. Nếu bạn có nhiều dịch vụ sử dụng cùng một khóa, chúng chia sẻ giới hạn. Để tăng dung lượng, bạn có thể tạo một khóa mới, nhưng lưu ý rằng chỉ một khóa là hoạt động cho mỗi tài khoản. Bạn có thể tạo lại khóa bất cứ lúc nào, nhưng điều này sẽ thu hồi khóa cũ, vì vậy hãy đảm bảo tất cả các client được cập nhật.
Giới hạn kích thước thân yêu cầu (8MB)
Mỗi thân yêu cầu được giới hạn ở 8 MB. Giới hạn này áp dụng cho tải trọng JSON, bao gồm mảng messages và bất kỳ định nghĩa công cụ nào. Nếu yêu cầu của bạn vượt quá kích thước này, API sẽ từ chối nó với lỗi 413 Payload Too Large.
Giới hạn này rất quan trọng khi gửi các tệp lớn dưới dạng dữ liệu được mã hóa base64 hoặc khi bao gồm lịch sử hội thoại rộng rãi. Nếu bạn đang làm việc với các tài liệu lớn, hãy cân nhắc nén văn bản hoặc loại bỏ khoảng trắng không cần thiết trước khi gửi. Bạn cũng có thể sử dụng truyền phát để giảm việc sử dụng bộ nhớ, nhưng thân yêu cầu ban đầu vẫn phải nằm trong giới hạn 8 MB.
Theo dõi kích thước yêu cầu của bạn trong quá trình phát triển. Nếu gặp lỗi này, hãy kiểm tra cấu trúc prompt và loại bỏ mọi thông tin thừa. Ví dụ: nếu bạn đang bao gồm toàn bộ prompt hệ thống trong mỗi tin nhắn, hãy chuyển nó vào vai trò system một lần và tham chiếu đến nó.
Quản lý và tạo lại khóa API
Mỗi tài khoản được giới hạn một khóa API. Khóa này được tạo trong quá trình đăng ký và được hiển thị ngay lập tức. Bạn có thể tạo lại khóa bất cứ lúc nào từ bảng điều khiển của mình. Khi bạn tạo lại, khóa cũ sẽ bị thu hồi ngay lập tức. Bất kỳ client nào sử dụng khóa cũ sẽ nhận được lỗi 401 Unauthorized.
Để quản lý hiệu quả, hãy cập nhật tất cả ứng dụng khách của bạn trước khi tạo lại khóa. Nếu bạn có nhiều dịch vụ hoặc thiết bị đang sử dụng khóa, hãy đảm bảo chúng được cập nhật đồng thời. Bạn có thể tạo khóa mới bao nhiêu lần tùy thích, nhưng chỉ một khóa sẽ hoạt động tại một thời điểm.
Khóa API được liên kết với email và mật khẩu của bạn. Nếu bạn mất khóa, bạn có thể tạo lại nó. Không có giới hạn về số lần tạo lại. Tuy nhiên, việc tạo lại thường xuyên có thể cho thấy một mối lo ngại về bảo mật, vì vậy hãy sử dụng nó khi cần thiết. Hãy giữ khóa của bạn an toàn và không chia sẻ nó công khai.
Khắc phục sự cố bộ lọc nội dung
Mô hình không kiểm duyệt không từ chối các chủ đề người trưởng thành hợp pháp, hư cấu, nghiên cứu bảo mật hoặc gây tranh cãi. Tuy nhiên, có một giới hạn nội dung cứng luôn áp dụng: không có nội dung tình dục liên quan đến trẻ vị thành niên. Các yêu cầu chứa nội dung này bị chặn.
Nếu bạn gặp từ chối không mong đợi, hãy kiểm tra prompt của bạn để tìm các dấu hiệu tinh tế của nội dung bị cấm. Mô hình được tinh chỉnh cho việc sử dụng không giới hạn, nhưng nó vẫn có thể áp dụng các bộ lọc an toàn cơ bản. Nếu bạn đang thử nghiệm với các trường hợp biên, hãy ghi lại hành vi để hiểu các giới hạn của mô hình.
Một vấn đề phổ biến khác là ảo giác. Mô hình không kiểm duyệt có thể tạo ra thông tin nghe có vẻ hợp lý nhưng không chính xác. Luôn xác minh các kết quả quan trọng, đặc biệt khi sử dụng gọi hàm hoặc tạo mã. Trong một số trường hợp, mô hình ưu tiên sự trôi chảy hơn độ chính xác về mặt sự kiện.
