ThinkPHP多模型切换指南：混元、DeepSeek与Kimi自由调用【教程】-ThinkPHP-PHP中文网

必须通过配置驱动的ai客户端工厂实现模型动态切换，即在config/ai.php中定义混元、deepseek、kimi三组独立配置，再由clientfactory::make()按模型标识加载对应base_url与api_key，控制器中可手动指定或参数校验后动态路由调用。

thinkphp多模型切换指南：混元、deepseek与kimi自由调用【教程】

要在ThinkPHP项目中根据任务类型动态调用混元、DeepSeek或Kimi模型，必须绕过硬编码模型标识，改用运行时配置驱动的AI客户端实例化机制。直接在控制器里写死model参数会导致后续扩展困难，且无法响应用户会话级偏好。

配置多模型基础参数

这一步决定后续所有模型能否被正确识别和路由，【base_url与api_key必须按模型厂商规范严格区分】，混元走腾讯云API网关，DeepSeek和Kimi则各自使用独立域名和密钥体系。

在application/config/ai.php中创建配置文件，填入三组独立配置块：

return [
  'hyun' => [
    'api_key' => 'your_hyun_secret_key',
    'base_url' => 'https://api.hunyuan.tencentcloudapi.com/v1/',
    'model' => 'hunyuan-pro'
  ],
  'deepseek' => [
    'api_key' => 'sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    'base_url' => 'https://api.deepseek.com/v1/',
    'model' => 'deepseek-v3'
  ],
  'kimi' => [
    'api_key' => 'kimi_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    'base_url' => 'https://api.moonshot.cn/v1/',
    'model' => 'kimi-plus'
  ]
];

封装可切换的AI客户端类

避免每次调用都重复new Client，也防止因模型切换导致连接池混乱。该类需支持运行时注入模型标识，并自动匹配对应配置项。

在app/common/library/AI/ClientFactory.php中定义：

namespace app\common\library\AI;
use think\facade\Config;
class ClientFactory {
  public static function make(string $model): \think\ai\Client {
    $config = Config::get("ai.{$model}");
    if (!$config) {
      throw new \InvalidArgumentException("Unknown AI model: {$model}");
    }
    return new \think\ai\Client($config['api_key'], $config['base_url']);
  }
}

在控制器中按需调用不同模型

方法一：手动指定模型名触发切换

NVIDIA Kimi Vision

通过 NVIDIA NIM API 调用 Kimi K2.5 视觉模型分析图像，非常适合为 MiniMax M2.5、GLM-5 等非视觉模型赋予视觉能力。

下载

在app/controller/AiController.php中写：

use app\common\library\AI\ClientFactory;
class AiController extends BaseController {
  public function mathTask() {
    $client = ClientFactory::make('deepseek');
    $result = $client->chat()->completions([
      'model' => 'deepseek-v3',
      'messages' => [['role' => 'user', 'content' => '解方程 x² + 2x - 8 = 0']],
    ]);
    return json($result);
  }
  public function marketingCopy() {
    $client = ClientFactory::make('kimi');
    $result = $client->chat()->completions([
      'model' => 'kimi-plus',
      'messages' => [['role' => 'user', 'content' => '为智能手表写一段30字以内朋友圈文案']],
    ]);
    return json($result);
  }
}