DALL·E 4 图像生成报错时，密钥和请求体并不是二选一的先后关系，而是由一次最小请求来分叉：最简调用就失败，优先查密钥、端点和网络；最简调用能返回图像，才把变量加回来查请求体、提示词和额度。先做分叉、再逐项排除，比在错误的层面反复改参数省事。

判断方向：先不要动请求体。用只保留模型名和一句最简提示词的请求打一次，通不通决定往哪查。最简请求也报错，先确认密钥是否真的被程序读到、作用域和调用端点是否匹配；最简请求能出图，再逐项加回自己的字段，定位是字段、提示词还是额度触发。全程保存状态码、响应头和响应体，不要凭记忆复述报错。

排查顺序可以固定成五步，先分叉再细查，每一步都要有可观察的通过条件：

用最小请求排除提示词问题

目的只有一个：确认基础调用链路是否通。把提示词缩短成一句话，去掉所有可选字段，只留模型名和 prompt。端点路径、模型名和必填字段名以你实际接入的文档为准，下面的骨架只演示结构，尖括号和中文占位都要替换。

curl -i -X POST "$BASE_URL/按文档填写的图像生成路径" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "按实际文档填写的模型名",
    "prompt": "a plain red square on a white background"
  }'

执行前先确认 $BASE_URL 和 $API_KEY 在当前 shell 里已经导出。这条请求返回图像 URL 或图像数据，说明密钥、端点和基础请求体都没问题，问题更可能出在提示词、可选参数或额度；这条也失败，就不要继续改 prompt，转到密钥和状态码排查。

提示词层面常见的触发点是内容被策略拦截、请求过长、参数与提示词不匹配。判断方式是保持同一个最简 prompt，只切换一个可疑字段，看错误是否跟着这个字段走，而不是一次改好几处。提示词本身是否被拒，看错误消息里的措辞通常能判断，不要靠猜。

检查密钥环境变量与权限

要把三种情况分开：密钥没读到、密钥格式不对、密钥有效但权限或作用域不足。先看程序到底取到了什么，不要只看 .env 文件是否存在。

import os

key = os.environ.get("IMAGE_API_KEY")
print("exists:", key is not None)
print("length:", len(key) if key else 0)
print("has_space_or_newline:", bool(key and (key != key.strip() or "\n" in key)))

把变量名换成你项目实际使用的名字。密钥缺失时得到 None；长度明显异常或带首尾空白，通常是复制时带进了换行、引号或空格；长度正常但仍报鉴权类错误，才轮到权限问题。

权限和端点要一起看：密钥所属的项目或组织是否被允许调用该图像模型、密钥作用域是否只开了其他能力、请求是否打到了正确的区域或网关。验证方式是用同一把密钥发一次上面那条最小请求，观察状态码是否变化。换密钥后结果变了，问题在密钥侧；换密钥后结果一样，继续查端点和请求体。密钥内容不要贴进公开问答或提交到代码仓库。

校验请求体字段名和类型

请求体错误多数不是「写错一个词」这么明显，而是字段名拼写、类型、是否必填三件事混在一起。先用占位骨架列出你实际会传的字段，再逐项决定是否保留。

{
  "model": "<按文档填写>",
  "prompt": "<必填，最简提示词>",
  "n": 1,
  "size": "<按文档填写，例如方形尺寸字符串>",
  "response_format": "<按文档填写，或整行删除>"
}

逐项注释的做法：把上面除 model 和 prompt 之外的字段全部删掉先发一次；通了以后每次只加回一个字段，并在该行上方用注释写清它的来源和取值依据。字段类型要与文档一致，比如数量是整数而不是字符串，尺寸是文档规定的枚举值而不是自造值。必填项缺失通常报参数类错误；字段名拼错有时表现为未知字段被忽略，看起来没报错但行为不符预期，所以加回字段后要核对返回结果是否真的按该字段生效，比如是否真的按指定数量返回。

按状态码和错误消息分类

状态码决定往哪一层查，错误消息决定要不要换请求体。下表只是分类方向，具体数字以你实际收到的响应为准，不要照抄状态码去猜服务端行为。

记录时同时写下状态码、错误类型（响应体里若有分类字段就照抄）和完整错误消息原文。只记「报错了」没有用，同一条消息的不同措辞往往指向不同字段，原样保留才不会在二次排查时走偏。

保存响应头和响应体复现

排查不靠记忆：每次请求都把响应头和响应体落地到文件。用 curl 时加 -D 保存响应头、-o 保存响应体，或直接用 -i 把两者打到终端再重定向。

curl -i -X POST "$BASE_URL/按文档填写的图像生成路径" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"按实际文档填写的模型名","prompt":"a plain red square on a white background"}' \
  -D ./headers.txt -o ./body.json

记录四样东西：请求 ID（响应头中通常有一个用于追踪的字段，具体字段名以实际返回为准）、完整响应头、完整响应体、以及发起请求的本地时间（含时区）。请求 ID 用于向服务方核对日志；响应头中的限制类字段用于判断 429 类问题；响应体中的错误消息用于判断字段问题；时间用于判断重试是否紧挨着上一次请求。重试用同一条最小请求、同样的记录方式，这样两次结果才可比较。