php站点可以通过longcat的openai兼容接口调用longcat-2.5，不需要先自行部署1.6万亿参数权重。接入时需要平台api密钥、php curl扩展和可访问对应接口的运行环境，模型名称、鉴权头和请求格式应配套使用。
LongCat官方兼容接口与调用示例
准备环境和请求地址
将密钥保存到LONGCAT_API_KEY环境变量。下面使用官网当前示例中的api.longcat.ai地址和Chat Completions路径；已有项目迁移时按自身平台当前文档核对基地址，不把其他兼容格式的路径混进来。
<?php
$key = getenv('LONGCAT_API_KEY');
if (!$key) { throw new RuntimeException('请先设置LONGCAT_API_KEY'); }
$url = 'https://api.longcat.ai/openai/v1/chat/completions';
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 120,
CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . $key, 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode([
'model' => 'LongCat-2.5',
'messages' => [['role' => 'user', 'content' => '请解释PHP数组的一个常见用途。']],
'max_tokens' => 4096,
], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR),
]);
$raw = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
$error = curl_error($ch);
curl_close($ch);
if ($raw === false) { throw new RuntimeException('网络请求失败：' . $error); }
if ($status < 200 || $status >= 300) { throw new RuntimeException('接口返回HTTP ' . $status); }
$data = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
$text = $data['choices'][0]['message']['content'] ?? '';
if ($text === '') { throw new RuntimeException('未获得可用文本，请检查返回结构和输出预算'); }
echo $text;响应、限制和重试分开处理
成功响应从choices中的message.content读取文本。401应核对密钥及账号权限，400应检查请求参数，429按平台返回的限流信息安排退避；不能把所有非成功状态都立即重复提交。
按任务设置输出预算
官方参数页区分总上下文与max_tokens输出上限。示例只演示一次文本请求，未启用流式返回，也未承诺固定速度或费用。若返回因长度限制结束，应根据实际结果调整预算后再决定后续处理。
