Dolphin không kiểm duyệt API Tài liệu
Dolphin không kiểm duyệt cung cấp API tương thích OpenAI cho phép bạn thay đổi base_url và bắt đầu tạo văn bản ngay lập tức. Hướng dẫn nhanh này sẽ hướng dẫn bạn các bước chính xác để kết nối mã hiện có của bạn với điểm cuối được lưu trữ của chúng tôi.
Điều kiện tiên quyết và Thiết lập môi trường
Bắt đầu bằng cách đảm bảo môi trường của bạn đã cài đặt các phụ thuộc cần thiết trước khi gửi bất kỳ yêu cầu nào. Bạn sẽ cần một khóa API hoạt động từ bảng điều khiển của chúng tôi và một môi trường chạy được hỗ trợ như Python hoặc Node.js. API của chúng tôi yêu cầu bạn gửi yêu cầu đến một URL cơ bản cụ thể thay vì điểm cuối OpenAI mặc định.
Giữ khóa API của bạn an toàn và lưu trữ nó trong biến môi trường. Điều này ngăn ngừa việc lộ thông tin vô tình trong kho lưu trữ mã của bạn. Bạn có thể tạo khóa mới ngay lập tức sau khi đăng ký bằng Google hoặc email.
Bạn không cần cấu hình định tuyến phức tạp hoặc chọn các mô hình cụ thể. Điểm cuối phục vụ một mô hình ngôn ngữ lớn không kiểm duyệt duy nhất được thiết kế cho đầu ra văn bản trực tiếp.
Cài đặt SDK OpenAI Chính thức
Cài đặt gói SDK chính thức để xử lý xác thực và định dạng yêu cầu một cách tự động. Thư viện này hỗ trợ cả môi trường Python và Node.js với các giao diện nhất quán.
Đối với người dùng Python, hãy chạy lệnh pip install tiêu chuẩn để thêm thư viện vào môi trường ảo của bạn. Các nhà phát triển Node.js nên sử dụng npm để cài đặt gói tương đương.
SDK quản lý cấu trúc payload JSON cho bạn, vì vậy bạn chỉ cần tập trung vào nội dung prompt và các tham số như nhiệt độ hoặc top_p.
Bạn có thể xác minh việc cài đặt bằng cách nhập thư viện vào tập lệnh hoặc mô-đun của bạn. Điều này đảm bảo client sẵn sàng kết nối với máy chủ của chúng tôi.
Cấu hình URL cơ sở và Khóa API
Điểm SDK client của bạn đến URL gốc cụ thể của chúng tôi để định tuyến các yêu cầu đến cơ sở hạ tầng không kiểm duyệt của chúng tôi. Sử dụng https://api.dolphinuncensored.com/v1 làm điểm cuối của bạn.
Thiết lập khóa API của bạn trong tiêu đề ủy quyền hoặc đối tượng cấu hình client. Client sẽ tự động đính kèm khóa này vào mọi yêu cầu.
Đảm bảo bạn chỉ định model ID là "uncensored" trong cấu hình của bạn. Điều này cho máy chủ biết phiên bản mô hình nào sẽ sử dụng cho việc tạo nội dung của bạn.
Yêu cầu Chat Completion Đầu tiên của Bạn
Gửi một tin nhắn đơn giản để xác minh khả năng kết nối và nhận phản hồi. Điều này xác nhận khóa của bạn là hợp lệ và điểm cuối có thể truy cập được.
Sử dụng điểm cuối chat-completions với một system prompt và một user message. Phản hồi sẽ chứa văn bản được tạo ra trong trường content.
Hiểu về Streaming và Sử dụng Token
Bật chế độ streaming để nhận token ngay khi chúng được tạo ra thay vì chờ phản hồi đầy đủ. Điều này cải thiện độ trễ cảm nhận cho các đầu ra dài.
API trả về thống kê sử dụng trong chunk cuối cùng của luồng dữ liệu. Bạn có thể theo dõi số lượng token đầu vào và đầu ra để đảm bảo minh bạch trong tính phí.
Đặt tham số stream thành true trong thân yêu cầu của bạn. Duyệt qua các chunk để xây dựng văn bản cuối cùng hoặc xử lý nó theo thời gian thực.
Xử lý Lỗi và Từ chối
Xử lý lỗi HTTP 401 bằng cách xác minh khóa API của bạn đúng và chưa hết hạn. Lỗi 402 cho biết số dư tiền nạp trước không đủ; hãy nạp tiền qua crypto để tiếp tục.
Mã trạng thái 429 có nghĩa là bạn đã chạm ngưỡng giới hạn tốc độ 300 yêu cầu mỗi phút. Hãy đợi một lúc trước khi thử lại hoặc giảm độ đồng thời của bạn.
Mô hình từ chối các yêu cầu liên quan đến nội dung tình dục với trẻ vị thành niên, đây là giới hạn cứng. Các chủ đề gây tranh cãi hoặc người trưởng thành khác thường được cho phép. Lỗi và việc từ chối không tiêu thụ tín dụng token của bạn.
cURL
curl https://api.dolphinuncensored.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "fetch the list of installed python packages"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.dolphinuncensored.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.dolphinuncensored.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);Phát trực tiếp
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)Các câu hỏi thường gặp
Kích thước cửa sổ ngữ cảnh cho API này là gì?
Cửa sổ ngữ cảnh hỗ trợ 100.000 token cho tổng cộng cả prompt và completion. Bạn có thể tạo tối đa 16.000 token mỗi yêu cầu theo mặc định.
Đây có giống như API OpenAI chính thức không?
Tương thích với OpenAI, nghĩa là bạn sử dụng cùng mã SDK nhưng trỏ đến base URL của chúng tôi. Model là uncensored và khác biệt với các model GPT.
Tôi trả tiền cho API như thế nào?
Chúng tôi chấp nhận USDT trên mạng TRC20 hoặc USDC trên Base.
Lấy khóa của bạn trong một bước
Đăng ký, sao chép khóa, cập nhật URL cơ sở của bạn. Đó là toàn bộ cấu hình.