PHP怎么调用Gemini 4 Carbon？-php教程-PHP中文网

php可通过curl直接调用gemini interactions rest接口，将model设为gemini-4-carbon，并从返回的model_output步骤读取文本。前提是php启用curl扩展、服务器能访问该服务，且api项目已开通付费层；本例使用php 8及以上版本，不需要安装第三方php sdk。

准备API密钥和运行环境

在Google AI Studio创建或选择API密钥，并为对应项目设置计费。把密钥配置为服务器环境变量GEMINI_API_KEY，不写入网页JavaScript或公开源码。命令行PHP与网站所用PHP可能加载不同配置，需要在实际执行入口确认cURL扩展可用。

PHP官方cURL扩展文档

php -m
export GEMINI_API_KEY="替换为实际密钥"

发送文本请求并读取结果

将以下代码保存为gemini.php。请求使用JSON正文、x-goog-api-key认证头，并保留官方入门示例中的API修订头。REST返回的是完整Interaction资源，因此按steps读取文本，不能直接照搬SDK的output_text便利属性。

Generate images & videos with: Gemini 3 Pro Image + Qwen Wan 2.6 (video) via one API key

使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image（图像）和Qwen Wan 2.6（视频）。

下载

Gemini官方入门文档中的Interactions REST调用示例

<?php $key = getenv('GEMINI_API_KEY');
if (!$key) {
    throw new RuntimeException('请先设置 GEMINI_API_KEY');
}
$payload = json_encode([
    'model' => 'gemini-4-carbon',
    'input' => '用三句话说明 PHP 数组的常见用途。',
], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
$ch = curl_init('https://generativelanguage.googleapis.com/v1beta/interactions');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 15,
    CURLOPT_TIMEOUT => 180,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'x-goog-api-key: ' . $key,
        'Api-Revision: 2026-05-20',
    ],
    CURLOPT_POSTFIELDS => $payload,
]);
$raw = curl_exec($ch);
if ($raw === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$data = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
if ($status = 300) {
    throw new RuntimeException('API请求失败，HTTP ' . $status);
}
if (($data['status'] ?? '') !== 'completed') {
    throw new RuntimeException('本例仅处理已完成的同步请求');
}
foreach ($data['steps'] ?? [] as $step) {
    if (($step['type'] ?? '') !== 'model_output') continue;
    foreach ($step['content'] ?? [] as $part) {
        if (($part['type'] ?? '') === 'text') echo $part['text'] ?? '';
    }
}