MiniMax API：5分で最初のリクエスト

OpenAI SDK をインストール

まず、希望する言語用の公式 OpenAI SDK をインストールしてください。ライブラリはリクエストのフォーマットとストリーミングを自動的に処理します。Python 3.8+ または Node.js 18+ がインストールされていることを確認してください。Python の場合は pip install openai、Node の場合は npm install openai を実行します。SDK は /v1/chat/completions エンドポイントとのやり取りを簡素化します。SDK はヘッダー、リトライ、SSE パースを管理するため、プロンプトに集中できます。これは当社の API が OpenAI チャット完了標準に従っているためです。カスタムクライアントライブラリは不要です。標準的な SDK メソッドは当社のエンドポイントに直接マッピングされます。これにより統合時間が短縮され、既存の開発者知識を活用できます。

ベース URL とキーを設定

環境変数に API キーとベース URL を設定してください。当社のベース URL は https://api.minimaxapikey.com/v1 です。これにより、変更なしで標準的な OpenAI クライアントを使用できます。アカウントを作成してキーを生成してください。キーはサインアップ直後に表示されます。トライアルにはカードは不要です。キーは安全に保管してください。ヘッダーまたは環境変数として渡します。SDK はデフォルトで OPENAI_API_KEY を使用します。ベース URL を上書きして当社のサーバーを指すことができます。これにより、すべてのリクエストが無検閲モデルに送信されます。簡単な ping でキーが機能するか確認してください。このステップは後続の認証エラーを防ぎます。

基本的なチャット完了を送信

テキスト生成の最初のリクエストを行います。POST メソッドを /v1/chat/completions に対して使用します。モデルを uncensored に指定します。ユーザープロンプトを含むメッセージ配列を渡します。API は完了トークンを返します。これはコアのテキスト生成機能です。100k のコンテキストウィンドウをサポートします。長いプロンプトや会話履歴を送信できます。レスポンスには生成されたテキストとトークン使用量が含まれます。これはクリエイティブなライティングや制限のない対話に最適です。コンテンツが法的であることを確認してください。モデルは大人向けトピックを拒否しません。未成年者を含む性的コンテンツのみをブロックします。接続を確認するためにシンプルに開始してください。

ストリーミング（SSE）を有効化

リアルタイムの出力にはストリーミングを有効にします。stream パラメータを true に設定します。API はサーバー送信イベント（SSE）を返します。各チャンクにはレスポンスの一部が含まれます。これにより知覚されるレイテンシが削減されます。ユーザーは生成されるテキストをリアルタイムで表示できます。SDK はチャンクのパースを自動的に処理します。UI でテキストを段階的に表示できます。これはチャットインターフェースにとって重要です。ストリーミングはすべてのモデルレスポンスで機能します。トークンカウントには影響しません。各チャンクには末尾に使用データが含まれます。ユーザーエクスペリエンスを向上させるために使用してください。完全なレスポンスを待つよりも応答性が向上します。クライアントを構成してチャンクを正しくバッファリングしてください。

ツール/関数呼び出しを使用

関数呼び出しで構造化された出力をサポートします。リクエスト本文にツールを定義します。モデルはプロンプトに基づいて関数を呼び出すことができます。これにより外部システムとの統合が可能になります。ツール定義とユーザーメッセージを渡します。レスポンスにはツール呼び出しオブジェクトが含まれます。関数を実行し、結果をフィードバックします。これは標準的な OpenAI SDK で機能します。複雑なワークフローを可能にします。エージェントやアシスタントを構築できます。モデルは呼び出し間でコンテキストを維持します。これは自動化にとって強力です。ツール定義を正確に保つことを確認してください。API はツール出力のルーティングを処理します。会話を一貫性のある状態に保ちます。動的なコンテンツ生成に使用してください。

利用可能なモデルを確認

GET /v1/models を通じてモデルリストを確認します。このエンドポイントは利用可能なモデルを返します。当社の API は 1 つのモデルを提供します：uncensored。これはオープンウェイトモデルです。GPT、Claude、Gemini ではありません。レスポンスはモデル ID を確認します。これを使用してクライアント構成をデバッグしてください。コードが正しいモデルをターゲットにしていることを確認してください。エンドポイントは高速で信頼性があります。JSON データを返します。これを UI 表示のために解析できます。これにより API キーが有効であることが確認されます。自動化されたヘルスチェックに使用してください。これは標準的な OpenAI 仕様の一部です。追加の構成は不要です。これにより既存のツールとの互換性が確保されます。

cURL

Copycurl https://api.minimaxapikey.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

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

ストリーミング

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)