PHP通过百炼调用Kimi K3.1 Pro：cURL请求与多轮对话参数说明-php教程-PHP中文网

php可以通过curl调用阿里云百炼提供的kimi k3.1 pro兼容接口，发送messages数组并读取返回的助手内容。这里使用的是百炼账户、业务空间和对应地域地址，不能混用kimi原厂key或其他平台的接口域名。

准备服务端配置

确认PHP已启用cURL扩展，并在百炼侧具备相应模型调用权限。以下示例采用北京地域，业务空间ID与API Key通过服务端环境变量BAILIAN_WORKSPACE_ID和DASHSCOPE_API_KEY提供。北京地域的HTTP地址结构为业务空间子域名加/compatible-mode/v1/chat/completions。使用其他地域时，应替换为对应的服务地址，不能只换密钥而保留错误地域。

用cURL发送一次文本请求

下面按兼容接口的请求合同编写PHP示例，使用kimi-k3.1-pro模型。首次调用保留简短输入，不额外添加未经确认支持的采样参数。

<?php $workspace = getenv('BAILIAN_WORKSPACE_ID');
$key = getenv('DASHSCOPE_API_KEY');
if (!$workspace || !$key) {
    throw new RuntimeException('缺少业务空间或API Key环境变量');
}
$url = 'https://' . $workspace
    . '.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions';
$messages = [['role' => 'user', 'content' => '用两句话解释PHP数组。']];
$body = json_encode([
    'model' => 'kimi-k3.1-pro',
    'messages' => $messages,
], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $key,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => $body,
    CURLOPT_CONNECTTIMEOUT => 15,
    CURLOPT_TIMEOUT => 180,
]);
$response = curl_exec($ch);
if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status = 300) {
    throw new RuntimeException('模型请求失败，HTTP状态：' . $status);
}
$result = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
echo $result['choices'][0]['message']['content'] ?? '';

示例在PHP服务端运行，密钥不发送到浏览器。连接失败、HTTP错误和正常JSON响应分别处理，便于判断问题发生在哪一层；TLS证书验证保持默认开启。

Kimi Usage Monitor

监控Kimi K2.5 API使用量和配额。通过Kimi控制台实现：(1)查看剩余使用百分比和重置计时器；(2)根据可用配额自主决策任务优先级；(3)密集操作前监控速率限制；(4)记录使用模式以支持资源规划。适用于配额约束下的自主智能体。

下载

百炼Kimi文档中的业务空间与接口地址

多轮对话保留消息顺序

下一轮请求需要继续提交必要的历史messages，不能指望接口仅凭上一条请求自动记住会话。把上一轮助手消息保留在历史中，再追加新的user消息；涉及工具调用或思考字段时，应遵守该模型要求，保留需要回传的完整消息结构。网站中应将不同用户的会话分别存放，并限制历史长度，避免串号和无限累计。不要把其他用户内容或后台密钥拼进聊天历史。