ChatGPT API多图片请求：单图不可用致整体报错的解决咨询

问题场景 #

当前使用GPT-4o API批量提交图片进行内容描述时，只要存在至少一个无法访问的图片URL，API就会返回以下错误：

ChatGPT API request with type:image_url — error while downloading, invalid_image_url

现有请求代码（PHP）：

[
    'model' => 'gpt-4o',
    'messages' => [
        [
            'role' => 'user',
            'content' => array_merge(
                [
                    [
                        'type' => 'text',
                        'text' => $prompt
                    ]
                ],
                [
                    'type' => 'image_url',
                    'image_url' => [
                         'url' => $image_url
                    ]
                ]
                )
        ]
    ],
    'max_tokens' => 300
];

需求是一次性上传多张图片，仅对无效图片返回错误提示，其余图片正常处理，避免单图逐个调用API的低效方案。

解决方案：预校验图片可用性后批量提交 #

在向API发送请求前，先对所有图片URL进行有效性校验，筛选出可访问的图片，同时标记无效图片并在prompt中说明，这样API只会处理有效图片，你也能在结果中保留无效图片的错误信息。

步骤1：实现图片URL校验函数

编写HTTP校验逻辑，检查URL是否返回200状态码且内容类型为图片：

function isImageUrlValid($url) {
    // 设置超时时间，可按需调整
    stream_context_set_default(['http' => ['timeout' => 5]]);
    $headers = @get_headers($url, 1);
    
    if (!$headers) {
        return false;
    }
    
    // 验证HTTP状态码和内容类型
    return strpos($headers[0], '200') !== false && 
           isset($headers['Content-Type']) && 
           strpos($headers['Content-Type'], 'image/') !== false;
}

步骤2：批量筛选有效/无效图片

遍历所有图片URL，分类整理有效图片数据和无效图片的报错信息：

// 示例：待处理的多张图片URL数组
$imageUrls = [$url1, $url2, $url3];
$validImageContents = [];
$invalidImageErrors = [];

foreach ($imageUrls as $index => $imgUrl) {
    if (isImageUrlValid($imgUrl)) {
        $validImageContents[] = [
            'type' => 'image_url',
            'image_url' => ['url' => $imgUrl]
        ];
    } else {
        $invalidImageErrors[] = "图片{$index+1}：{$imgUrl} 无法访问或不是有效图片";
    }
}

步骤3：构建包含错误提示的请求

将无效图片的错误信息加入prompt，仅把有效图片传入API请求：

// 基础描述指令
$prompt = "请用少量文字描述每张图片的内容：\n";

// 添加无效图片提示（如果存在）
if (!empty($invalidImageErrors)) {
    $prompt .= "\n以下图片无法访问，无需描述：\n" . implode("\n", $invalidImageErrors);
}

// 组装最终API请求参数
$apiRequest = [
    'model' => 'gpt-4o',
    'messages' => [
        [
            'role' => 'user',
            'content' => array_merge(
                [['type' => 'text', 'text' => $prompt]],
                $validImageContents
            )
        ]
    ],
    'max_tokens' => 300
];

方案优势 #

• 保持批量请求的高效性，减少API调用次数
• 精准区分有效/无效图片，既不影响正常图片的处理，又能明确返回错误信息
• 避免因单个无效URL导致整个请求失败的问题

内容的提问来源于stack exchange，提问作者Timur