Character AI API キー:取得と使用方法
Character AI API キーを検索した方へ知っておくべき最初の事実は、このサイトはCharacter.aiではなく、そのキーを発行しないということです。このサイトは、キャラクターチャットアプリのそのまま置き換えられるバックエンドとして機能する独立したOpenAI互換テキストAPI用のキーを提供します。
更新

主要ポイント
- Google、またはメールアドレスとパスワードでサインアップし、API キーページを開くとキーが取得できます。
- 新規ユーザーはカード不要でワンクリックで無料トライアルクレジット$0.50を受け取ることができ、7日間有効です。
- ベースURL https://api.characteraiapi.com/v1 とモデルID
uncensoredを任意のOpenAI SDKで使用します。 - キーをサーバーまたは環境変数に保持し、公開フロントエンドコードには入れないでください。
実際に得られるもの
Character.aiは消費者向けチャット製品です。Character AI APIキーを検索する人は、通常以下のいずれかを望んでいます:独自のコードからキャラクターチャットボットを呼び出す方法、またはホスト型製品のルールに制限されないペルソナアプリ用のバックエンドです。このサイトは2つ目のニーズに対応します。サインアップし、キーを受け取り、OpenAI互換エンドポイントにリクエストを送信します。ここにはCharacter.aiへの接続や、そのキャラクターの再利用はありません。
このサービスは、独立したプロバイダが運営し、合法的な成人向け利用に対してコンテンツ拒否なしで回答するようにチューニングされた1つのオープンウェイトモデルの前面にあるホストテキストAPIです。どのモデルベンダーの公式APIでもなく、ベンダー間のルーターでもありません。モデルIDはuncensored、ベースURLはhttps://api.characteraiapi.com/v1です。2つのメソッドがあります:POST /v1/chat/completions と GET /v1/models。
インターフェースがOpenAIと一致するため、キャラクターの構築作業はあなた側で行う必要があります。ペルソナをシステムメッセージとして記述し、会話履歴を保持し、各リクエストで送信します。これにより、クローズド製品ではほとんど公開されない音声、メモリ、ペースの制御権が得られます。すべてのユーザーに同じハードリミットがあります:未成年者が関わる性的コンテンツは一切禁止です。
5つのステップでキーを取得
全体のパスには数分かかります。開始するためにカードは必要ありません。
- サインアップ。 Googleを使用するか、メールアドレスとパスワードで登録します。
- キーページを開く。 アカウントのキーが表示されるAPI キーページに移動します。
- トライアルを受け取る。 そのページでのワンクリックで、無料トライアルクレジット$0.50が追加されます。1人1回限りの制限があり、7日間有効です。
- キーをコピーする。 すぐにパスワードマネージャーまたはシークレットファイルに保存してください。
- テストリクエストを送信する。 アプリコードに触れる前に、以下のcurlコマンドを使用してください。
キーをパスワードのように扱ってください。キーを持っている人は誰でも残高を使用できます。漏洩したと思われる場合は、すぐに使用を停止し、すべてのアプリから削除し、予期しない支出のために残高を確認してください。
curlでキーをテスト
キーを環境変数として設定し、スクリプト内でプレーンテキストとしてシェル履歴に残らないようにしてください。次にモデルを一覧表示します。これでキーが機能し、正しいホストに到達できることを確認します。
export API_KEY="paste-your-key-here"
curl https://api.characteraiapi.com/v1/models \
-H "Authorization: Bearer $API_KEY"uncensored を含むJSONリストが返されるはずです。次に、小さなペルソナで最初のチャットリクエストを送信します。システムメッセージがキャラクターを設定し、ユーザーメッセージがシーンを開始します。
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
}'レスポンスは標準的なチャット完了の形式に従います。返信テキストはchoices[0].message.contentにあります。レスポンスヘッダーにはX-Request-Id、X-Balance-USD およびレート制限ヘッダーも含まれており、独自のUIに残高を表示したい場合に便利です。
PythonまたはNodeからキーを使用
ベースURLとキーの2つの値を変更すれば、任意のOpenAI SDKが機能します。以下は公式openaiパッケージを使用したPython版です。
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)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);多くのチャットフロントエンドにはカスタムOpenAI互換エンドポイント用のフィールドがあります。これらのツールでは、ベースURLを貼り付け、キーを貼り付け、モデル名としてuncensored と入力します。それ以外の変更は必要ありません。ドキュメントページには、ストリーミング、ツール呼び出し、JSON モードを含むサポートされているパラメータがリストされています。
一般的なキーの問題と迅速な修正
最初の失敗のほとんどは、いくつかの小さなミスから生じます。より大きな問題を疑う前に、この順序で確認してください。
- キー内の余分な空白または引用符。 ファイルからコピーされた末尾の改行だけで認証に失敗する可能性があります。変数の長さを印刷し、コピーしたものと比較してください。
- 間違ったベースURL。 ベースURLは
/v1で終わり、SDKは/chat/completionsを自動的に付加します。ベースURLに/chat/completionsを追加すると、パスが二重になりリクエストが失敗します。 - 間違ったモデル名。 モデルIDは
uncensoredです。他のサービスから借用した名前は一致しません。サーバーが報告する内容を確認するにはGET /v1/modelsを呼び出してください。 - ヘッダーがありません。 生の HTTP 呼び出しには、
Authorization: Bearerの後に半角スペースと API キーを、POST リクエストにはContent-Type: application/jsonを指定する必要があります。 - 残高がゼロ。
X-Balance-USDレスポンスヘッダーに残高を表示します。トライアルクレジットが消費されたか、7日を超えた場合、チャージしないとリクエストは成功しなくなります。 - レート制限。トライアルキーでは同時リクエストが2件、1分あたり60件までです。オープンなストリームが2つあると、両方のスロットが占有されます。
無効なキーは通常、モデルの応答ではなく認証エラーを返します。制限に達すると、コード rate_limited または concurrency を伴う HTTP 429 が返されます。ステータスコードだけでなくエラー本文を読むことで、どの制限に達したかがコードから分かり、時間を節約できます。すべての応答には X-Request-Id が含まれます。ログに記録しておけば、後で失敗した呼び出しを特定のリクエストに一致させることができます。
トライアルの制限とトライアルで得られるもの
トライアルキーはフルキーよりも制限が厳しく、同時リクエストは2件、1分あたり60件までです。フルキーでは同時リクエストが8件、1分あたり300件まで可能です。単一のペルソナでのテストには十分です。テストスクリプトから複数のチャットを同時に実行すると、HTTP 429エラーコードconcurrencyまたはrate_limitedが表示されます。ストリーミングリクエストはストリームが終了するまで同時実行数のスロットを保持するため、トライアルキーでオープンなストリームが2つあるとスロットが埋まります。
$0.50でどれくらい進みますか?価格は入力トークン1Mあたり$0.15、出力トークン1Mあたり$0.50です。1,500トークンの履歴とペルソナが入力され、300トークンが出力される典型的なチャットターンを計算します:
- 入力: 1,500トークン x $0.15 / 1,000,000 = $0.000225
- 出力: 300トークン x $0.50 / 1,000,000 = $0.00015
- 1ターン: $0.000375
- $0.50 / $0.000375 は約1,333ターン
これは複数のキャラクターを適切にテストするのに十分です。失敗または拒否されたリクエストは請求されません。エラーが発生したリクエストはクレジットを消費しません。トライアルは7日後に期限切れになります。後で購入したクレジットは期限切れになりません。
キャラクターに自然な印象を与えるための設定
API キーは接続を可能にしますが、キャラクターの質はプロンプトとサンプリング設定から生まれます。巧妙なトリックよりも、いくつかの習慣がより役立ちます。
システムメッセージは、キャラクターが誰で、どのように話し、何を望み、返信がどの程度長いかを、簡潔な文章で記した短いキャラクターシートとして記述してください。声のトーンが重要であれば、会話の例を1〜2行示してください。モデルは形容詞よりも具体的な例を重視するため、「マラは短く、無愛想な文で答え、緊張すると冗談を言う」のような一文は、「マラは機知に富み、魅力的である」という記述よりも効果的です。
temperature を使用して出力の多様性を設定します。0.9 に近い値はより多様な表現を生成し、0.5 に近い値はキャラクターの安定性を維持します。アプリで「User:」などの話者ラベルを使用しており、モデルが会話の相手のセリフを書き出すのを防ぎたい場合は、stop シーケンスを追加してください。頻度ペナルティと存在ペナルティは長文のチャットでの繰り返し表現を減らすことができますが、高い値は対話を不自然にする可能性があるため、慎重に調整してください。
モデルはリクエストに含まれる情報のみを知っていることを忘れないでください。キャラクターが200メッセージ前のプレイヤーの名前を覚えている必要がある場合は、そのメッセージをコンテキストウィンドウ内に保持するか、重要な事実をシステムメッセージに保存してください。そのため、履歴を丸ごと送信するよりも、自分で更新するメモリリストの方が優れていることが多いのです。
トライアル終了後のチャージ
サブスクリプションはありません。トークンごとに前払いして使用します。チャージは $20 から $500 の任意の整数金額で行え、大口チャージにはボーナスが付きます:$50 以上で +5%、$100 以上で +10%、$200 以上で +15%。つまり、$50 は $52.50 のクレジットに、$100 は $110 に、$200 は $230 になります。暗号資産(TRC20 上の USDT、Base 上の USDC)で支払えます。
料金ページに完全な表があります。計画のため、1,500トークンの入力と300トークンの出力のターン1回あたり$0.000375で計算すると、$20で約53,000回のターンがカバーできます。ロールプレイは履歴が長くなるほどターンあたりのコストが高くなるため、送信する履歴の量を制限してください。コンテキストウィンドウは100,000トークンで、プロンプトと出力の合計ですが、それを埋めることはあまりありません。
本番環境でのAPIキーの安全な管理
チャットプロジェクトで最も多いミスは、ブラウザのコードから直接 API を呼び出すことです。ブラウザに配信されるものは、API キーを含め、すべての訪問者によって読み取ることができます。フロントエンドと API の間に小さなサーバーを置きます。ブラウザはあなたのエンドポイントにアクセスし、エンドポイントは Authorization: Bearer ヘッダーを追加してリクエストを転送します。
- APIキーはリポジトリではなく、環境変数またはシークレットマネージャーに保存してください。
- 最初のコミット前に、
.gitignoreに.envのエントリを追加してください。 - 環境ごとに異なるAPIキーを使用し、開発環境での漏洩が本番環境に影響を与えないようにしてください。
X-Balance-USDヘッダーを監視し、無限ループを早期に検出してください。- HTTP 429 の場合は短い待機時間後に再試行してください。一時的な過負荷の応答には
Retry-After: 5が含まれます。
APIに送信されたプロンプトは学習に使用されません。それでも、自分のサーバーのログに保存したくないデータを送信するのは避けてください。そのようなAPIが何を行い、何を行わないかについて詳しく知りたい場合は、よくある誤解と事実の記事をご覧ください。