OpenRouter 免费通道

针对 Mac 环境和 PHP 语言，为你提供两种最方便的个人开发测试方案。你可以直接复制下面的代码进行测试。

在开始前，请先在 Mac 终端（Terminal）中安装官方的 OpenAI PHP 客户端：

bash

composer require openai-php/client

请谨慎使用此类代码。

方案 1：使用 OpenRouter 免费通道（完全免费，无需翻墙）

这是最推荐的测试方案。你只需要在 OpenRouter 官网注册并创建一个免费的 API Key，然后使用下面的代码。我们这里选用专为编写代码优化的 qwen-2.5-coder-32b 免费版。

php

<?php
require 'vendor/autoload.php';

// 初始化客户端，指向 OpenRouter 的网关
$client = OpenAI::factory()
    ->withBaseUri('https://openrouter.ai')
    ->withApiKey('你的_OPENROUTER_API_KEY_以sk-or开头')
    ->withHttpHeader('HTTP-Referer', 'http://localhost') // OpenRouter 要求的身份标识
    ->make();

try {
    $response = $client->chat()->create([
        // 使用免费的高性能代码模型
        'model' => 'qwen/qwen-2.5-coder-32b:free', 
        'messages' => [
            ['role' => 'user', 'content' => '请用 PHP 写一个简单的人脸识别伪代码，或者写一个经典冒泡排序。']
        ],
    ]);

    echo "AI 回复：\n";
    echo $response->choices[0]->message->content;

} catch (\Exception $e) {
    echo "发生错误: " . $e->getMessage();
}

请谨慎使用此类代码。

方案 2：本地部署 Ollama（完全免费，支持离线，速度极快）

如果你的 Mac 是 M1/M2/M3/M4 芯片，强烈建议在本地跑模型，响应速度在毫秒级，且不需要外网环境。

第一步：安装 Ollama 和代码模型

1. 去官网下载并安装 Ollama for Mac。

2. 打开 Mac 的终端（Terminal），运行以下命令下载阿里开源的超强代码模型（约 4.7GB）：

   bash

   ollama run qwen2.5-coder:7b
   

   请谨慎使用此类代码。

3. 下载完成后，保持 Ollama 软件在后台运行即可。

第二步：PHP 调用本地模型代码

本地 Ollama 会自动开启一个完美兼容 OpenAI 格式的本地接口（http://localhost:11434/v1），API Key 随便填一个字符串即可。

php

<?php
require 'vendor/autoload.php';

// 初始化客户端，指向本地 Ollama 服务
$client = OpenAI::factory()
    ->withBaseUri('http://localhost:11434/v1')
    ->withApiKey('ollama-local-key') // 本地测试，Key 不能为空但可以随便填
    ->make();

try {
    $response = $client->chat()->create([
        'model' => 'qwen2.5-coder:7b', // 刚才你在终端下载的模型名称
        'messages' => [
            ['role' => 'user', 'content' => '用 PHP 编写一个经典的单例模式（Singleton）代码。']
        ],
    ]);

    echo "本地 AI 回复：\n";
    echo $response->choices[0]->message->content;

} catch (\Exception $e) {
    echo "连接本地模型失败，请确认 Ollama 是否在后台运行。错误: " . $e->getMessage();
}

请谨慎使用此类代码。

请问在配置过程中：

• 你的 Mac 是 Apple Silicon（M系列芯片） 还是较老的 Intel 芯片？（影响本地模型运行的流畅度）

• 在安装 Composer 包或请求接口时，是否遇到了网络连接超时的问题？

如果你遇到报错，可以把具体的错误信息发给我，我来帮你排查。