Hướng dẫn tích hợp nhanh API Character

Cài đặt SDK

Bắt đầu bằng cách cài đặt thư viện khách chính thức cho ngôn ngữ của bạn. Điều này đảm bảo tương thích với điểm cuối tương thích OpenAI mà chúng tôi cung cấp. Thư viện xử lý việc tuần tự hóa và logic thử lại cho bạn.

Đối với Python, hãy sử dụng pip. Đối với Node.js, hãy sử dụng npm. Bước này mất vài giây và thiết lập môi trường cho các mẫu mã theo sau.

Cấu hình URL cơ sở của bạn

Điểm SDK client của bạn đến điểm cuối của chúng tôi để truy cập mô hình không kiểm duyệt. URL gốc là HTTPS://api.apicharacter.com/v1. Điều này thay thế URL OpenAI mặc định trong cấu hình của bạn.

Không có thay đổi này, các yêu cầu sẽ thất bại hoặc chạm vào dịch vụ sai. Bạn chỉ cần đặt điều này một lần khi khởi tạo phiên bản khách hàng của bạn.

Đặt Khóa API của bạn

Tiêm khóa của bạn vào biến môi trường hoặc cấu hình client. Xác thực là bắt buộc cho mọi yêu cầu để theo dõi mức sử dụng tín dụng trả trước của bạn. Khóa của bạn cấp quyền truy cập vào điểm cuối LLM không kiểm duyệt.

Giữ giá trị này an toàn. Nó đóng vai trò là giấy chứng nhận duy nhất cho tài khoản. Không cần số điện thoại hoặc xác minh bổ sung để truy cập cơ bản.

Thực hiện yêu cầu đầu tiên của bạn

Gửi một yêu cầu hoàn thành trò chuyện đơn giản để xác minh khả năng kết nối. ID mô hình là "uncensored". Điều này xác nhận xác thực và URL cơ sở của bạn là chính xác trước khi bạn xây dựng ứng dụng của mình.

Xem ví dụ bên dưới cho một yêu cầu cURL tiêu chuẩn.

Copycurl https://api.apicharacter.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "set my name to Alex"}]
  }'

Xử lý Phản hồi Luồng

Bật streaming để giảm độ trễ trong các giao diện trò chuyện của bạn. Đặt tham số stream thành true trong yêu cầu của bạn. SDK sẽ trả về các token khi chúng được tạo.

Điều này rất quan trọng cho trải nghiệm người dùng đáp ứng nhanh. Bạn xử lý các phần dữ liệu nhỏ lẻ khi chúng đến thông qua Server-Sent Events.

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à Ngữ cảnh

Hiểu các ràng buộc của bạn để tránh gián đoạn dịch vụ. Bạn có cửa sổ ngữ cảnh 100.000 token. Đầu ra tối đa là 16.000 token trừ khi bạn chỉ định khác.

Giới hạn tốc độ là 300 yêu cầu mỗi phút. Lỗi 401 có nghĩa là khóa không hợp lệ. Lỗi 402 có nghĩa là hết tín dụng. Lỗi 429 có nghĩa là bạn đã đạt giới hạn tốc độ. Hãy lưu ý những điều này khi mở rộng quy mô sản xuất.

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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