クイックスタート: クライアントの接続

前提条件とSDKインストール

認証とリクエストのシリアライズを自動で処理するために、お使いの言語の公式SDKをインストールしてください。有効なAPIキーと、クライアント環境に設定されたベースURLが必要です。当サービスは、カスタムヘッダーを必要とすることなく、temperatureやtop_pなどの標準的なパラメータを受け付けます。

環境変数にトークンを安全に保持してから、スクリプトを実行してください。SDKバージョンはストリーミングとJSONモードの機能を正しくサポートするために最新である必要があります。テキストのみの生成には追加のドライバは必要ありません。

ベースURLとキーの構成

クライアントを専用ベースURLに接続して、リクエストをuncensoredインフラストラクチャ経由でルーティングしてください。Authorization: Bearer YOUR_KEY ヘッダーを使用して、すべての呼び出しを認証してください。このセットアップは、ローカルテストでも本番環境のデプロイスクリプトでも同じように機能します。

他のプロバイダーとの混乱を避けるために、デフォルトのOpenAIエンドポイントを当社のホストに置き換えます。キーを秘密に保ち、公開リポジトリに公開しないでください。設定はキーをローテーションするまで静的です。

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

接続と応答形式を確認するために標準的なチャット完了呼び出しを実行します。モデルが拒否なしでテキストを返すことを確認するために簡単なプロンプトを送信します。このテストは、キーに使用可能な前払いクレジットが十分にあることを確認します。

Copycurl https://api.keyapiminimax.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a JSON object with keys id and name"}]
  }'

レスポンス内のコンテンツとトークン使用量の詳細を確認してください。401エラーが発生した場合は、キーの形式を確認してください。402エラーは、クレジット残高を追加する必要があることを示します。

ストリーミングレスポンスの処理

ストリーミングを有効にして、トークンが生成されるたびにリアルタイムで受信します。これにより長い出力を待機するユーザーにとっての知覚されるレイテンシが軽減されます。最後のチャンクには請求の正確性を確保するための最終トークン数が含まれます。

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)

クライアントコードで部分的なレスポンスを適切に処理してください。ストリームが閉じるかエラーが発生するまでコンテンツをバッファリングしてください。ストリーミングは温度調整などの標準パラメータと連携して動作します。

Python SDK統合

Pythonライブラリを使用して、最小限のボイラープレートコードでリクエストを管理します。ベースURLとキーでクライアントを初期化することで、すぐに使用を開始できます。このアプローチはエラー処理とレスポンス解析を簡素化します。

Copyfrom openai import OpenAI

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

応答オブジェクトから生成されたコンテンツに直接アクセスします。エラーを確認し、レート制限を適切に処理します。SDKは同期および非同期の両方のワークフローをサポートします。

Node SDKと制限

公式のJavaScript SDKを使用してNode.jsアプリケーションに統合します。リクエストが当社の無制限エンドポイントに到達するようにベースURLを設定します。レート制限内に収まるよう使用状況を監視してください。

Copyimport OpenAI from "openai";

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

1分間に300リクエストを送信でき、同時実行数は8です。各リクエストボディは8 MB未満である必要があります。コンテキストウィンドウは合計で100,000トークンをサポートします。エラーや拒否はクレジットを消費しませんが、成功した出力は消費します。キーを安全に管理し、必要に応じてローテーションしてください。

トークン使用量の理解

課金は、プロンプトと補完で使用される実際のトークンに基づいています。入力トークンは100万あたり$0.15、出力トークンは100万あたり$0.50です。前払いクレジットは月額料金なしですべての使用をカバーします。

エラーと拒否は無料なので、正常に応答した処理に対してのみ課金されます。ストリーミングの最後のチャンクにはトークン数が含まれます。ダッシュボードで支出を追跡し、クレジットが不足しないようにしてください。USDTまたはUSDCでチャージすると、すぐにアクセスできます。