Base URL và Xác thực
API của chúng tôi nằm tại https://api.huggingfacellmapi.com/v1. Bạn xác thực bằng một Bearer token được gửi trong Authorization header. Tạo khóa của bạn ngay lập tức qua Lấy khóa API trang bằng Google hoặc email. Hãy giữ khóa này an toàn; bất kỳ ai có khóa này đều có thể tiêu tốn số tín dụng trả trước của bạn. Nếu bạn làm mất nó, hãy tạo một khóa mới để thay thế khóa cũ đang hoạt động. Không cần số điện thoại để bắt đầu.
Yêu cầu đầu tiên với cURL
Gửi một tải trọng JSON thô để kiểm tra điểm cuối ngay lập tức. Sử dụng ID mô hình uncensored để bỏ qua các bộ lọc tiêu chuẩn. Lệnh cURL sau đây minh họa một yêu cầu tạo văn bản cơ bản.
curl https://api.huggingfacellmapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Summarize the release notes for version three point zero five"}]
}'Điều này trả về một đối tượng JSON chứa văn bản được tạo. Hãy kiểm tra choices mảng cho nội dung thực tế. Nếu bạn nhận được lỗi 401, hãy xác minh khóa của bạn có chính xác và còn hiệu lực không.
Tích hợp SDK Python
Sử dụng chính thức openai Thư viện Python cho giao diện sạch sẽ. Chỉ định client đến URL cơ sở của chúng tôi và đặt khóa API của bạn. Cách tiếp cận này tự động xử lý việc thử lại và phân tích cú pháp JSON.
from openai import OpenAI
client = OpenAI(base_url="https://api.huggingfacellmapi.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)Cài đặt gói thư viện qua pip. Bạn có thể gọi endpoint chat completions giống như khi dùng OpenAI. Đối tượng phản hồi cho phép bạn truy cập vào thông tin sử dụng token và lý do kết thúc.
Cài đặt Client Node.js
Nhà phát triển JavaScript có thể sử dụng openai Gói Node. Cấu hình máy khách với URL cơ sở cụ thể của chúng tôi. Điều này đảm bảo tất cả các yêu cầu được định tuyến qua các máy chủ không kiểm duyệt của chúng tôi.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.huggingfacellmapi.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);Chạy đoạn mã này trong môi trường Node của bạn. Nó minh họa một lệnh gọi đồng bộ đơn giản. Bạn có thể tích hợp dễ dàng vào các tuyến Express hoặc hàm serverless.
Phản hồi luồng
Bật phát trực tiếp bằng cách đặt stream: true. Máy chủ gửi Các sự kiện được gửi bởi máy chủ (SSE) chứa các token một phần. Điều này giảm độ trễ cảm nhận được đối với người dùng cuố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)Phân tích từng chunk khi nó đến. Chunk cuối cùng chứa tổng số token sử dụng cho yêu cầu. Điều này hữu ích để xây dựng các giao diện trò chuyện hiển thị phản hồi theo thời gian thực.
Giới hạn, Lỗi và Ngữ cảnh
Cửa sổ ngữ cảnh là 100,000 token cho cả prompt và kết hợp hoàn thành. Bạn có thể yêu cầu tối đa 16,000 token đầu ra. Lỗi như 401 cho biết khóa không hợp lệ, trong khi 402 có nghĩa là không đủ tín dụng. Giới hạn tốc độ giới hạn bạn ở 300 yêu cầu mỗi phút. Các yêu cầu vượt quá 8 MB sẽ bị từ chối. Lỗi trong quá trình xử lý không tiêu thụ tín dụng của bạn.
