← 返回教程与交流

一次 API 请求最多能传多少张图、多大的图?Gemini 内联整请求 20MB,OpenAI 最多 1,500 张,Claude 单张最大 8000×8000 px

多图输入时最容易踩的是张数、体积和尺寸上限。据各家官方文档(2026-10-26 核对):Gemini 用内联方式传图时,整个请求(含文本、系统指令和内联数据)上限 20MB,更大的请求要用 File API;OpenAI 每个请求最多 1,500 张图、总共 512 MB,单图超过 30,000 个 patch 会被拒绝而不是自动缩小;Claude 每张图最大 8000×8000 px,一次超过 20 张时尺寸限制更严。本文附上传前检查清单和问答。

一次 API 请求最多能传多少张图、多大的图?Gemini 内联整请求 20MB,OpenAI 最多 1,500 张,Claude 单张最大 8000×8000 px封面

结论先看:Gemini 用内联方式传图,整个请求上限是 20MB;OpenAI 每个请求最多 1,500 张图、总共 512 MB;Claude 每张图最大 8000×8000 px,一次传超过 20 张时尺寸要求更严。三家的限制方式不同,有的限总体积,有的限张数,有的限单张尺寸。


说明:以下据各家官方图像输入文档(2026-10-26 核对),我们没有做实测。

Gemini 一次请求能放多大的图?


Gemini 图像理解文档写明:

  • 用内联方式传图时,整个请求的大小上限是 20MB。
  • 这 20MB 包括文本提示、系统指令和内联的图片数据,不只是图片本身。
  • 更大的请求,要先用 File API 上传图片文件。

所以提示词和系统指令很长的时候,留给图片的空间会更少。

OpenAI 支持哪些格式,最多传多少张?


OpenAI 图像输入文档写明:

  • 文件格式:PNG、JPEG(.jpeg 或 .jpg)、WEBP,以及非动图的 GIF。
  • 请求大小:每个请求总共最多 512 MB。
  • 图片张数:每个请求最多 1,500 张。
  • 单图上限:每张图最多 30,000 个 patch。

OpenAI 文档原文:Images that exceed the 30,000-patch limit after processing are rejected, not automatically resized.(处理后超过 30,000 个 patch 的图片会被拒绝,不会自动缩小。)

也就是说,超大的单张图要自己先缩小,不能指望接口帮你处理。

Claude 的图片张数和尺寸上限是多少?


Anthropic 视觉文档写明:

  • 张数:上下文窗口为 200k token 的模型,每个请求最多 100 张;其他模型每个请求最多 600 张。
  • 尺寸:每张图最大 8000×8000 px。
  • 多图:一个请求超过 20 张图时,单图尺寸限制更严。官方给的办法是把每张图缩到长宽都不超过 2000 px,或者把请求控制在 20 个以内的图片和文档块。
  • 体积:Claude API 和 Claude Models on Google Cloud(Google managed)上单张 10 MB(按 base64 编码后计算);Amazon Bedrock 上是 5 MB(按 base64 编码后计算)。

同一个模型在不同平台上,单张图的体积上限不一样,换平台时要重新核对。

三家的上限放在一起怎么看?


按限制类型来看:

  • 限整个请求的体积:Gemini 内联 20MB(含文本);OpenAI 总共 512 MB。
  • 限张数:OpenAI 1,500 张;Claude 100 张或 600 张,视模型而定。
  • 限单张尺寸:Claude 8000×8000 px,超过 20 张时长宽不超过 2000 px;OpenAI 按 patch 数,每张最多 30,000 个。
  • 限单张体积:Claude 10 MB 或 5 MB,视平台而定,按 base64 编码后计算。
  • 限格式:OpenAI 写明支持 PNG、JPEG、WEBP 和非动图 GIF。

上限只说明「最多能传多少」,不代表传满就合适。张数多了,输入 token 和费用也会跟着涨。

上传前要检查哪几项?


  1. 格式:是不是目标平台支持的格式。OpenAI 不支持动图 GIF。
  2. 张数:有没有超过这个模型的单请求上限。用 Claude 时先查模型的上下文窗口是不是 200k。
  3. 单张尺寸:Claude 不超过 8000×8000 px;一次超过 20 张时,长宽都不超过 2000 px。
  4. 单张体积:Claude 按 base64 编码后计算。base64 编码后的体积会比原文件大,要按编码后的大小核对。
  5. 整个请求体积:Gemini 内联方式要把文本、系统指令一起算进 20MB;OpenAI 总共不超过 512 MB。
  6. 平台差异:同样是 Claude,在 Amazon Bedrock 上单张上限是 5 MB。
  7. 超大单图:OpenAI 超过 30,000 个 patch 会直接被拒绝,提前缩小。

超限了一般怎么处理?


  • Gemini 请求太大:改用 File API 上传图片,不用内联。
  • Claude 一次超过 20 张:把每张缩到长宽不超过 2000 px,或者拆成多个请求,每个不超过 20 个图片和文档块。
  • Claude 单张体积超限:压缩或缩小图片;在 Bedrock 上按 5 MB 准备。
  • OpenAI 单图 patch 超限:先缩小图片再上传。
  • 张数超限:拆成多个请求分批处理。

还有哪些常见问题?


问:Gemini 的 20MB 只算图片吗?
答:不是。官方写明这 20MB 是整个请求的大小,包括文本提示、系统指令和内联数据。

问:OpenAI 会自动缩小太大的图吗?
答:不会。官方写明超过 30,000 个 patch 的图片会被拒绝,不会自动缩小。

问:Claude 一次最多能传多少张图?
答:上下文窗口为 200k token 的模型每个请求最多 100 张,其他模型最多 600 张;超过 20 张时尺寸限制更严。

问:Claude 在 Bedrock 上单张图上限一样吗?
答:不一样。Claude API 上是 10 MB,Amazon Bedrock 上是 5 MB,都按 base64 编码后计算。

本文由模型港 NextRelay 按各家官方页面整理,以官方页面为准。

最后更新:2026-10-27

获取 API Key