Hướng dẫn nhanh: tích hợp trong vài phút

1. Cài đặt SDK của bạn

Bắt đầu bằng cách cài đặt thư viện chính thức cho ngôn ngữ của bạn. Hầu hết các nhà phát triển đều thích gói tiêu chuẩn vì nó khớp với giao diện mà họ đã quen thuộc. Chạy pip install openai cho Python hoặc npm install openai cho Node.js. Bạn chỉ cần một SDK để xử lý tất cả các yêu cầu.

2. Đặt URL cơ bản của bạn

Cấu hình client của bạn để trỏ đến điểm cuối cụ thể của chúng tôi. Bạn phải ghi đè URL gốc mặc định để định tuyến lưu lượng truy cập chính xác. Sử dụng https://api.unsencoredai.com/v1 làm URL cơ sở. Truyền khóa API của bạn trong Authorization header. Cấu hình này hoạt động với bất kỳ khách hàng tương thích OpenAI tiêu chuẩn nào.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.unsencoredai.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)

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.unsencoredai.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);

3. Gửi yêu cầu đầu tiên của bạn

Gửi một yêu cầu hoàn tất hội thoại tiêu chuẩn để tạo văn bản. ID mô hình là uncensored. Bạn có thể gửi lời nhắc hệ thống để hướng dẫn hành vi. API trả về phản hồi văn bản trực tiếp. Sử dụng lệnh curl bên dưới để kiểm tra kết nối ngay lập tức. Kiểm tra phản hồi của bạn để tìm choices mảng.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. Xử lý các phản hồi streaming

Bật streaming để giảm độ trễ và đầu ra theo thời gian thực. Đặt stream: true trong yêu cầu của bạn. API gửi các chunk qua Server-Sent Events. Bạn có thể xử lý từng token khi nó đến. Điều này lý tưởng cho các giao diện trò chuyện hoặc kịch bản nhập vai. Chunk cuối cùng chứa thống kê sử dụng.

Copystream = 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)

5. Cấu hình tham số

Điều chỉnh temperature, top_p, và stop chuỗi. Những kiểm soát này ảnh hưởng đến sự sáng tạo và độ dài đầu ra. Bạn cũng có thể sử dụng response_format cho chế độ JSON. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100,000 token. Đầu ra tối đa là 16,000 token mỗi yêu cầu. Tinh chỉnh các cài đặt này cho trường hợp sử dụng cụ thể của bạn.

6. Giới hạn, lỗi và ngữ cảnh

Xử lý lỗi một cách tinh tế bằng các mã trạng thái HTTP tiêu chuẩn. Lỗi 401 có nghĩa là khóa API của bạn không hợp lệ. Lỗi 402 cho biết tín dụng trả trước không đủ. Lỗi 429 báo hiệu bạn đã đạt giới hạn 300 yêu cầu mỗi phút. Cửa sổ ngữ cảnh của bạn là 100,000 token. Các yêu cầu vượt quá 8 MB có thể bị lỗi. Không hoàn tiền cho tín dụng, nhưng các lỗi không mất phí.