报错排查 · 413

413:一次塞得太多了

413 是服务器在读完请求前就拒绝,通常发生在图片 base64 或超长文本上。不是模型上下文不够,而是请求体本身太大。

三个典型场景

  • 图片直接转 base64:一张 4MB 的照片 base64 后约 5.3MB,几张就顶到上限;
  • 整本书 / 整份日志塞进 prompt:文本 token 与字节数不是 1:1,中文尤其占字节;
  • 批量数组请求:一次提交几百条 embedding 输入。

处理方式

  1. 图片先压缩:长边压到 1568px 以内、转 JPEG/WebP,体积能降 80%;多数视觉模型对分辨率上限也有要求;
  2. 文本分块:按段落切分后逐块请求,再用一次调用汇总,避免单请求超限;
  3. 用文件/批处理接口:需要传大文件时走独立的上传接口,不要塞进 JSON;
  4. 检查是不是客户端在重复发送:有些客户端把整个会话历史 + 附件每次全带上,越聊越大。

上限在哪一层

请求要经过 CDN 与源站两层,任何一层的体积上限都会返回 413。 判断方法:用同样的内容在本地直接 curl 源站域名,如果本地能过而客户端不行,就是客户端多带了内容。

最小复现bash
curl https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-5","messages":[{"role":"user","content":"hi"}]}'

别把 413 和上下文超限搞混

上下文超限通常返回 400(context_length_exceeded),413 是「请求体字节数」太大。 前者要减少 token,后者要减小文件体积。

常见问题

413 和上下文超限有什么区别?

413 是请求体字节数超限(图片、附件、长文本),400 context_length_exceeded 是 token 数超过模型上下文窗口。

发图片报 413 怎么处理?

先把图片压到长边 1568px 以内并转 JPEG/WebP,再重试;仍不行就减少一次发送的图片数量。