Character AI API統合ガイド

Character AIをAPIに置き換える理由

Character AIは便利ですが、キャラクターをそのエコシステムに縛り付けます。完全なコンテキストウィンドウを保存したり、モデルパラメータを調整したり、データをプライベートに保つことを保証したりすることはできません。APIソリューションである uncutly AI フィルタなしLLMへの直接アクセスを提供します。プロンプト、温度、ストップシーケンスを制御できます。つまり、キャラクターが希望通りに動作します。

プロプライエタリプラットフォームは、完全に合法なコンテンツでさえ拒否することがあります。特定のキーワードが敏感であると判断され、物語が途中で切られる場合があります。アンセンサードチャットボットAPIでは、許可される内容をあなたが決定します。テキスト生成のための単一で信頼性の高いエンドポイントが得られます。一貫したキャラクター動作に依存する製品を構築している場合、この信頼性は不可欠です。プラットフォームの恣意的なモデレーションチームの手に委ねる必要はありません。

ステップ1：APIキーの取得

プロバイダーのダッシュボードでアカウントを作成することから始めましょう。Googleでサインインするか、シンプルなメールアドレスとパスワードを使用できます。電話番号は必要ありません。登録後、APIキーのセクションに移動します。システムはすぐに一意のキーを生成します。このキーをコピーし、環境変数に安全に保存してください。

APIへのすべてのリクエストには、ヘッダーにこのキーを含める必要があります。キーが不足している場合、または無効な場合、サーバーは401エラーを返します。統合をテストするために、お金を使う前に小さな試用クレジットが提供されます。この試用クレジットは7日間有効です。これは、セットアップが正しく機能することを確認するのに最適な方法です。

ステップ2: ベースURLを設定する

最新のLLMクライアントの多くはOpenAI互換インターフェースを期待しています。SDKを正しいベースURLにポイントする必要があります。このサービスの場合、エンドポイントは https://api.uncutlyai.com/v1このURL構造は標準的なOpenAI APIを模倣しています。つまり、既存のライブラリを大幅なコード変更なしで使用できます。

設定オブジェクトにこのベースURLを含めてください。また、APIキーを認証ヘッダーに設定してください。使用するモデルIDは単に "uncensored" です。このモデルは拒否が少なく、創造的な自由度が高いようにチューニングされています。100,000トークンまでの長いコンテキストを適切に処理できます。この長さは、深いキャラクター履歴を可能にします。

ステップ3: 最初のチャット完了を送信する

へのPOSTリクエストを構築するには /v1/chat/completions エンドポイント。ボディにはメッセージのリストを含める必要があります。各メッセージには"system"、"user"、"assistant"などのロールがあります。システムメッセージはキャラクターの性格を定義します。ユーザーメッセージは会話を推進します。

リクエストの構成方法:

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

このリクエストを送信してモデルの応答を確認します。サーバーはトークンを処理し、テキスト補完を返します。パラメータを temperature 創造性を制御する。高い値はキャラクターをより予測不可能にします。低い値はより一貫性のある出力になります。この柔軟性により、声を微調整できます。

ステップ4: ストリーミングレスポンスを処理する

チャットアプリケーションでは、応答全体が終了するまで待機すると遅く感じられます。ストリーミングはこれを解決します。設定します。 stream true に設定します。サーバーは一連のServer-Sent Events (SSE)を返します。各イベントには小さなテキストチャンクが含まれます。

クライアントコードはこれらのチャンクを解析し、リアルタイムで表示する必要があります。これにより、人間がタイピングしているような錯覚を生み出します。ユーザーエクスペリエンスが大幅に向上します。最終チャンクにはトークン使用統計が含まれることが多く、このデータを使用してコストを正確に追跡できます。

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)

ストリーミングハンドラーがネットワークエラーをキャッチすることを確認してください。ストリームが切断されると、UIが読み込み状態のままになる可能性があります。ストリームが終了または失敗した場合は、必ず接続を閉じてください。

ステップ5: トークンとコストを管理する

トークンコストの理解は予算計画に不可欠です。100万トークンあたりで課金されます。入力トークンは100万トークンあたり$0.15です。出力トークンは100万トークンあたり$0.50です。処理されたトークンのみに対して課金されます。エラーは課金されません。拒否も課金されません。

この前払いモデルは透明性があります。暗号通貨でチャージします。最小チャージ額は$20です。一度に$500を追加できます。月額サブスクリプションはありません。クレジットは期限切れになりません。この予測可能性により、開発コストを計画できます。会話ごとに正確なコストが分かります。

ステップ6: 関数呼び出しを実装する

高度なキャラクターは外部ツールと連携する必要がある場合があります。関数呼び出しにより、モデルは構造化データを返すことができます。関数のスキーマを定義します。モデルは会話に基づいていつ呼び出すかを判断します。

例えば、キャラクターが天気を確認する必要があるとします。リクエストに関数定義を送信します。モデルは関数名と引数を含むJSONオブジェクトを返します。コードはその関数を実行し、結果をモデルに送信します。

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

このループはモデルが最終的なテキスト応答を生成するまで続きます。これにより動的でインタラクティブなストーリーが可能になります。静的なテキスト出力に限定されません。モデルはアプリケーション内でイベントをトリガーできます。

ステップ7: エラー処理と制限

APIには制限があります。1分あたり300リクエストを送信できます。同時にアクティブなリクエストは8つまでです。リクエストボディは8 MB以下である必要があります。これらの制限を超えると、429エラーが発生します。リトライロジックに指数関数的バックオフを実装してください。

ネットワークエラーを適切に処理します。サーバーが500エラーを返す場合は、待機して再試行してください。モデルが常に成功するとは限らないことを前提とします。これらのエラーをログに記録してパターンを特定してください。頻繁なタイムアウトは、タイムアウト設定を調整する必要があることを示している可能性があります。

ステップ8: 統合をスケールアップする

ユーザーベースが増加するにつれて、API利用も増加します。トークン消費を注意深く監視してください。ストリーミングレスポンスからの利用データを使用してコストを追跡してください。コストが高いことに気づいた場合は、プロンプトの最適化を検討してください。短いシステムプロンプトは入力トークンを削減できます。

頻繁にアクセスされるレスポンスをキャッシュすることを考えてみましょう。複数のユーザーが同じ質問をした場合、キャッシュされた結果を提供します。これによりAPI呼び出しが削減され、コストを節約できます。また、独自のサーバーでレートリミティングを実装することもできます。これにより、単一のユーザーがすべてのクレジットを消費するのを防ぎます。適切にスケールされた統合は高速かつ信頼性の高いままです。