在内容类平台开发中,借助大模型生成个性化推荐内容可以大幅提升用户体验,vivo大模型提供了成熟的文本生成能力,通过php调用其服务可以快速搭建对应的推荐接口。下面详细介绍完整的实现过程。

前期准备工作
在开始开发前,需要先完成以下准备事项:
- 注册vivo开放平台账号,创建应用后获取
APP_ID和APP_SECRET,这是调用接口的身份凭证 - 确认php环境版本不低于7.2,且已开启
curl扩展,用于发送HTTP请求 - 查看vivo大模型的官方接口文档,明确生成类接口的请求地址、参数格式和返回结构
接口鉴权实现
vivo大模型接口采用签名鉴权机制,需要按照规则生成请求签名,php实现签名的代码如下:
<?php
/**
* 生成vivo大模型接口请求签名
* @param string $appId 应用ID
* @param string $appSecret 应用密钥
* @param array $params 请求业务参数
* @return string 最终签名
*/
function generateVivoSign($appId, $appSecret, $params) {
// 1. 拼接签名字符串,按参数名ASCII升序排列
ksort($params);
$signStr = '';
foreach ($params as $key => $value) {
if ($key != 'sign' && $value !== '') {
$signStr .= $key . '=' . $value . '&';
}
}
// 2. 拼接appId和appSecret
$signStr .= 'app_id=' . $appId . '&app_secret=' . $appSecret;
// 3. MD5加密后转为大写
return strtoupper(md5($signStr));
}
?>
构造推荐内容生成请求
个性化推荐内容需要结合用户的浏览历史、偏好标签等信息构造请求参数,调用vivo大模型的文本生成接口,完整请求代码如下:
<?php
/**
* 调用vivo大模型生成个性化推荐内容
* @param string $appId 应用ID
* @param string $appSecret 应用密钥
* @param array $userTags 用户偏好标签数组
* @param string $apiUrl 接口请求地址
* @return array 接口返回结果
*/
function getRecommendContent($appId, $appSecret, $userTags, $apiUrl) {
// 构造业务参数
$bizParams = [
'prompt' => '根据以下用户偏好生成3条个性化内容推荐:' . implode(',', $userTags),
'max_tokens' => 500,
'temperature' => 0.7,
'top_p' => 0.9,
'timestamp' => time()
];
// 生成签名
$sign = generateVivoSign($appId, $appSecret, $bizParams);
$bizParams['sign'] = $sign;
$bizParams['app_id'] = $appId;
// 发送POST请求
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($bizParams));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json'
]);
$response = curl_exec($ch);
$error = curl_error($ch);
curl_close($ch);
if ($error) {
return ['code' => -1, 'msg' => '请求失败:' . $error];
}
return json_decode($response, true);
}
?>
封装推荐接口入口
将调用逻辑封装为可对外提供服务的接口,接收前端传递的用户标签参数,返回生成的推荐内容:
<?php
// 接口配置
$appId = '你的APP_ID';
$appSecret = '你的APP_SECRET';
$apiUrl = 'https://api.ipipp.com/vivo/llm/generate'; // 替换后的接口地址
// 获取请求参数
$input = json_decode(file_get_contents('php://input'), true);
$userTags = $input['user_tags'] ?? [];
if (empty($userTags) || !is_array($userTags)) {
echo json_encode(['code' => 400, 'msg' => '用户标签参数不能为空']);
exit;
}
// 调用生成方法
$result = getRecommendContent($appId, $appSecret, $userTags, $apiUrl);
// 返回结果
if ($result['code'] == 0) {
$recommendList = json_decode($result['data']['content'], true);
echo json_encode(['code' => 0, 'msg' => 'success', 'data' => $recommendList]);
} else {
echo json_encode(['code' => 500, 'msg' => '生成推荐内容失败:' . ($result['msg'] ?? '未知错误')]);
}
?>
常见问题处理
开发过程中可能遇到以下问题,可参考对应方案解决:
- 鉴权失败:检查
APP_ID和APP_SECRET是否正确,签名拼接规则是否和官方要求一致,参数排序是否按ASCII升序 - 返回内容不符合预期:调整
prompt的表述,优化用户标签的传递格式,适当修改temperature等生成参数 - 请求超时:检查服务器网络是否可访问vivo大模型接口地址,适当调大curl的超时时间设置
总结
通过以上步骤,就可以完成php调用vivo大模型服务生成个性化推荐内容接口的开发。实际使用中可以根据业务需求调整prompt的构造逻辑,结合用户更多维度的行为数据生成更精准的推荐内容,同时建议添加接口限流、缓存等机制,提升接口的稳定性和响应速度。