API Character AI: Chuyển đổi client của bạn trong ba dòng

Yêu cầu tiên quyết

Trước khi viết mã, bạn cần một tài khoản hoạt động trên characteraiapi.com. Truy cập trang Lấy khóa API và đăng ký chỉ bằng email và mật khẩu. Không cần thẻ tín dụng để bắt đầu, và tài khoản mới nhận được $0,50 tín dụng dùng thử có hiệu lực trong 7 ngày. Sau khi đăng ký, khóa API của bạn sẽ được hiển thị ngay lập tức. Hãy giữ khóa này an toàn vì nó xác thực mọi yêu cầu đến endpoint. Bạn cũng cần cài đặt SDK ngôn ngữ được hỗ trợ trong môi trường phát triển của bạn. Endpoint character ai api chấp nhận các tham số OpenAI tiêu chuẩn, vì vậy bất kỳ client tương thích OpenAI nào cũng có thể hoạt động với ít thay đổi.

Cài đặt SDK

Đối với dự án Python, hãy cài đặt gói OpenAI chính thức bằng pip. Thư viện này tự động xử lý tuần tự hóa JSON và các yêu cầu HTTP. Đối với ứng dụng Node.js, hãy sử dụng npm để thêm gói openai. Cả hai thư viện đều hỗ trợ các tính năng truyền phát và gọi công cụ được mô tả sau trong hướng dẫn này. Đảm bảo phiên bản SDK của bạn đủ mới để hỗ trợ Sự kiện gửi qua máy chủ (SSE) cho việc truyền phát token theo thời gian thực. Nếu bạn đang sử dụng máy khách HTTP tùy chỉnh thay vì SDK, bạn phải tự xử lý tải trọng JSON và phân tích luồng SSE theo đặc tả API OpenAI.

Xác thực

Mọi yêu cầu đến API đều phải bao gồm khóa API của bạn trong tiêu đề Authorization. Sử dụng định dạng Bearer YOUR_API_KEY. URL cơ sở cho mọi yêu cầu là https://api.characteraiapi.com/v1. Khi sử dụng SDK, hãy đặt cấu hình base_url thành giá trị này và cung cấp khóa của bạn qua tham số api_key. Nếu bạn mất khóa hoặc nghi ngờ bị rò rỉ, bạn có thể tạo lại khóa đó từ bảng điều khiển; khóa cũ sẽ bị thu hồi ngay lập tức. Chỉ cho phép một khóa hoạt động mỗi tài khoản. Đảm bảo bạn đang sử dụng URL cơ sở đúng, vì các yêu cầu đến endpoint OpenAI tiêu chuẩn sẽ thất bại với lỗi 404 hoặc 401.

Hoàn thành trò chuyện cơ bản

Chức năng cốt lõi được cung cấp thông qua endpoint /v1/chat/completions. Gửi yêu cầu POST với tên mô hình là uncensored và lịch sử tin nhắn của bạn. Mô hình trả về đầu ra văn bản mà không áp dụng các bộ lọc nội dung tiêu chuẩn cho nội dung người trưởng thành hợp pháp. Dưới đây là ví dụ curl minh họa một yêu cầu hoàn thành văn bản đơn giản.

Copycurl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Yêu cầu này trả về một đối tượng hoàn thành chứa văn bản được tạo. Bạn có thể điều chỉnh các tham số như temperature để kiểm soát độ ngẫu nhiên hoặc max_tokens để giới hạn độ dài đầu ra. Mô hình hỗ trợ cửa sổ ngữ cảnh 100.000 token, cho phép xử lý lịch sử hội thoại đáng kể hoặc tài liệu dài trong một yêu cầu.

Phản hồi truyền phát

Để có trải nghiệm người dùng tốt hơn, hãy bật chế độ truyền phát 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 qua máy chủ (SSE) chứa các khối token riêng lẻ khi chúng được tạo ra. Điều này làm giảm độ trễ cảm nhận đối với các ứng dụng chatbot. Sử dụng tham số stream_options nếu bạn muốn nhận thống kê sử dụng cuối cùng trong sự kiện cuối cùng. Chế độ truyền phát đặc biệt hữu ích cho việc nhập vai nhân vật theo thời gian thực, nơi việc hiển thị văn bản từng từ một sẽ tăng cường sự đắm chìm. Hãy đảm bảo mã client của bạn xử lý đúng định dạng SSE để phân tích từng khối theo thứ tự.

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 tốc độ và lỗi

API áp dụng giới hạn 300 yêu cầu mỗi phút mỗi khóa. Nếu bạn vượt quá giới hạn này, bạn sẽ nhận được lỗi 429 Quá nhiều yêu cầu. Thân yêu cầu được giới hạn ở 8 MB. Các lỗi phổ biến bao gồm 401 cho khóa không hợp lệ hoặc bị thiếu, và 402 nếu tín dụng trả trước của bạn đã hết. Bạn có thể nạp tiền từ $10 bằng tiền điện tử (USDT hoặc USDC), với tín dụng bổ sung có sẵn cho các khoản gửi lớn hơn. Không giống như một số nhà cung cấp khác, không có phí ẩn hoặc khóa đăng ký; bạn chỉ trả tiền cho các token bạn sử dụng. Giá cả minh bạch: $0,25 cho mỗi 1 triệu token đầu vào và $1,00 cho mỗi 1 triệu token đầu ra. Đảm bảo logic xử lý lỗi của bạn thử lại khi gặp lỗi 429 với độ trễ tăng dần theo cấp số nhân.

Copyfrom openai import OpenAI

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