Khóa API Character AI: Cách lấy và sử dụng
Nếu bạn đã tìm kiếm khóa API Character AI, điều đầu tiên cần biết là trang web này không phải là Character.ai và không cấp các khóa của họ. Nó cung cấp cho bạn một khóa cho một API văn bản độc lập, tương thích OpenAI hoạt động như một backend thay thế cho các ứng dụng trò chuyện nhân vật.
Cập nhật

Điểm chính
- Bạn nhận được khóa sau khi đăng ký bằng Google hoặc email và mật khẩu, sau đó mở trang khóa API.
- Người dùng mới có thể nhận $0,50 tín dụng dùng thử bằng một cú nhấp chuột, không cần thẻ, có hiệu lực trong 7 ngày.
- Sử dụng base URL https://api.characteraiapi.com/v1 và model ID
uncensoredvới bất kỳ SDK OpenAI nào. - Giữ khóa trên máy chủ hoặc trong biến môi trường, không bao giờ trong mã giao diện người dùng công khai.
Những gì bạn thực sự nhận được
Character.ai là một sản phẩm trò chuyện dành cho người tiêu dùng. Những người tìm kiếm khóa API character ai thường muốn một trong hai điều: một cách để gọi một bot trò chuyện nhân vật từ mã của riêng họ, hoặc một backend cho một ứng dụng persona không bị giới hạn bởi các quy tắc của một sản phẩm được lưu trữ. Trang web này đáp ứng nhu cầu thứ hai. Bạn đăng ký, nhận một khóa và gửi các yêu cầu đến một endpoint tương thích OpenAI. Không có gì ở đây kết nối với Character.ai hoặc tái sử dụng các nhân vật của họ.
Dịch vụ là một API văn bản được lưu trữ phía trước một mô hình trọng số mở duy nhất, do một nhà cung cấp độc lập vận hành và được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp. Nó không phải là API chính thức của bất kỳ nhà cung cấp mô hình nào và không phải là một bộ định tuyến giữa các nhà cung cấp. Model ID là uncensored, và base URL là https://api.characteraiapi.com/v1. Có hai phương thức: POST /v1/chat/completions và GET /v1/models.
Vì giao diện khớp với OpenAI, công việc xây dựng một nhân vật nằm ở phía của bạn. Bạn viết persona dưới dạng một system message, giữ lịch sử cuộc trò chuyện và gửi nó với mỗi yêu cầu. Điều đó cho bạn quyền kiểm soát giọng nói, bộ nhớ và nhịp điệu mà một sản phẩm đóng hiếm khi cung cấp. Giới hạn cứng là như nhau cho mọi người dùng: không có nội dung tình dục liên quan đến trẻ vị thành niên, luôn luôn.
Lấy khóa của bạn trong năm bước
Toàn bộ quy trình mất vài phút. Bạn không cần thẻ để bắt đầu.
- Đăng ký. Sử dụng Google, hoặc đăng ký bằng email và mật khẩu.
- Mở trang khóa. Đi đến trang khóa API, nơi khóa tài khoản của bạn được hiển thị.
- Nhận dùng thử. Một cú nhấp chuột trên trang đó thêm $0,50 tín dụng dùng thử. Nó được giới hạn một lần cho mỗi người và có hiệu lực trong 7 ngày.
- Sao chép khóa. Lưu nó vào trình quản lý mật khẩu hoặc tệp bí mật ngay lập tức.
- Gửi một yêu cầu thử nghiệm. Sử dụng lệnh curl bên dưới trước khi bạn chạm vào bất kỳ mã ứng dụng nào.
Hãy coi khóa như một mật khẩu. Bất cứ ai có nó đều có thể tiêu tốn số dư của bạn. Nếu bạn nghĩ rằng nó bị rò rỉ, hãy ngừng sử dụng nó ngay lập tức, xóa nó khỏi mọi ứng dụng và kiểm tra số dư của bạn để tìm các khoản chi tiêu không mong muốn.
Kiểm tra khóa với curl
Đặt khóa dưới dạng biến môi trường để nó không bao giờ xuất hiện trong lịch sử shell của bạn dưới dạng văn bản thuần túy bên trong một script. Sau đó liệt kê các mô hình. Điều này xác nhận rằng khóa hoạt động và bạn đã truy cập đúng máy chủ.
export API_KEY="paste-your-key-here"
curl https://api.characteraiapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"Bạn sẽ nhận được một danh sách JSON bao gồm uncensored. Bây giờ hãy gửi một yêu cầu trò chuyện đầu tiên với một persona nhỏ. System message thiết lập nhân vật, user message bắt đầu cảnh.
curl https://api.characteraiapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
{"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
],
"temperature": 0.9
}'Phản hồi tuân theo định dạng hoàn thành trò chuyện tiêu chuẩn. Văn bản trả lời nằm trong choices[0].message.content. Các tiêu đề phản hồi cũng chứa X-Request-Id, X-Balance-USD và các tiêu đề giới hạn tốc độ, điều này rất hữu ích khi bạn muốn hiển thị số dư còn lại trong giao diện người dùng của riêng mình.
Sử dụng khóa từ Python hoặc Node
Bất kỳ SDK OpenAI nào cũng hoạt động khi bạn thay đổi hai giá trị: base URL và khóa. Dưới đây là phiên bản Python với gói openai chính thức.
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.characteraiapi.com/v1",
api_key=os.environ["API_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
{"role": "user", "content": "Status report?"},
],
)
print(reply.choices[0].message.content)Và cùng một lệnh gọi trong Node:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.characteraiapi.com/v1",
apiKey: process.env.API_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "system", content: "You are Mara, a ship engineer. Stay in character." },
{ role: "user", content: "Status report?" },
],
});
console.log(reply.choices[0].message.content);Nhiều giao diện trò chuyện có một trường cho một endpoint tương thích OpenAI tùy chỉnh. Trong những công cụ đó, bạn dán base URL, dán khóa và nhập uncensored làm tên model. Không có gì khác cần thay đổi. Trang tài liệu liệt kê các tham số được hỗ trợ, bao gồm streaming, gọi hàm và chế độ JSON.
Các vấn đề phổ biến với khóa và cách khắc phục nhanh
Hầu hết các lỗi của người mới bắt đầu đều do một vài lỗi nhỏ. Hãy kiểm tra chúng theo thứ tự này trước khi bạn nghi ngờ bất cứ điều gì lớn hơn.
- Khoảng trắng hoặc dấu ngoặc kép bổ sung trong khóa. Một dòng mới ở cuối được sao chép từ tệp là đủ để làm xác thực thất bại. In độ dài của biến và so sánh nó với những gì bạn đã sao chép.
- Base URL sai. Base URL kết thúc bằng
/v1, và SDK tự thêm/chat/completions. Nếu bạn cũng thêm/chat/completionsvào base URL, đường dẫn sẽ bị nhân đôi và yêu cầu sẽ thất bại. - Tên model sai. Model ID là
uncensored. Các tên vay mượn từ các dịch vụ khác sẽ không khớp. GọiGET /v1/modelsđể xem máy chủ báo cáo gì. - Thiếu header. Các lệnh gọi HTTP thô cần
Authorization: Bearertheo sau là một khoảng trắng và khóa, cộng vớiContent-Type: application/jsontrên các yêu cầu POST. - Số dư trống. Tiêu đề phản hồi
X-Balance-USDhiển thị số dư còn lại. Khi tín dụng dùng thử đã hết hoặc quá 7 ngày, hãy nạp tiền hoặc các yêu cầu sẽ không thành công. - Giới hạn tốc độ. Một khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Hai stream mở đã sử dụng cả hai khe.
Một khóa xấu thường tạo ra lỗi xác thực thay vì phản hồi của mô hình. Một giới hạn tạo ra HTTP 429 với mã rate_limited hoặc concurrency. Đọc thân lỗi, không chỉ là mã trạng thái, tiết kiệm thời gian vì mã cho bạn biết giới hạn nào bạn đã đạt tới. Mọi phản hồi đều mang X-Request-Id; hãy lưu nó trong nhật ký của bạn, để bạn có thể khớp một lệnh gọi thất bại với một yêu cầu cụ thể sau này.
Giới hạn dùng thử và những gì gói dùng thử mua được
Một khóa dùng thử có giới hạn thấp hơn một khóa đầy đủ: 2 yêu cầu đồng thời và 60 yêu cầu mỗi phút. Một khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Để kiểm tra một persona đơn lẻ thì điều đó là đủ. Nếu bạn chạy nhiều cuộc trò chuyện cùng một lúc từ một script thử nghiệm, bạn sẽ thấy HTTP 429 với mã lỗi concurrency hoặc rate_limited. Một yêu cầu stream giữ khe giới hạn đồng thời của nó cho đến khi stream kết thúc, vì vậy hai stream mở trên một khóa dùng thử sẽ lấp đầy nó.
$0,50 đi được bao xa? Giá là $0,15 cho 1M token đầu vào và $0,50 cho 1M token đầu ra. Hãy lấy một lượt trò chuyện điển hình với 1.500 token lịch sử và persona đầu vào và 300 token đầu ra:
- Đầu vào: 1.500 token x $0,15 / 1.000.000 = $0,000225
- Đầu ra: 300 token x $0,50 / 1.000.000 = $0,00015
- Một lượt: $0,000375
- $0,50 / $0,000375 là khoảng 1.333 lượt
Điều đó đủ để kiểm tra một vài nhân vật một cách kỹ lưỡng. Các yêu cầu bị lỗi hoặc bị từ chối không bị tính phí, vì vậy một yêu cầu bị lỗi không làm tiêu tốn tín dụng của bạn. Gói dùng thử hết hạn sau 7 ngày; tín dụng bạn mua sau đó không bao giờ hết hạn.
Cài đặt giúp nhân vật cảm thấy đúng
Khóa API giúp bạn kết nối; chất lượng nhân vật đến từ prompt và cài đặt lấy mẫu. Một vài thói quen tốt giúp ích hơn là các thủ thuật thông minh.
Hãy viết system message dưới dạng một bảng nhân vật ngắn gọn bằng các câu văn bình thường: nhân vật là ai, cách nói chuyện, mục đích và độ dài câu trả lời. Hãy đưa ra một hoặc hai dòng hội thoại mẫu nếu giọng điệu quan trọng. Mô hình tuân theo các ví dụ cụ thể tốt hơn các tính từ, vì vậy một dòng như "Mara trả lời bằng các câu ngắn, khô khan và đùa giỡn khi lo lắng" sẽ hiệu quả hơn "Mara thông minh và quyến rũ".
Sử dụng temperature để điều chỉnh độ sôi nổi. Giá trị gần 0.9 mang lại nhiều cách diễn đạt đa dạng hơn, trong khi giá trị gần 0.5 giữ cho nhân vật ổn định hơn. Hãy thêm một chuỗi stop nếu ứng dụng của bạn sử dụng nhãn người nói như "Người dùng:" và bạn muốn ngăn mô hình viết phần hội thoại của đối phương. Các hình phạt về tần suất và sự hiện diện có thể giảm các cụm từ lặp lại trong các cuộc trò chuyện dài, nhưng hãy tăng chúng một cách nhẹ nhàng vì các giá trị cao có thể khiến hội thoại trở nên kỳ lạ.
Hãy nhớ rằng mô hình chỉ biết những gì có trong yêu cầu. Nếu nhân vật cần nhớ tên của người chơi từ 200 tin nhắn trước, hãy giữ tin nhắn đó trong cửa sổ ngữ cảnh hoặc lưu các sự kiện quan trọng vào system message. Đây là lý do tại sao một danh sách bộ nhớ do bạn tự cập nhật thường hiệu quả hơn việc gửi một lịch sử rất dài.
Nạp tiền khi tín dụng dùng thử hết hạn
Không có gói đăng ký. Bạn trả trước và chi trả theo token. Các lần nạp tiền có thể thực hiện với bất kỳ số tiền nguyên nào từ $20 đến $500, và các số tiền lớn hơn sẽ được thưởng thêm: +5% từ $50, +10% từ $100 và +15% từ $200. Vì vậy, $50 sẽ thành $52,50 tín dụng, $100 thành $110 và $200 thành $230. Bạn có thể thanh toán bằng tiền mã hóa (USDT trên TRC20, USDC trên Base).
Trang giá cả có bảng giá đầy đủ. Để lập kế hoạch, một lượt hội thoại 1.500 token đầu vào và 300 token đầu ra tốn $0,000375, vì vậy $20 sẽ chi trả được khoảng 53.000 lượt như vậy. Các cuộc đóng vai dài hạn tốn nhiều chi phí hơn cho mỗi lượt vì lịch sử hội thoại ngày càng dài, vì vậy hãy giới hạn lượng dữ liệu bạn gửi lại. Cửa sổ ngữ cảnh là 100.000 token (bao gồm prompt và kết quả), nhưng bạn hiếm khi muốn lấp đầy nó.
Giữ khóa an toàn trong một ứng dụng thực tế
Sai lầm phổ biến nhất với một dự án trò chuyện là gọi API trực tiếp từ mã trình duyệt. Mọi thứ được gửi đến trình duyệt đều có thể bị đọc bởi mọi khách truy cập, bao gồm cả khóa API. Hãy đặt một máy chủ nhỏ giữa giao diện người dùng và API. Trình duyệt sẽ giao tiếp với route của bạn, route sẽ thêm tiêu đề Authorization: Bearer và chuyển tiếp yêu cầu.
- Lưu khóa trong biến môi trường hoặc trình quản lý bí mật, không lưu trong kho lưu trữ mã nguồn.
- Thêm mục
.envvào.gitignoretrước lần commit đầu tiên của bạn. - Sử dụng một khóa cho mỗi môi trường để một lần rò rỉ trong môi trường phát triển không ảnh hưởng đến môi trường sản xuất.
- Theo dõi tiêu đề
X-Balance-USDđể phát hiện sớm các vòng lặp không kiểm soát. - Hãy thử lại khi nhận HTTP 429 với một khoảng thời gian chờ ngắn. Phản hồi quá tải tạm thời sẽ bao gồm
Retry-After: 5.
Các prompt gửi đến API không được sử dụng để huấn luyện. Tuy nhiên, hãy tránh gửi dữ liệu mà bạn không muốn lưu trữ trong nhật ký ở phía máy chủ của mình. Nếu bạn muốn tìm hiểu sâu hơn về những gì API này làm và không làm, bài viết lầm tưởng và sự thật sẽ giải thích các hiểu lầm phổ biến.