VI ▾
Lấy khóa API

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.

Một khóa phát sáng phía trên các bảng trò chuyện được kết nối với một khối máy chủ, minh họa cho việc truy cập khóa API

Điểm chính

  1. 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.
  2. 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.
  3. Sử dụng base URL https://api.characteraiapi.com/v1 và model ID uncensored với bất kỳ SDK OpenAI nào.
  4. 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.

  1. Đăng ký. Sử dụng Google, hoặc đăng ký bằng email và mật khẩu.
  2. 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ị.
  3. 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.
  4. 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.
  5. 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/completions và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ọi GET /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: Bearer theo sau là một khoảng trắng và khóa, cộng với Content-Type: application/json trên các yêu cầu POST.
  • Số dư trống. Tiêu đề phản hồi X-Balance-USD hiể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 .env vào .gitignore trướ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.

Hỏi đáp

Điều này có cung cấp cho tôi một khóa API Character.ai không?

Không. Đây là một dịch vụ riêng biệt và độc lập. Bạn sẽ nhận được một khóa cho một endpoint tương thích OpenAI với model ID uncensored, mà bạn có thể sử dụng làm backend cho các ứng dụng nhân vật của riêng mình.

Tôi có cần thẻ để nhận khóa không?

Không. Bạn đăng ký bằng Google hoặc email và mật khẩu, sau đó nhận $0,50 tín dụng dùng thử chỉ bằng một cú nhấp chuột trên trang khóa API. Tín dụng dùng thử có thời hạn 7 ngày.

Tôi có thể sử dụng khóa trong SillyTavern hoặc các giao diện trò chuyện khác không?

Các công cụ chấp nhận một endpoint tương thích OpenAI tùy chỉnh đều có thể sử dụng nó. Hãy nhập base URL, khóa của bạn và tên mô hình uncensored.

Điều gì xảy ra khi tôi vượt quá giới hạn tốc độ?

API sẽ trả về HTTP 429 với mã rate_limited hoặc concurrency. Hãy đợi một lúc và thử lại. 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.

Tín dụng có hết hạn không?

Tín dụng mua không bao giờ hết hạn. Chỉ có $0,50 tín dụng dùng thử có thời hạn 7 ngày.

Khóa của bạn chỉ cách một biểu mẫu

Tạo tài khoản, sao chép khóa, thay đổi base URL. Đó là toàn bộ thiết lập.

Lấy khóa API