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]，也不能把它自动解释成服务掉线。
立即学习“PHP免费学习笔记（深入）”；
$models = $data['data'] ?? [];
if (!is_array($models) || $models === []) {
throw new RuntimeException('当前没有可选模型，请先核对本地模型。');
}上面的data变量指模型列表接口的JSON结果，不是前一段Responses的响应。实际项目应分别保留两个请求结果，避免混用返回结构。
升级后检查长输入与解析分支
分别验证正常输入、超长输入、空模型列表和非200响应。Responses不能直接套用chat/completions的choices[0].message结构。流式请求还需要单独实现事件解析，不能把流式字节当作完整JSON一次解码。
