公告AI接口网提供各类可接入的人工智能接口
AI接口网AI 接口选型与接入工程手册
首页/接入实战/SDK 还是裸 HTTP:六种语言的现实选择

SDK 还是裸 HTTP:六种语言的现实选择

2026-11-22约 7 分钟读完SDKPHPGo接入

接 AI 接口时,SDK 与裸 HTTP 的取舍不是风格问题,而是「谁承担兼容性维护」的问题。

一句话结论

语言建议理由
Python官方 SDK 或 httpx 裸调生态最好,两者都成熟
Node/TypeScript官方 SDK类型定义完善,流式封装好
PHP裸 curlSDK 更新滞后,且 PHP 项目多为传统部署
Go裸 http.Client官方 SDK 不稳定,自己封一层 30 行更可控
Java官方 SDK 或 OkHttp企业项目注意依赖冲突
C#/.NET官方 SDKAzure 生态整合好

PHP 裸调的最小封装

PHP 项目(尤其传统 LNMP 部署)用 SDK 经常遇到 composer 版本冲突、ext 缺失。裸 curl 反而最稳:

php
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;
}
PHP 细节
PHP 里 json_encode 一定要加 JSON_UNESCAPED_UNICODE,否则中文变成 \uXXXX,请求体大一倍,某些网关还会因此判超长。

Go 的最小封装要点

  • 用 http.Client{Timeout: ...},不要用包级默认客户端(它没有超时)。
  • 流式响应用 bufio.Scanner,注意默认行长度上限 64KB,长 JSON 行要手动扩容。
  • 错误响应体要读出来再判断,只靠状态码会丢掉关键信息。
  • 重试要用 context.WithTimeout 控制总时长,别让重试链无限延长。

什么时候必须用 SDK

  • 需要它帮你处理签名(某些厂商的鉴权需要 HMAC/JWT,手写容易错)。
  • 需要它处理流式与工具调用的复杂拼接。
  • 需要它的重试与连接池默认值(省掉调参)。

反过来,如果你只是发一个 JSON、收一个 JSON,裸 HTTP 永远是更可控的选择——尤其当你需要同时对接多家、需要统一超时与日志时。

说明
文中价格、配额、限额均为撰写时的公开口径,会随厂商调整变化;用于估算量级,不构成报价。具体以各厂商官方文档与合同为准。