Hướng dẫn Tích hợp cho Nhà phát triển

Xác thực và thiết lập Base URL

Bắt đầu bằng cách tạo khóa API của bạn trên bảng điều khiển. URL cơ sở là HTTPS://api.apiaicheap.com/v1. Gửi khóa của bạn trong tiêu đề Authorization dưới dạng mã thông báo bearer.

• Nhấp "Lấy API key" và đăng nhập bằng Google hoặc email.
• Sao chép khóa ngay lập tức; nó chỉ được hiển thị một lần.

Khóa này xác thực tất cả các yêu cầu đến điểm cuối hoàn thành trò chuyện.

Tiêu đề ví dụ

Authorization: Bearer YOUR_API_KEY

Yêu cầu đầu tiên với cURL

Gửi yêu cầu hoàn tất trò chuyện cơ bản để kiểm tra thiết lập của bạn. Sử dụng điểm cuối POST /v1/chat/completions với mô hình "uncensored".

Điều này xác nhận số dư tín dụng và độ trễ của bạn.

• Đặt role thành "user".
• Giữ tin nhắn đơn giản cho lần kiểm tra đầu tiên.

Kiểm tra phản hồi để xem trường văn bản được tạo.

• Tìm kiếm giá trị "content".

Nếu bạn nhận được 200 OK, tích hợp của bạn đang hoạt động.

Copycurl https://api.apiaicheap.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Fix the null pointer in the login handler"}]
  }'

Tích hợp Python SDK

Sử dụng thư viện Python chính thức của OpenAI để tích hợp dễ dàng. Trỏ nó đến base URL của chúng tôi và đặt API key của bạn.

Cách tiếp cận này xử lý việc thử lại và phân tích JSON một cách tự động.

• Cài đặt thư viện qua pip.
• Đặt tham số base_url thành điểm cuối của chúng tôi.

Gọi phương thức chat.completions.create.

Đặt danh sách tin nhắn của bạn dưới dạng một đối số.

• Bao gồm tên mô hình "uncensored".

Truy cập văn bản phản hồi qua các thuộc tính của đối tượng.

Phương pháp này sạch và dễ đọc cho các tập lệnh sản xuất.

Copyfrom openai import OpenAI

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

Thiết lập SDK Node.js

SDK Node.js hoạt động tương tự phiên bản Python. Khởi tạo máy khách với khóa của bạn và URL cơ sở của chúng tôi.

Điều này cho phép bạn sử dụng các mẫu async/await quen thuộc.

• Nhập gói OpenAI.
• Cấu hình URL cơ sở trong hàm tạo.

Tạo một yêu cầu hoàn tất với các tin nhắn của bạn.

Xử lý promise để lấy kết quả.

• Trích xuất nội dung tin nhắn từ phản hồi.

Ghi đầu ra để xác minh mô hình phản hồi đúng cách.

Cấu hình này lý tưởng cho các máy chủ web và dịch vụ backend.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apiaicheap.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ản hồi dạng stream với SSE

Bật chế độ streaming bằng cách đặt stream thành true trong yêu cầu của bạn. API trả về các chunk khi chúng được tạo thông qua các Sự kiện được gửi bởi máy chủ.

Điều này giảm độ trễ cảm nhận đối với người dùng trong các ứng dụng trò chuyện.

• Đặt stream: true trong tải trọng.
• Xử lý từng đoạn khi chúng đến.

Kết hợp các đoạn dữ liệu để tạo thành phản hồi cuối cùng.

Chi tiết sử dụng token xuất hiện trong chunk cuối cùng.

• Kiểm tra trường "usage" trong chunk cuối cùng.

Phương pháp này giữ cho giao diện người dùng đáp ứng trong quá trình tạo dài.

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)

Giới hạn, lỗi và cửa sổ ngữ cảnh

Tài khoản của bạn có giới hạn 300 yêu cầu mỗi phút cho mỗi khóa. Cửa sổ ngữ cảnh hỗ trợ tổng cộng 100.000 token cho cả đầu vào và đầu ra.

Lỗi được xử lý bằng các mã trạng thái HTTP tiêu chuẩn.

• 401 cho thấy khóa API không hợp lệ hoặc bị thiếu.
• 402 có nghĩa là tín dụng trả trước của bạn đã hết.
• 429 báo hiệu bạn đã vượt quá giới hạn tốc độ.

Lỗi từ chối không tốn tín dụng. Lỗi cũng miễn phí.

Đầu ra tối đa là 16.000 token mỗi yêu cầu. Đặt max_tokens nếu bạn cần ít hơn.

Cấu trúc này đảm bảo việc tính phí và hiệu suất có thể dự đoán được.