Mistral ユーザー向けクイックスタート

ベース URL と認証

当APIはOpenAI SDKと完全に互換性があります。ベースURLとAPIキーを設定するだけです。このサービスのベースURLはhttps://api.mistralapi.com/v1です。認証はBearerトークンを使用したAuthorizationヘッダーで処理されます。一部のプロバイダーとは異なり、複雑なルーティングやベンダー固有のヘッダーは不要です。通常どおりキーを渡すだけで済みます。

• ベース URL: https://api.mistralapi.com/v1
• ヘッダー: Authorization: Bearer YOUR_API_KEY

API キーはサインアップ直後に生成されます。前払いクレジットへのアクセス権を付与するため、安全に保管してください。月額サブスクリプション料はなく、トークン使用量に基づく従量課金制のみです。

チャット補完エンドポイント

API の中核は POST /v1/chat/completions エンドポイントです。これはメッセージのリストを受け取り、生成されたレスポンスを返します。このエンドポイントは、ほとんどの LLM クライアントで使用される標準メッセージ形式をサポートしています。モデル ID を "uncensored" として指定する必要があります。このモデルは、当社のサーバーでホストされているオープンウェイト大規模言語モデルで、法的な成人利用においてコンテンツ拒否なしで回答するようにチューニングされています。

• エンドポイント: POST /v1/chat/completions
• モデル ID: uncensored

APIはテキスト応答のみを返します。画像、音声、動画、埋め込みはサポートしていません。ほとんどの開発者にとって、このエンドポイントはベースURLとモデルIDの変更のみで、コード変更ゼロで標準のOpenAIチャットエンドポイントに置き換えられます。

Python SDK 統合

公式の OpenAI Python ライブラリを使用するのが最も迅速な統合方法です。ベース URL を当社のエンドポイントに設定し、API キーを提供します。以下のコードは、単純なテキスト補完リクエストの例を示しています。

• ライブラリをインストール：pip install openai
• base_url を https://api.mistralapi.com/v1 に設定
• model="uncensored" を使用

当社の API が OpenAI のレスポンス構造を反映しているため、このアプローチは機能します。ストリーミング、関数呼び出し、JSON モードのために既存のライブラリを修正なしで使用できます。

Node SDK 統合

JavaScript/TypeScript 開発者向けに、openai npm パッケージはシームレスに動作します。クライアントを当社のベース URL と API キーで構成します。これにより、OpenAI と当社の無検閲モデルの両方で同じコードベースを使用できます。

• ライブラリをインストール：npm install openai
• baseUrl を https://api.mistralapi.com/v1 に設定
• model: "uncensored" を指定

この互換性は temperature、top_p、stop シーケンスなどのすべての標準パラメータに拡張されます。クライアント構成を変更するだけで、プロバイダを簡単に切り替えることができます。

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

サーバー送信イベント（SSE）を介したストリーミングレスポンスをサポートしています。これにより、トークンが生成されるたびに受信でき、ユーザーにとっての知覚されるレイテンシを削減できます。ストリームの最終チャンクには、請求のためのトークン使用統計が含まれています。

• リクエストで stream: true を設定
• レスポンスからチャンクを読み取る
• 使用データのために最終チャンクを解析

ストリーミングはチャットインターフェースやリアルタイムアプリケーションに最適です。レスポンス形式は OpenAI のストリーミング標準に一致するため、既存のストリーミングロジックは変更なしで機能します。

制限、エラー、コンテキストウィンドウ

安定性を確保するために、API には特定の制限があります。各 API キーは 1 分あたり 300 リクエストと 8 同時リクエストをサポートします。最大リクエストボディサイズは 8 MB です。コンテキストウィンドウは合計 100,000 トークン（プロンプト + 補完）です。max_tokens を設定しない場合、デフォルトの出力は 2,048 トークンです。それ以外の場合、最大出力は 32,000 トークンです。

• 401: 無効な API キー
• 402: クレジット不足
• 429: レート制限超過

プレミアムクレジットは期限切れしません。エラーと拒否は無料です。問題が発生した場合は、返金またはアカウントのヘルプのためにサポートページを使用してください。

cURL

コピーcurl https://api.mistralapi.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."}]
  }'

Python

コピーfrom openai import OpenAI

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