PHP8.3 接入 Gemini 怎么一次性上传多张图片-php教程-PHP中文网

php 8.3 可通过 google ai sdk 或 rest api 向 gemini pro-vision 一次性提交多张图片，需将每张图读取为二进制、base64 编码并指定准确 mime 类型后嵌入 json 请求的 inlinedata 中，不支持传统表单上传。

php8.3 接入 gemini 怎么一次性上传多张图片

PHP 8.3 本身不直接支持向 Gemini（Google 的 Gemini API）上传多张图片，因为 Gemini API（尤其是 gemini-pro-vision 模型）**不接受传统 multipart 表单上传**，而是要求将图片以 Base64 编码后嵌入 JSON 请求体，并且必须使用 Google 官方推荐的 Google AI SDK（google/ai-vertex 或 google/ai-generative）或 REST API 方式调用。

✅ 关键前提：用 Google AI SDK（推荐）或 REST API

Gemini 不提供类似 “/upload” 的独立图片上传接口。所有图片需在调用 generateContent 时一并提交，且每张图需：

读取为二进制内容（file_get_contents()）
Base64 编码（base64_encode()）
指定正确的 MIME 类型（如 image/jpeg, image/png）
作为 inlineData 对象加入 parts 数组

✅ PHP 8.3 示例：一次性传多张图 + 文字提示

以下使用官方 google/ai-generative SDK（v0.7+ 支持 Gemini 1.5/Pro-Vision）：

Baoyu Danger Gemini Web

通过逆向工程的Gemini网页API生成图像和文本。支持文本生成、提示词图像生成以及用于视觉输入的参考图像等。

下载

// 1. 安装 SDK（Composer）
// composer require google/ai-generative

// 2. PHP 代码示例
use Google\AI\GenerativeModels\GenerativeModel;
use Google\AI\GenerativeModels\Content;
use Google\AI\GenerativeModels\Part;

require 'vendor/autoload.php';

// 初始化模型（需设置 GOOGLE_API_KEY 环境变量 或 显式传入）
$model = new GenerativeModel(
    'gemini-pro-vision',
    ['apiKey' => $_ENV['GOOGLE_API_KEY'] ?? 'your-api-key-here']
);

// 多张本地图片路径
$imagePaths = [
    '/path/to/photo1.jpg',
    '/path/to/diagram.png',
    '/path/to/screenshot.webp'
];

$parts = [];

// 添加文字提示（可选，但建议放在最前）
$parts[] = Part::text("请分析这三张图：描述内容、对比差异、总结共同主题。");

// 逐张读取并添加图片
foreach ($imagePaths as $path) {
    if (!file_exists($path)) {
        throw new Exception("Image not found: {$path}");
    }
    $binary = file_get_contents($path);
    $mimeType = mime_content_type($path); // 自动识别类型，如 image/jpeg
    $base64 = base64_encode($binary);
    
    $parts[] = Part::inlineData($mimeType, $base64);
}

// 构建完整内容
$content = Content::make($parts);

// 调用生成（支持多图！）
try {
    $response = $model->generateContent($content);
    echo $response->text();
} catch (Exception $e) {
    echo "Error: " . $e->getMessage();
}

⚠️ 注意事项（PHP 8.3 实际开发中易踩坑）

文件大小限制：Gemini Pro-Vision 单次请求总 payload ≤ 20MB；单图建议 ≤ 2MB，超大会触发 400 Bad Request
MIME 类型必须准确：不能写成 image/jpg（应为 image/jpeg），否则返回 INVALID_ARGUMENT
内存与超时：多张高清图 Base64 后体积翻倍，确保 memory_limit ≥ 128M，max_execution_time ≥ 60
API Key 安全：切勿硬编码；用环境变量或 secrets manager 管理
不支持 GIF 动画帧：仅解析首帧；如需多帧分析，需先用 Imagick 分解