Skip to main content
POST
BaseURL:デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルサービスの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。

承認

Authorization
string
header
必須

すべての API で Bearer Token 認証が必要です

API キーの取得:

API キー管理ページで API キーを取得してください

リクエストヘッダーに追加:

ボディ

application/json
model
enum<string>
必須

モデル ID

利用可能なオプション:
MiniMax-M3.1-Flash
例:

"MiniMax-M3.1-Flash"

input
必須

モデルへの入力

  • 文字列形式:テキスト全体を 1 件の user メッセージとして扱います
  • 配列形式:入力アイテムのリスト。message、function_call、function_call_output、reasoning に対応します

マルチモーダル:message アイテムの content 配列内で input_text、input_image、input_video ブロックを組み合わせます。

マルチターン対話:API はステートレスです。対話を続ける場合は、完全な履歴を配列に含める必要があります。

例:

"Explain recursion in one sentence."

instructions
string

システムレベルの指示。先頭に挿入される system メッセージと同等で、役割・口調・出力制約の設定に使用します。

例:

"You are a technical documentation assistant. Keep your answers concise."

stream
boolean
デフォルト:false

ストリーミングで返すかどうか

  • false(デフォルト):完全なレスポンスオブジェクトを一括で返します
  • true:意味ごとに定義された SSE イベントで配信します。終了イベントは response.completed で、[DONE] は送信されません
例:

false

max_output_tokens
integer

今回の生成で出力できる最大トークン数。思考と回答の両方を含みます

  • 推奨値は 131,072(128K)、最大値は 524,288(512K)
  • 値が小さすぎると、思考中に上限に達し、status: "incomplete" となって message 出力アイテムが返されない場合があります
必須範囲: 1 <= x <= 524288
例:

131072

reasoning
object

思考の設定。MiniMax-M3.1-Flash は常に思考を行い、その内容を reasoning 出力アイテムとして返します。思考トークンは出力に含まれ、出力料金で課金されます。

temperature
enum<number>
デフォルト:1

サンプリング温度。1 に固定されています

利用可能なオプション:
1
例:

1

top_p
number
デフォルト:0.95

Nucleus Sampling のしきい値。デフォルトは 0.95。

必須範囲: 0 <= x <= 1
例:

0.95

tools
ツール定義 · object[]

モデルが呼び出せるツールのリスト。現在は function タイプのみ対応しています。関数はクライアント側で実行し、結果を function_call_output 入力アイテムとして返します。

tool_choice
enum<string>
デフォルト:auto

ツールの選択方針。auto のみ対応しています(ツールを呼び出すかどうかをモデルが判断します)

利用可能なオプション:
auto
例:

"auto"

text
object

テキスト出力形式の設定。format.type は text のみ対応しています

metadata
object

リクエストのメタデータ。キーと値はどちらも文字列です

レスポンス

生成に成功しました

Responses API のレスポンスオブジェクト。以下のフィールドに加え、今回のリクエストの設定(tools、tool_choice、temperature、top_p、text、reasoning、max_output_tokens など)も返されます。

id
string

このレスポンスの一意識別子

例:

"072514d63605b7a0c83f1672230c398c"

object
string

オブジェクト種別。常に response

例:

"response"

created_at
integer

作成時刻(Unix タイムスタンプ、秒)

例:

1792401878

status
enum<string>

レスポンスの状態

  • completed:正常に完了
  • incomplete:途中で打ち切り。理由は incomplete_details を参照してください
  • failed:生成に失敗。理由は error を参照してください
利用可能なオプション:
completed,
incomplete,
failed
例:

"completed"

model
string

実際に本レスポンスを生成したモデル ID

例:

"MiniMax-M3.1-Flash"

output
object[]

生成順に並んだ出力アイテムのリスト:

  • reasoning:思考過程。id は <id>_rs 形式で、content(reasoning_text ブロックのリスト)、summary(空の配列)、encrypted_content を含みます
  • message:最終回答。id は <id>_msg 形式で、content(output_text ブロックのリスト)を含みます
  • function_call:モデルによる関数呼び出し。id は <id>_fc_<連番> 形式で、call_id、name、arguments を含みます。クライアント側で実行し、結果を function_call_output として返す必要があります
output_text
string | null

すべての output_text のテキストを連結した結果。テキスト出力がない場合は null です

error
object | null

失敗の理由。成功時は null

incomplete_details
object | null

打ち切り理由。打ち切られていない場合は null です。reason は max_output_tokens(出力上限に到達)または content_filter(コンテンツ安全性)です

usage
object

トークン使用統計(キャッシュと思考の内訳を含む)