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

Tại sao nên thay thế Character AI bằng API?

Character AI thuận tiện, nhưng nó khóa các nhân vật của bạn vào hệ sinh thái của nó. Bạn không thể lưu toàn bộ cửa sổ ngữ cảnh, tinh chỉnh các tham số mô hình hoặc đảm bảo dữ liệu của bạn được bảo mật. Một giải pháp API như AI uncutly cho phép bạn truy cập trực tiếp vào một LLM không kiểm duyệt. Bạn kiểm soát các prompt, nhiệt độ và các chuỗi dừng. Điều này có nghĩa là nhân vật của bạn sẽ hành xử chính xác theo ý muốn của bạn.

Các nền tảng độc quyền thường từ chối nội dung hoàn toàn hợp pháp. Họ có thể ngắt một câu chuyện vì một từ khóa nhạy cảm. Với API chatbot không kiểm duyệt, bạn quyết định những gì được phép. Bạn có một điểm cuối đáng tin cậy duy nhất cho việc tạo văn bản. Độ tin cậy này rất quan trọng khi bạn đang xây dựng một sản phẩm phụ thuộc vào hành vi nhân vật nhất quán. Bạn không phụ thuộc vào đội ngũ kiểm duyệt tùy ý của nền tảng.

Bước 1: Lấy Khóa API của bạn

Bắt đầu bằng cách tạo tài khoản trên bảng điều khiển của nhà cung cấp. Bạn có thể đăng nhập bằng Google hoặc sử dụng email và mật khẩu đơn giản. Không yêu cầu số điện thoại. Sau khi đăng ký, hãy chuyển đến phần khóa API. Hệ thống tạo khóa duy nhất ngay lập tức. Sao chép khóa này và lưu trữ nó một cách an toàn trong các biến môi trường của bạn.

Mỗi yêu cầu đến API phải bao gồm khóa này trong tiêu đề. Nếu khóa bị thiếu hoặc không hợp lệ, máy chủ sẽ trả về lỗi 401. Bạn nhận được một khoản tín dụng dùng thử nhỏ để kiểm tra tích hợp trước khi chi tiêu tiền. Khoản tín dụng dùng thử này có hiệu lực trong bảy ngày. Đây là cách tốt để xác minh thiết lập của bạn hoạt động chính xác.

Bước 2: Cấu hình Base URL

Hầu hết các client LLM hiện đại đều mong đợi một giao diện tương thích OpenAI. Bạn cần trỏ SDK của mình đến URL cơ sở đúng. Đối với dịch vụ này, điểm cuối là https://api.uncutlyai.com/v1. Cấu trúc URL này phản ánh API OpenAI tiêu chuẩn. Điều đó có nghĩa là bạn có thể sử dụng các thư viện hiện có mà không cần thay đổi mã lớn.

Cập nhật đối tượng cấu hình của bạn để bao gồm URL cơ sở này. Ngoài ra, hãy đặt khóa API trong tiêu đề ủy quyền. ID mô hình bạn sẽ sử dụng đơn giản là "uncensored". Mô hình này được tinh chỉnh để giảm thiểu việc từ chối và tăng cường khả năng sáng tạo. Nó xử lý tốt ngữ cảnh dài, lên đến 100,000 token. Độ dài này cho phép lưu trữ lịch sử nhân vật sâu sắc.

Bước 3: Gửi yêu cầu Chat Completion đầu tiên của bạn

Xây dựng một yêu cầu đến /v1/chat/completions endpoint. endpoint. Thân yêu cầu phải chứa một danh sách các tin nhắn. Mỗi tin nhắn có một vai trò như "system", "user" hoặc "assistant". Tin nhắn hệ thống xác định tính cách của nhân vật. Các tin nhắn của người dùng điều khiển cuộc trò chuyện.

Đây là cách bạn cấu trúc yêu cầu:

Copycurl https://api.uncutlyai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Show me the API endpoint for text generation"}]
  }'

Gửi yêu cầu này để xem mô hình phản hồi. Máy chủ xử lý các token và trả về một bản hoàn tất văn bản. Bạn có thể đặt các tham số như temperature để kiểm soát độ sáng tạo. Các giá trị cao hơn khiến nhân vật trở nên khó dự đoán hơn. Các giá trị thấp hơn giúp nó nhất quán hơn. Sự linh hoạt này cho phép bạn tinh chỉnh giọng điệu.

Bước 4: Xử lý các phản hồi Streaming

Các ứng dụng trò chuyện cảm thấy chậm chạp nếu toàn bộ phản hồi phải chờ đến cuối. Streaming giải quyết vấn đề này. Đặt stream tham số thành true. Máy chủ gửi lại một chuỗi Sự kiện gửi bởi máy chủ (SSE). Mỗi sự kiện chứa một chunk văn bản nhỏ.

Mã khách hàng của bạn phải phân tích các chunk này và hiển thị chúng theo thời gian thực. Điều này tạo ra ảo giác về việc một người đang gõ. Nó cải thiện đáng kể trải nghiệm người dùng. Chunk cuối cùng thường chứa thống kê sử dụng token. Bạn có thể sử dụng dữ liệu này để theo dõi chi phí của mình một cách chính xác.

Copyfrom openai import OpenAI

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

Đảm bảo trình xử lý streaming của bạn bắt mọi lỗi mạng. Một luồng bị hỏng có thể khiến giao diện người dùng ở trạng thái đang tải. Luôn đóng kết nối khi luồng kết thúc hoặc gặp lỗi.

Bước 5: Quản lý Token và Chi phí

Hiểu chi phí token là rất quan trọng để lập ngân sách. Bạn trả tiền theo mỗi triệu token. Token đầu vào tốn $0.15 mỗi triệu. Token đầu ra tốn $0.50 mỗi triệu. Bạn chỉ trả tiền cho các token được xử lý. Lỗi không tính phí bạn. Từ chối cũng không tính phí bạn.

Mô hình trả trước này minh bạch. Bạn nạp tiền bằng tiền điện tử. Mức nạp tối thiểu là $20. Bạn có thể thêm $500 mỗi lần. Không có gói đăng ký hàng tháng. Số dư của bạn không bao giờ hết hạn. Sự ổn định này giúp bạn lên kế hoạch chi phí phát triển. Bạn biết chính xác mỗi cuộc hội thoại sẽ tốn bao nhiêu.

Bước 6: Triển khai Gọi hàm

Các nhân vật nâng cao thường cần tương tác với các công cụ bên ngoài. Gọi hàm cho phép mô hình trả về dữ liệu có cấu trúc. Bạn xác định lược đồ cho hàm. Mô hình quyết định khi nào gọi nó dựa trên cuộc trò chuyện.

Ví dụ, một nhân vật có thể cần kiểm tra thời tiết. Bạn gửi định nghĩa hàm trong yêu cầu. Mô hình phản hồi bằng một đối tượng JSON chứa tên hàm và các đối số. Mã của bạn sẽ thực thi hàm và gửi kết quả lại cho mô hình.

Copyimport OpenAI from "openai";

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

Vòng lặp này tiếp tục cho đến khi mô hình tạo ra phản hồi văn bản cuối cùng. Nó cho phép các câu chuyện tương tác, động. Bạn không bị giới hạn ở các đầu ra văn bản tĩnh. Mô hình có thể kích hoạt các sự kiện trong ứng dụng của bạn.

Bước 7: Xử lý Lỗi và Giới hạn

APIs có giới hạn. Bạn có thể gửi 300 yêu cầu mỗi phút. Chỉ tám yêu cầu có thể hoạt động đồng thời. Thân yêu cầu phải dưới 8 MB. Nếu bạn vượt quá các giới hạn này, bạn sẽ nhận được lỗi 429. Hãy triển khai cơ chế thử lại với độ trễ tăng dần theo cấp số nhân trong logic thử lại của bạn.

Xử lý lỗi mạng một cách khéo léo. Nếu máy chủ trả về lỗi 500, hãy đợi và thử lại. Đừng bao giờ giả định rằng mô hình sẽ luôn thành công. Ghi lại các lỗi này để xác định các mẫu. Các lần hết thời gian thường xuyên có thể cho thấy bạn cần điều chỉnh cài đặt thời gian chờ của mình.

Bước 8: Mở rộng tích hợp của bạn

Khi cơ sở người dùng của bạn phát triển, việc sử dụng API của bạn sẽ tăng lên. Hãy theo dõi chặt chẽ việc tiêu thụ token của bạn. Sử dụng dữ liệu sử dụng từ các phản hồi streaming để theo dõi chi phí. Nếu bạn nhận thấy chi phí cao, hãy xem xét tối ưu hóa các prompt của bạn. Các prompt hệ thống ngắn hơn có thể giảm token đầu vào.

Hãy xem xét việc lưu trữ kết quả thường xuyên. Nếu nhiều người dùng hỏi cùng một câu hỏi, hãy phục vụ kết quả đã lưu trữ. Điều này giảm số lần gọi API và tiết kiệm tiền. Bạn cũng có thể triển khai giới hạn tốc độ trên máy chủ của riêng mình. Điều này ngăn một người dùng duy nhất tiêu thụ hết tín dụng của bạn. Một tích hợp được mở rộng tốt sẽ vẫn nhanh và đáng tin cậy.