Xác thực và API Keys
Bắt đầu bằng cách tạo tài khoản để nhận khóa API ngay lập tức. Bạn có thể đăng ký bằng Google hoặc email và mật khẩu mà không cần số điện thoại. Hệ thống tạo một khóa hoạt động cho mỗi tài khoản, và việc tạo khóa mới sẽ thay thế khóa cũ ngay lập tức. Bạn chỉ cần địa chỉ email để bắt đầu, và các câu lệnh của bạn không được sử dụng để huấn luyện mô hình. Sử dụng khóa này trong Authorization header dưới dạng bearer token cho tất cả các yêu cầu.
Yêu cầu đầu tiên
Thực hiện lệnh gọi đầu tiên đến điểm cuối hoàn thành trò chuyện bằng khóa API của bạn. URL cơ sở là https://api.aidphn.com/v1 và hoạt động với các máy khách tương thích OpenAI tiêu chuẩn. Bạn phải chỉ định mô hình uncensored để truy cập mô hình ngôn ngữ lớn không lọc. Các lỗi và từ chối không tiêu tốn tín dụng trả trước của bạn, vì vậy bạn có thể kiểm tra một cách an toàn.
curl https://api.aidphn.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top 5 Rust crates for async HTTP clients"}]
}'Xác minh khóa của bạn đang hoạt động bằng cách kiểm tra endpoint danh sách mô hình. Điều này xác nhận kết nối trước khi bạn gửi các yêu cầu phức tạp. API chấp nhận văn bản đầu vào và trả về văn bản đầu ra, hỗ trợ các tham số tiêu chuẩn như nhiệt độ và top_p.
Tích hợp SDK Python
Sử dụng thư viện Python chính thức của OpenAI để tương tác với điểm cuối của chúng tôi. Đặt URL cơ sở thành máy chủ API của chúng tôi và cung cấp khóa của bạn. Cách tiếp cận này cho phép bạn tái sử dụng mã hiện có từ các dự án OpenAI mà không cần thay đổi lớn. ID mô hình vẫn là uncensored cho tất cả các lần hoàn tất.
from openai import OpenAI
client = OpenAI(base_url="https://api.aidphn.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)Bạn có thể cấu hình các tham số như max_tokens để kiểm soát độ dài đầu ra. Giá trị tối đa đầu ra mặc định là 2,048 token, nhưng bạn có thể tăng nó lên đến 16,000 cho mỗi yêu cầu. Streaming có sẵn cho các phản hồi dài để giảm độ trễ.
Sử dụng SDK Node
Tích hợp API vào các ứng dụng Node.js của bạn bằng SDK tiêu chuẩn. Chỉ định client đến URL cơ sở của chúng tôi và xác thực bằng khóa của bạn. Phương pháp này hỗ trợ cả yêu cầu đồng bộ và bất đồng bộ để tích hợp linh hoạt. Bạn có thể truyền công cụ cho việc gọi hàm hoặc buộc chế độ đầu ra JSON.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.aidphn.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);Xử lý phản hồi bằng cách phân tích trường nội dung từ đối tượng hoàn tất. API hỗ trợ các tham số tiêu chuẩn như stop chuỗi và seed để tái lập. Xử lý lỗi nên tính đến giới hạn tốc độ và khả năng có sẵn số dư.
Phản hồi luồng qua SSE
Bật phát trực tiếp bằng cách đặt stream: true trong yêu cầu của bạn. API trả về các Sự kiện gửi từ máy chủ (SSE) để phân phối token theo thời gian thực. Mỗi chunk chứa nội dung từng phần, cho phép bạn hiển thị đầu ra khi nó được tạo. Chunk cuối cùng bao gồm tổng số token đã sử dụng để minh bạch hóa hóa đơn.
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)Streaming làm giảm độ trễ cảm nhận cho người dùng đang chờ các phản hồi dài. Bạn có thể xử lý các token theo từng phần hoặc đệm chúng để sử dụng sau. Cửa sổ ngữ cảnh hỗ trợ lên đến 100.000 token cho prompt và phần hoàn thành kết hợp.
Giới hạn và Lỗi
Theo dõi mức sử dụng dựa trên các giới hạn tốc độ nghiêm ngặt và số dư tín dụng. Bạn có thể gửi 300 yêu cầu mỗi phút và có 8 yêu cầu đồng thời mỗi khóa. Kích thước thân yêu cầu tối đa là 8 MB. Các lỗi như 401 cho biết khóa không hợp lệ, trong khi 402 có nghĩa là bạn cần nạp thêm. Lỗi 429 báo hiệu rằng bạn đã vượt quá giới hạn tốc độ. Nạp thêm chỉ bằng tiền điện tử, bắt đầu từ $20, để tiếp tục sử dụng dịch vụ mà không bị gián đoạn.
