クイックスタート：apertus aiチャットを統合する

前提条件とセットアップ

アカウントを作成してAPIキーを取得することから始めましょう。キー生成ページでGoogleまたはメールアドレスとパスワードを使用してサインアップしてください。システムはキーを即座に表示するため、遅延なくコピーできます。登録に電話番号は必要ありません。7日間有効な$0.50の試用クレジットが提供されるため、資金を追加せずに接続性をテストできます。

環境変数またはSDKクライアントを正しいベースURLにポイントします。このURLは標準のOpenAIライブラリと互換性があります。ベースURLとキーのみを変更してください。モデルIDは「uncensored」です。この単一エンドポイントはすべてのテキスト補完を処理します。ルーティングの管理や異なるモデルの選択は不要です。

クライアントライブラリがOpenAIチャット完了プロトコルをサポートしていることを確認してください。最新のSDKのほとんどはそのまま動作します。ネットワークがアウトバウンドHTTPSリクエストを許可していることを検証してください。サービスは標準のJSONペイロードを受け入れます。認証以外に特別なヘッダーは必要ありません。

APIキーによる認証

APIキーをAuthorizationヘッダーに渡して、すべてのリクエストに含めてください。Bearerスキームに続けてキー文字列を使用してください。サービスはキーをアカウントに対して検証します。無効なキーは401 Unauthorizedエラーを返します。期限切れまたは残高不足は402 Payment Requiredレスポンスを引き起こします。リクエストが失敗した場合はダッシュボードで残高を確認してください。

キーは安全に保管してください。アカウントにはアクティブなキーが1つ保持されます。新しいキーを生成すると、以前のキーは無効になります。公開リポジトリでキーを共有しないでください。APIキーは使用状況の唯一の識別子です。レートリミットはアカウントごとではなく、キーごとに適用されます。

Copycurl https://api.apertusaichat.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Set role to assistant"}]
  }'

認証はステートレスです。サーバーは呼び出しごとにトークンを検証します。キーを更新した場合は、実行中のすべてのクライアントを直ちに更新してください。ヘッダーが欠けていると即座に拒否されます。エラーメッセージには認証失敗の旨が明確に示されます。

最初のリクエストを送信する

チャット完了エンドポイントにPOSTリクエストを送信します。モデルID「uncensored」とメッセージ履歴を含めてください。APIはテキスト応答を返します。出力をストリーミングするか、完全な完了まで待機することができます。各リクエストは入力トークンと出力トークンを消費します。エラーが発生してもクレジットは課金されません。拒否応答は無料です。

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.apertusaichat.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)

レスポンスには使用統計情報が含まれます。トークン消費を追跡して前払いクレジットを管理しましょう。このモデルは法的な成人向け用途に対してコンテンツ拒否なしで回答します。システムプロンプトを送信して動作を定義できます。ユーザーメッセージが会話を駆動します。コンテキストウィンドウは合計100,000トークンをサポートしています。

シンプルな2メッセージの交換から始めてください。これにより、接続と応答の品質が検証されます。創造的または正確な出力のためにtemperatureとtop_pを調整してください。APIは標準パラメータをサポートしています。ストップシーケンスは期待どおりに機能します。シード値は再現可能な結果を保証します。

SSE経由のストリーミングレスポンス

ストリーミングを有効にするには、streamパラメータをtrueに設定します。APIは単一のJSONオブジェクトの代わりにServer-Sent Events (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は履歴を再送信しません。ストリームが失敗した場合は新しいリクエストを開始してください。最後のチャンクのトークン数は、全体の生成を反映しています。

パラメータとモードの処理

生成を制御するための標準パラメータを使用します。ランダム性のためにtemperatureを設定します。核サンプリングのためにtop_pを調整します。生成を早期に停止するためのstopシーケンスを定義します。決定論的な出力のためにseedを渡します。response_formatをjson_objectに設定してJSONモードを有効にします。モデルはリクエストされた場合、有効なJSONを返します。

関数呼び出しはサポートされています。リクエストでツールを定義します。モデルは適切な場合にツール呼び出しを返します。コードでツール引数を解析します。会話を続けるために結果を渡します。これにより複雑なエージェントワークフローが可能になります。

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.apertusaichat.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);

max_tokensは単一応答の出力長を制限します。デフォルトは2,048トークンです。必要に応じて高い値を設定してください。1リクエストあたりのハードリミットは16,000トークンです。コンテキストウィンドウは100,000トークンです。履歴の長さをそれに応じて計画してください。頻度ペナルティと存在ペナルティは反復を減らすのに役立ちます。

制限とエラーの理解

レート制限はサービスの安定性を保護します。1分あたり300リクエストを送信できます。同時実行数はキーごとに8つの同時リクエストに制限されます。リクエストボディは8 MBを超えてはなりません。制限を超えると、429 Too Many Errorsが返されます。再試行する前に待機してください。

エラーコードを確認して診断に役立ててください。401は無効または未定のキーを意味します。402は前払いクレジットが不足していることを示します。暗号通貨でチャージしてサービスを再開してください。429はレート制限を示します。400はリクエストの構文エラーを示します。詳細はエラーメッセージを確認してください。

コンテキストウィンドウの管理は重要です。プロンプトと補完のトークンを合計してください。100,000トークンをはるかに下回るようしてください。必要に応じて古いメッセージを切り捨ててください。APIは自動的に切り捨てません。履歴の長さを制御するのはあなたです。効率的なコンテキストの使用はコスト削減につながります。