Bắt đầu nhanh: Kết nối máy khách của bạn
Gửi yêu cầu đến https://api.isgeminiuncensored.com/v1 sử dụng các sdk OpenAI tiêu chuẩn. Dịch vụ của chúng tôi hoạt động như một thay thế thả vào cho các nhà cung cấp khác, vì vậy bạn chỉ cần cập nhật url cơ sở và cung cấp khóa api của bạn. Bạn có thể tạo khóa của bạn ngay lập tức qua bảng điều khiển bằng Google hoặc email. Thiết lập này loại bỏ nhu cầu về proxy phức tạp hoặc các lời nhắc vượt ngục tùy chỉnh.
Xác thực dựa trên một khóa API hoạt động duy nhất cho mỗi tài khoản. Nếu bạn tạo khóa mới, khóa trước đó sẽ không còn hợp lệ ngay lập tức. Điều này đảm bảo kiểm soát chặt chẽ việc sử dụng của bạn trong khi vẫn duy trì quyền riêng tư của dữ liệu. Các prompt của bạn không được sử dụng để huấn luyện, vì vậy các tác phẩm sáng tạo của bạn vẫn thuộc về bạn.
Yêu cầu đầu tiên: ví dụ curl
Xác minh kết nối bằng cách gửi một yêu cầu hoàn thành văn bản đơn giản. Sử dụng endpoint hoàn thành trò chuyện tiêu chuẩn với định danh mô hình uncensored. Phản hồi sẽ trả về văn bản được tạo dựa trên đầu vào của bạn mà không có các từ chối nội dung tiêu chuẩn.
Bài kiểm tra cơ bản này xác nhận rằng khóa của bạn hợp lệ và điểm cuối có thể truy cập được. Bạn sau đó có thể tích hợp mẫu này vào logic ứng dụng của mình. Cấu trúc phản ánh định dạng OpenAI, đảm bảo tương thích với hầu hết các công cụ hiện có.
curl https://api.isgeminiuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top five Linux commands for network troubleshooting."}]
}'Bắt đầu với các câu lệnh đơn giản để xác minh chất lượng đầu ra. Sau đó, bạn có thể mở rộng lên các tương tác phức tạp hơn khi cần. Hệ thống xử lý phần nặng nhọc của việc quản lý ngữ cảnh cho bạn.
Tích hợp SDK Python
Sử dụng thư viện Python chính thức để tích hợp API của chúng tôi vào các script của bạn. Đặt base URL đến điểm cuối của chúng tôi và cung cấp API key của bạn. Cách tiếp cận này cho phép bạn tận dụng các cơ sở mã hiện có với ít thay đổi nhất. Bạn có thể sử dụng streaming hoặc các lệnh gọi đồng bộ tùy thuộc vào nhu cầu của bạn.
SDK Python xử lý việc tuần tự hóa các yêu cầu của bạn một cách tự động. Bạn có thể truyền các tham số như nhiệt độ và top_p để kiểm soát đầu ra. Sự linh hoạt này cho phép bạn tinh chỉnh hành vi của mô hình cho trường hợp sử dụng cụ thể của mình. Cho dù bạn đang xây dựng bot trò chuyện hay công cụ phân tích, SDK đơn giản hóa quy trình.
from openai import OpenAI
client = OpenAI(base_url="https://api.isgeminiuncensored.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)Đảm bảo bạn xử lý các đối tượng phản hồi đúng cách. SDK trả về dữ liệu có cấu trúc mà bạn có thể phân tích dễ dàng. Điều này giúp việc gỡ lỗi và kiểm tra trở nên đơn giản. Bạn cũng có thể sử dụng các client bất đồng bộ cho các ứng dụng có thông lượng cao.
Tích hợp SDK Node
Tích hợp với các ứng dụng Node.js bằng gói npm OpenAI chính thức. Chỉ định client đến URL cơ sở của chúng tôi và đặt khóa API. Điều này cho phép bạn sử dụng các mẫu quen thuộc trong các dự án JavaScript của mình. Bạn có thể thực hiện các yêu cầu đồng bộ hoặc không đồng bộ một cách dễ dàng.
SDK Node hỗ trợ các tính năng JavaScript hiện đại như promise và async/await. Điều này giúp xử lý lỗi và phản hồi sạch sẽ. Bạn có thể truyền cùng các tham số như SDK Python để điều chỉnh hành vi của mô hình. Sự nhất quán trên các ngôn ngữ này làm giảm đường cong học tập cho các nhóm sử dụng nhiều công nghệ.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.isgeminiuncensored.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Kiểm tra tích hợp của bạn với một truy vấn đơn giản. Phản hồi sẽ xác nhận rằng thiết lập của bạn là chính xác. Sau đó, bạn có thể tiến hành xây dựng các tương tác phức tạp hơn. SDK xử lý các yêu cầu HTTP một cách hiệu quả, đảm bảo độ trễ thấp.
Phản hồi luồng
Bật chế độ streaming bằng cách đặt stream tham số thành true. Điều này cho phép bạn nhận token khi chúng được tạo. Tính năng này lý tưởng cho các giao diện trò chuyện nơi phản hồi ngay lập tức là rất quan trọng. Nó giảm đáng kể độ trễ cảm nhận cho người dùng cuối.
Phản hồi được gửi dưới dạng chuỗi sự kiện gửi máy chủ (SSE). Mỗi chunk chứa một phần văn bản được tạo. Bạn có thể nối các chunk này để tạo thành phản hồi hoàn chỉnh. Chunk cuối cùng cũng bao gồm thống kê sử dụng token để tính phí.
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)Xử lý các gián đoạn mạng một cách khéo léo. Phát trực tuyến có thể được tạm dừng hoặc tiếp tục tùy thuộc vào khả năng của máy khách của bạn. Sự linh hoạt này đảm bảo trải nghiệm người dùng mượt mà ngay cả trên các kết nối không ổn định. Bạn có thể dừng luồng sớm nếu người dùng thay đổi đầu vào của họ.
Giới hạn, Lỗi và Ngữ cảnh
Tài khoản của bạn có giới hạn tốc độ 300 yêu cầu mỗi phút và 8 yêu cầu đồng thời cho mỗi khóa. Nếu vượt quá giới hạn này, bạn sẽ nhận được lỗi 429. Bạn có thể theo dõi việc sử dụng trong bảng điều khiển để tránh gián đoạn. Giới hạn này đảm bảo quyền truy cập công bằng cho tất cả người dùng.
Hỗ trợ cửa sổ ngữ cảnh lên đến 100,000 token cho tổng prompt và kết quả kết hợp. Bạn có thể đặt đầu ra tối đa là 16,000 token mỗi yêu cầu. Nếu bạn không chỉ định giới hạn, mặc định là 2,048 token. Lỗi và từ chối không tiêu thụ tín dụng trả trước của bạn.
Các lỗi phổ biến bao gồm 401 cho khóa không hợp lệ và 402 cho tín dụng không đủ. Bạn chỉ có thể nạp thêm bằng tiền điện tử. USDT trên TRC20 hoặc USDC trên Base đều được chấp nhận. Những sai lầm như tính phí kép được sửa chữa qua Hỗ trợ. Tín dụng trả trước của bạn không bao giờ hết hạn, vì vậy bạn có thể nạp thêm theo tốc độ của mình. Cấu trúc này giúp chi phí có thể dự đoán và minh bạch.
