API MistralMistral API ドキュメント:クイックスタート統合
Mistral API ドキュメント:クイックスタート統合
プロバイダを切り替えるためにコードベースを書き換えるのをやめましょう。無制限LLM APIは標準的なOpenAI互換エンドポイントを使用するため、ベースURLとAPIキーを変更するだけでテキスト生成を開始できます。
認証:ヘッダーの設定
ダッシュボードでキーを生成することから始めましょう。プロセスは瞬時に行われ、電話番号の検証は必要ありません。アカウントを作成するには、メールアドレスまたはGoogleアカウントのみが必要です。生成されると、キーはすぐに画面上に表示されます。取得のために完全な文字列を保存しないため、安全に保管してください。この文字列を Authorization すべてのリクエストで必要です。システムは、プロンプトを処理する前にこのトークンをプリペイド残高に対して検証します。キーが無効または期限切れの場合、401エラーを受け取ります。アクセスをシンプルに保つため、アカウントごとにアクティブなキーは1つのみ許可されます。新しいキーを生成すると、古いキーはすぐに置き換えられます。
/v1/chat/completions エンドポイント
標準のチャット完了エンドポイントを使用してベースURLに最初のリクエストを送信してください。プレースホルダーキーを実際資格情報に置き換えてください。モデル識別子は単に uncensored. このモデルは法的な成人向けコンテンツに対して拒否なしで応答するようにチューニングされています。テキスト入力と出力を効率的に処理します。複雑なルーティングの設定や特定のモデルバージョンの選択は不要です。クライアントを当社のベースURLに指し、ペイロードを送信するだけです。当社のサーバーが推論を処理し、生成されたテキストを返します。このアプローチにより、既存のツールやライブラリとの互換性が確保されます。
SSEによるストリーミングレスポンス
ストリーミングを有効にして、トークンが生成されるたびに受信します。これにより長い出力に対する知覚されるレイテンシが軽減されます。設定 stream リクエストボディでtrueに設定します。サーバーはサーバー送信イベントのシリーズを返します。各イベントは応答の部分的なデルタを含みます。チャットインターフェースのためにこれらのトークンをリアルタイムで処理できます。最終チャンクにはリクエストの総トークン使用量が含まれています。これにより、会話の進行に伴うコストを正確に追跡できます。ストリーミングは即時フィードバックがユーザーエクスペリエンスを向上させるアプリケーションに最適です。
関数呼び出しとJSONモード
サポートされているパラメータを使用して出力を信頼性高く構成します。設定によりJSONモードを有効にします response_format に {"type": "json_object"}これはモデルにマークダウンフェンスなしで有効なJSONを返させることを強制します。ツール使用のための関数スキーマも定義できます。モデルは提供された構造を厳格に遵循します。これは自動化されたデータ抽出やAPIチェーンに役立ちます。以下を使用します。 tools 利用可能な関数を定義するパラメータ。モデルはプロンプトに基づいてどの関数を呼び出すかを選択できます。この機能は、追加の解析ロジックなしでエージェントワークフローを構築するために不可欠です。
パラメータ: Temperature、Top-p、Seeds
出力のランダム性と決定論性を制御します。調整 temperature 創造性を変化させます。低い値はより焦点を絞った応答を生成します。高い値はより多様な結果をもたらします。 top_p 語彙の選択を制限します。これは温度パラメータと組み合わせて出力品質を洗練します。設定を seed 再現可能な結果のためのパラメータ。同じ入力とシードは同じ出力を生成します。これは、統合のデバッグやテストに不可欠です。また、設定することもできます。 stop シーケンスで特定のマーカーで生成を停止します。これらのパラメータにより、モデルの動作を微細に制御できます。
制限、エラー、コンテキストウィンドウ
定義された制限に対して使用状況を監視してください。コンテキストウィンドウは合計で100,000トークンをサポートします。これにより、広範なドキュメント分析や長い会話が可能になります。各リクエストで最大16,000トークンを出力できます。指定しない場合 max_tokens, リミットはデフォルトで2,048です。キーごとに1分あたり300リクエストが許可されます。キーごとに同時に実行できるリクエストは最大8つまでです。リクエストボディのサイズは8 MBに制限されます。402エラーは残高不足を示します。1分あたりの制限を超えると、レートリミット(429)が発生します。残高は期限切れにならないため、使用を一時停止しても資金は失われません。
cURL
curl https://api.apimistral.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Set temperature to 0.7 for code generation"}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.apimistral.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.apimistral.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);ストリーミング
stream = 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)よくある質問
クライアントのベースURLを設定するには?
ベースURLとして HTTPS://api.apimistral.com/v1 を使用してください。このエンドポイントは公式のOpenAI SDKと互換性があります。設定でベースURLとAPIキーのみを変更すればよく、他のパラメータは標準的なOpenAIリクエストと同じままです。
レート制限を超えた場合どうなりますか?
429ステータスコードは、リクエスト数が多すぎること(Too Many Requests)を示します。制限はキーごとに1分間あたり300リクエストです。ウィンドウがリセットされるまで待つか、新しいキーを生成してカウンターをリセットしてください。即時アクセスが必要な場合は、新しいキーが古いキーを瞬時に置き換えます。
このAPIでロールプレイアプリケーションに使用できますか?
はい、このモデルはアンセーアードであり、法的な成人向けコンテンツに設計されています。論争的またはフィクションのトピックを拒否しません。これは没入型のロールプレイやクリエイティブライティングに最適です。コンテンツに未成年が含まれていないことを確認してください。これが唯一のハードリミットです。