Character AI API: クライアントを3行で切り替え

前提条件

コードを書く前に、characteraiapi.comでアクティブなアカウントが必要です。APIキーを取得ページにアクセスし、メールアドレスとパスワードのみでサインアップしてください。開始時にクレジットカードは不要で、新しいアカウントには7日間有効な$0.50の無料トライアルクレジットが付与されます。登録後、APIキーが即座に表示されます。エンドポイントへのすべてのリクエストを認証するために、このキーを安全に保管してください。開発環境には対応する言語SDKがインストールされている必要があります。character ai apiエンドポイントは標準的なOpenAIパラメータを受け付けるため、既存のOpenAI互換クライアントは最小限の変更で動作します。

SDKのインストール

Pythonプロジェクトでは、pipを使用して公式のOpenAIパッケージをインストールしてください。このライブラリはJSONシリアライゼーションとHTTPリクエストを自動的に処理します。Node.jsアプリケーションでは、npmを使用してopenaiパッケージを追加してください。両方のライブラリは、このガイドの後半で説明するストリーミングとツール呼び出しの機能に対応しています。リアルタイムのトークンストリーミングのためにServer-Sent Events (SSE)をサポートする最新のSDKバージョンを使用してください。SDKの代わりにカスタムHTTPクライアントを使用する場合は、OpenAI API仕様に従ってJSONペイロードとSSEストリームの解析を手動で処理する必要があります。

認証

APIへのすべてのリクエストには、AuthorizationヘッダーにAPIキーを含める必要があります。形式はBearer YOUR_API_KEYを使用してください。すべてのリクエストのベースURLはhttps://api.characteraiapi.com/v1です。SDKを使用する場合は、base_url設定をこの値に設定し、api_keyパラメータ経由でキーを提供してください。キーを紛失した、またはリークした疑いがある場合は、ダッシュボードから再生成できます。古いキーは直ちに無効になります。アカウントごとにアクティブなキーは1つのみ許可されます。標準的なOpenAIエンドポイントへのリクエストは404または401エラーで失敗するため、正しいベースURLを使用していることを確認してください。

基本的なチャット完了

コア機能は/v1/chat/completionsエンドポイントを通じて提供されます。モデル名にuncensoredを指定し、メッセージ履歴とともにPOSTリクエストを送信してください。モデルは法的な成人向けコンテンツに対する標準的なコンテンツフィルタを適用せずにテキスト出力を返します。以下は、単純なテキスト完了リクエストを示すcurlの例です。

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."}]
  }'

このリクエストは生成されたテキストを含むcompletionオブジェクトを返します。temperatureなどのパラメータでランダム性を制御し、max_tokensで出力長を制限できます。100,000トークンのコンテキストウィンドウをサポートし、長い会話履歴やドキュメントを単一リクエストで処理できます。

ストリーミングレスポンス

より良いユーザーエクスペリエンスのために、リクエストにstream: trueを設定してストリーミングを有効にしてください。APIは生成されるたびに部分的なトークンチャンクを含むServer-Sent Events (SSE)を返します。これにより、チャットボットアプリケーションでの知覚される遅延が軽減されます。最後のイベントで最終的な使用統計を受け取りたい場合は、stream_optionsパラメータを使用してください。ストリーミングは、テキストを単語ごとに表示して没入感を高めるリアルタイムのキャラクターロールプレイに特に有用です。クライアントコードがSSE形式を正しく処理し、各チャンクを順次解析できることを確認してください。

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)

レート制限とエラー

APIはキーごとに1分あたり300リクエストの制限を適用します。これを超過すると、429 Too Many Requestsエラーが返されます。リクエストボディは8 MBに制限されています。一般的なエラーには、無効または欠落したキーによる401、または前払いクレジットが枯渇した場合の402が含まれます。暗号通貨（USDTまたはUSDC）を使用して$10からチャージでき、大口入金にはボーナスクレジットが付与されます。一部のプロバイダーとは異なり、隠れた料金やサブスクリプションのロックはなく、消費したトークンのみに対して課金されます。価格は透明で、入力トークン100万トークンあたり$0.25、出力トークン100万トークンあたり$1.00です。エラー処理ロジックでは、429エラーに対して指数関数的バックオフでリトライしてください。

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);