PHP调用Ollama兼容API：Responses截断变化与空模型列表处理-php教程-PHP中文网

ollama 0.40.16调整了兼容api：/v1/responses开始遵循truncation参数，不再默认静默截断；没有本地模型时，/v1/models返回空列表。php调用端应同时处理http错误、responses的输出结构和空数组，避免把旧行为写死在程序里。

Ollama官方Responses请求示例，语言为Python，正文另给PHP实现

先核对本地服务与模型

以下示例针对本地Ollama服务，需要PHP启用cURL，服务在本机11434端口运行，并已准备可用模型。模型名替换成实际安装的名称；本地服务与需要认证的云端入口不是同一套使用条件。

curl http://localhost:11434/v1/models

按兼容接口返回的data数组检查可选模型。data为空时，先处理模型准备问题，不继续使用不存在的固定模型名。

发送非流式Responses请求

下面示例使用JSON请求读取兼容Responses接口。未显式开启自动截断时，应保留服务端的错误反馈，而不是捕获错误后静默删掉用户输入。

<?php $payload = json_encode([
    'model' => 'qwen3:8b',
    'input' => '用一句中文解释HTTP缓存。',
], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);

$ch = curl_init('http://localhost:11434/v1/responses');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_CONNECTTIMEOUT => 10,
    CURLOPT_TIMEOUT => 120,
]);
$raw = curl_exec($ch);
if ($raw === false) {
    $error = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($error);
}
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
if ($status >= 400) {
    throw new RuntimeException('Ollama HTTP ' . $status . ': ' . $raw);
}
foreach ($data['output'] ?? [] as $item) {
    foreach ($item['content'] ?? [] as $part) {
        if (($part['type'] ?? '') === 'output_text') {
            echo $part['text'] ?? '';
        }
    }
}

空模型列表按正常空结果处理

读取/v1/models后先确认data是数组，再检查数量。空数组表示当前查询没有可选本地模型，不应直接访问data[0]，也不能把它自动解释成服务掉线。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

$models = $data['data'] ?? [];
if (!is_array($models) || $models === []) {
    throw new RuntimeException('当前没有可选模型，请先核对本地模型。');
}

上面的data变量指模型列表接口的JSON结果，不是前一段Responses的响应。实际项目应分别保留两个请求结果，避免混用返回结构。

升级后检查长输入与解析分支

分别验证正常输入、超长输入、空模型列表和非200响应。Responses不能直接套用chat/completions的choices[0].message结构。流式请求还需要单独实现事件解析，不能把流式字节当作完整JSON一次解码。

大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！