MiniMax 参考实现

MiniMax 提供商是 GodeX 内置的参考实现之一。它演示了 MiniMax-M3 路由、图片和视频输入、布尔 thinking 控制、reasoning_content 提取、缓存 Token 用量上报、max_tokens 到 max_completion_tokens 的请求补丁，以及防御性数组内容文本提取。

模块结构

src/providers/minimax/
├── spec.ts         # MINIMAX_PROVIDER_SPEC 声明（能力与访问器）
├── client.ts       # createMiniMaxProviderEdge() 工厂
├── hooks.ts        # 提供商特定 hooks（请求补丁、用量映射、增量）
├── protocol/       # MiniMax 特定类型定义
│   ├── completions.ts  # 请求/响应 DTO
│   └── index.ts        # 桶导出
└── index.ts        # 公共导出

Spec 声明

spec.ts 中的 MINIMAX_PROVIDER_SPEC 声明了所有能力、访问器和 hooks：

export const MINIMAX_PROVIDER_SPEC: ProviderSpec<
  BridgeChatCompletionCreateRequest,
  ChatCompletion,
  ChatCompletionChunk,
  ChatCompletionRequest
> = {
  name: MINIMAX_PROVIDER_NAME,
  protocol: CHAT_COMPLETIONS_PROTOCOL,
  capabilities: MINIMAX_SPEC_CAPABILITIES,
  endpoint: { defaultBaseURL: DEFAULT_MINIMAX_BASE_URL },
  auth: BEARER_AUTH,
  toolName: DEFAULT_TOOL_NAME_CODEC,
  response: {
    firstChoice: minimaxFirstChoice,
    finishReason: minimaxFinishReason,
    outputText: minimaxOutputText,
    reasoningText: minimaxReasoningText,
    usage: minimaxResponseUsage,
  },
  stream: { deltas: minimaxStreamDeltas },
  hooks: { patchRequest: minimaxPatchRequest },
};

能力

const MINIMAX_SPEC_CAPABILITIES: ProviderCapabilities = {
  parameters: {
    supported: new Set([
      "stream", "temperature", "top_p", "max_output_tokens",
      "user", "text.format", "reasoning", "input.image", "input.video",
    ]),
  },
  tools: {
    supported: new Set([
      "function", "local_shell", "shell", "apply_patch",
      "custom", "namespace",
    ]),
    degraded: new Map([
      ["local_shell", "function"],
      ["shell", "function"],
      ["apply_patch", "function"],
      ["custom", "function"],
      ["namespace", "function"],
    ]),
    maxTools: 128,
  },
  toolChoice: { supported: new Set(["auto", "none", "required", "function"]) },
  responseFormats: { supported: new Set(["text", "json_object"]) },
  reasoning: { effort: "boolean" },
  streaming: { usage: true },
};

关键能力说明：

MiniMax-M3 默认模型：GodeX 推荐 MiniMax-M3 作为内置 MiniMax 默认模型。
多模态输入：MiniMax 声明支持文本、图片和视频输入内容块。
布尔推理：Responses reasoning.effort: "none" 会变成 MiniMax thinking: { type: "disabled" }；其他 effort 变成 adaptive thinking。推理输出从 reasoning_content 读取。
工具降级：Codex 内置工具（local_shell、shell、apply_patch、custom、namespace）降级为 function 类型。
完整工具选择：支持 auto、none、required 和 function 四种工具选择模式。
最多 128 个工具：MiniMax 每次请求最多接受 128 个工具。
缓存 Token：MiniMax 通过 prompt_tokens_details.cached_tokens 上报缓存 Token。
推理 Token：MiniMax 通过 completion_tokens_details.reasoning_tokens 上报推理 Token。

Hooks

`minimaxPatchRequest`

将 bridge 的 Chat Completions 请求转换为 MiniMax 特定格式：

移除 bridge-only 的 reasoning_effort。
将 bridge thinking 映射为 MiniMax thinking：enabled 变成 adaptive，disabled 保持 disabled。
设置 reasoning_split: true，让 MiniMax 通过 reasoning_content 返回推理内容。
将 max_tokens 映射为 max_completion_tokens（MiniMax 使用 max_completion_tokens 参数名）。

`minimaxStreamDeltas`

从 MiniMax SSE 块中提取类型化增量：

reasoning_content → 推理增量
content → 文本增量
tool_calls → 工具调用增量（通过共享的 mapCommonChatStreamDelta）
usage → 用量增量（含缓存 Token 和推理 Token 映射）
finish_reason → 完成原因增量

`mapMiniMaxUsage`

将 MiniMax 用量格式映射为标准 ResponseUsage 类型，包括：

prompt_tokens_details.cached_tokens → input_tokens_details.cached_tokens
completion_tokens_details.reasoning_tokens → output_tokens_details.reasoning_tokens

两个字段都通过 assertFiniteNumber 校验，格式错误时抛出 ProviderError。

客户端构建

client.ts 中的 createMiniMaxProviderEdge() 函数构建 ProviderEdge：

使用提供商的 base URL、API Key 和超时创建 ChatProviderClient。
使用 bridge 内核的 createProviderEdge() 包装 spec、配置和 HTTP 方法。

注册

提供商在 src/providers/builtin.ts 中注册：

export const MINIMAX_PROVIDER_DEFINITION = createProviderDefinition(
  MINIMAX_PROVIDER_NAME,
  createMiniMaxProviderEdge,
);

默认 MiniMax base URL 为 https://api.minimaxi.com/v1。默认模型为 MiniMax-M3。

内容处理

MiniMax 可能将 message.content 作为字符串或内容数组返回。minimaxOutputText 访问器同时处理两种情况，从数组内容中提取 type: "text" 部分的文本。当 content 为 null 或无法识别的类型时，返回空字符串。

GodeX 会将 Responses input_image 映射为 MiniMax image_url 内容块，将 Responses 视频 input_file.file_url / 视频 data URL 映射为 MiniMax video_url 内容块。不透明的 file_id 值以及 MiniMax 特定的 mm_file:// 引用会在 bridge 边界被明确拒绝。

模型

模型 ID	说明
`MiniMax-M3`	推荐默认模型；支持 coding/agentic 工作流、长上下文、多模态理解和 thinking 控制

智谱参考 DeepSeek 参考

MiniMax 参考实现 ​

模块结构 ​

Spec 声明 ​

能力 ​

Hooks ​

minimaxPatchRequest ​

minimaxStreamDeltas ​

mapMiniMaxUsage ​

客户端构建 ​

注册 ​

内容处理 ​

模型 ​