接 AI 接口时,SDK 与裸 HTTP 的取舍不是风格问题,而是「谁承担兼容性维护」的问题。
| 语言 | 建议 | 理由 |
|---|---|---|
| Python | 官方 SDK 或 httpx 裸调 | 生态最好,两者都成熟 |
| Node/TypeScript | 官方 SDK | 类型定义完善,流式封装好 |
| PHP | 裸 curl | SDK 更新滞后,且 PHP 项目多为传统部署 |
| Go | 裸 http.Client | 官方 SDK 不稳定,自己封一层 30 行更可控 |
| Java | 官方 SDK 或 OkHttp | 企业项目注意依赖冲突 |
| C#/.NET | 官方 SDK | Azure 生态整合好 |
PHP 项目(尤其传统 LNMP 部署)用 SDK 经常遇到 composer 版本冲突、ext 缺失。裸 curl 反而最稳:
function ai_chat(array $cfg, array $messages, array $opt = []) {
$payload = [
'model' => $cfg['model'],
'messages' => $messages,
'temperature' => $opt['temperature'] ?? 0.3,
'max_tokens' => $opt['max_tokens'] ?? 1200,
];
$ch = curl_init($cfg['base_url'] . '/chat/completions');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 5,
CURLOPT_TIMEOUT => $cfg['timeout'] ?? 60,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'Authorization: Bearer ' . $cfg['key'],
],
CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
]);
$raw = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$err = curl_error($ch);
curl_close($ch);
if ($raw === false) throw new RuntimeException('network: ' . $err);
$data = json_decode($raw, true);
if ($code !== 200) {
$msg = $data['error']['message'] ?? substr($raw, 0, 200);
throw new RuntimeException('api ' . $code . ': ' . $msg);
}
return $data;
}json_encode 一定要加 JSON_UNESCAPED_UNICODE,否则中文变成 \uXXXX,请求体大一倍,某些网关还会因此判超长。http.Client{Timeout: ...},不要用包级默认客户端(它没有超时)。bufio.Scanner,注意默认行长度上限 64KB,长 JSON 行要手动扩容。context.WithTimeout 控制总时长,别让重试链无限延长。反过来,如果你只是发一个 JSON、收一个 JSON,裸 HTTP 永远是更可控的选择——尤其当你需要同时对接多家、需要统一超时与日志时。