MiniMax M3.1 Flash

モデル ID は正確に MiniMax-M3.1-Flash を指定してください。モデルページには Playground と最新料金があります。OpenAPI 仕様では、リクエストとレスポンスのネストされたフィールドを定義しています。

クイックスタート

curl https://api.seedrouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"MiniMax-M3.1-Flash",
    "messages":[{"role":"user","content":"What is 17 multiplied by 23?"}],
    "max_completion_tokens":2048,
    "reasoning_effort":"low"
  }'

この例の出力上限は、モデルのデフォルト値ではありません。キーはサーバー側で保管してください。Playground はログイン中のアカウントを使用するため、API キーを貼り付ける必要はありません。

形式と認証

Content-Type: application/json と Authorization: Bearer $SEEDROUTER_API_KEY を送信してください。Messages は x-api-key も受け付けます。SDK クライアントは anthropic-version: 2023-06-01 を含めることができます。各形式では、ネイティブのリクエスト本文とレスポンス構造が維持されます。

パラメータ

上記の必須フィールドを除き、すべて省略可能です。省略と明示的な null は異なります。null を受け付けるのは、OpenAPI で許可されているフィールドだけです。未対応のトップレベルフィールドは破棄されます。対応フィールドに無効な値を指定するとエラーが返されます。

Chat Completions

Messages

Responses

Playground では model が固定され、それ以外のすべてのフィールドを設定できます。項目数は Chat が 12、Messages が 11、Responses が 12 です。ネストされたオブジェクトと完全な会話履歴は JSON フィールドに入力します。対応フィールドに無効な値がある場合、ブラウザーが送信をブロックします。

推論と制限

ドキュメントに記載されているコンテキストウィンドウは 1,000,000 トークンです。出力上限は推論を含めて 524,288 トークンです。MiniMax は複雑なタスクに 131,072 トークンの出力枠を推奨していますが、この値をデフォルトには指定していません。

思考は常に有効です。このモデルの思考設定では、disabled、none、minimal は使用できません。出力枠が小さいと、回答テキストが生成される前に使い切ることがあります。この仕様では、service_tier、音声入力、構造化 JSON 出力はサポートされていません。

リクエスト本文全体は 64 MB 以下にしてください。実際のコンテキスト使用量とリモートメディアの内容は、モデルサービスが検証します。

画像と動画

Chat は image_url: {"url":"..."} と video_url: {"url":"..."} のコンテンツブロックを使用します。Messages は source オブジェクトを含む画像／動画ブロックを使用します。形式は {"type":"url","url":"..."} または {"type":"base64","media_type":"...","data":"..."} です。Responses は input_image または input_video を使用し、その URL 値には文字列または対応するオプションオブジェクトを指定できます。

detail には low、default、high を指定でき、デフォルトは default です。動画の fps は 0.2～5 で、デフォルトは 1 です。ネストされたスキーマに省略可能な max_long_side_pixel がある場合、その値は正の整数です。

{
  "model": "MiniMax-M3.1-Flash",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "text", "text": "Describe the main change in this clip."},
      {"type": "video_url", "video_url": {
        "url": "https://example.com/clip.mp4",
        "fps": 1,
        "detail": "default"
      }}
    ]
  }],
  "max_completion_tokens": 2048
}

例の URL を、ご自身のアクセス可能なファイルの URL に置き換えてください。インライン入力には適切な base64 MIME タイプを使用します。MOV の場合は video/mov です。既存の mm_file:// 動画参照はそのまま渡されますが、このサービスは Files アップロード API を提供していません。参照先には、リクエストを処理するアカウントからアクセスできる必要があります。

ツールと会話履歴

関数ツールは、アプリケーションが実行できる操作を記述します。ツール呼び出しがあっても、外部操作が実行済みとは限りません。名前と引数を確認し、アプリケーションで操作を実行してから、対応する呼び出し ID とともに結果を返してください。

Chat で会話を続ける場合は、reasoning_content と tool_calls を含む assistant メッセージ全体を保持してください。ツールメッセージには tool_call_id が必要です。Messages では、思考ブロック、署名、tool_use、tool_result ブロックを保持します。Responses では、返された出力項目をすべて追加してから、次のユーザー入力を追加します。

これらの履歴を回答テキストだけにまとめないでください。任意の関数パラメータスキーマと、返された推論フィールドは保持されます。Chat の公式リファレンスでは、このモデルの tool_choice パラメータは定義されていません。

ストリーミングとレスポンスフィールド

stream: true を設定すると、サーバー送信イベントを受信できます。Chat は choices[].delta を送信し、[DONE] で終了します。使用量を受信するには、stream_options: {"include_usage":true} を指定してください。Messages は message_start、コンテンツブロックの更新、message_stop などの名前付きイベントを送信します。Responses は response.output_text.delta、response.completed などのイベントを送信します。

非ストリーミングの Chat は choices[].message、finish_reason、usage を返します。Messages はコンテンツブロック、stop_reason、使用量を返します。Responses は output 項目、ステータス、使用量を返します。表示用の回答以外の情報も必要なアプリケーションでは、レスポンス全体を保持してください。

使用量と最新料金

最新の料金表には、入力の 2 つの料金区分が掲載されています。総入力が 512,000 トークン以下なら第 1 区分、512,000 トークンを超えると第 2 区分が適用されます。選ばれた区分は、出力とキャッシュを含むリクエスト全体に適用されます。

キャッシュ読み取りとキャッシュ書き込みのトークンが、通常の入力として二重に課金されることはありません。自動キャッシュは、512 トークン以上で条件を満たす繰り返しプレフィックスを確認しますが、ヒットは保証されません。明示的なキャッシュマーカーは不要です。

レスポンスにはトークン数が含まれ、金額は含まれません。最終的な料金はアカウントの使用履歴で確認できます。失敗したリクエストには課金されません。

エラー

エラーが発生した場合は、無効なフィールドと公開エラーリファレンスを確認してください。同じモデル ID で上記の 3 つのテキストエンドポイントを利用できます。埋め込みや Gemini のエンドポイントには使用できません。

公式リファレンス

• MiniMax モデルの呼び出し
• Chat Completions リファレンス
• Messages リファレンス
• Responses リファレンス
• 関数呼び出し後の会話継続
• 自動プロンプトキャッシュ