http 400错误表明服务端已接收请求但因请求体结构不合法、关键字段缺失、值类型错误或语义冲突而拒绝执行，须聚焦参数本身精准校验：先查响应json中error字段定位具体原因，再用jsonlint验证结构、严格检查version（必为"2.4"字符串）、nodes数组、denoising_strength范围（0.4–0.6）、请求头完整性（含authorization、content-type等），最后用curl隔离前端干扰复现问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
LiblibAI API请求返回HTTP 400错误，说明服务端已接收请求但拒绝执行，根本原因是请求体结构不合法、关键字段缺失、值类型错误或语义冲突，不是网络问题也不是权限问题，必须聚焦参数本身做精准校验。
确认错误响应中的具体原因字段
立即查看返回JSON的error字段内容，例如{"code":400,"error":"missing field: version"}——这比盲目重试高效十倍；若返回中不含error字段或只有空字符串，说明请求甚至没通过网关校验层，需跳转到“检查请求头完整性”环节。
常见error文本有："invalid nodes structure"、"template ID mismatch"、"denoising_strength out of range [0.4, 0.6]"、"image format not supported"——每一条都对应唯一修复路径，不能靠猜测覆盖。
检查请求体JSON结构合法性
方法一：用JSONLint在线工具粘贴原始payload，点击Validate；若报“Unexpected token 'x' at position 123”，说明第123个字符前存在单引号、末尾逗号或注释残留——LiblibAI严格遵循RFC 8259，不接受任何扩展语法。
方法二：在VS Code中安装Prettier插件，右键→Format Document，再手动检查根对象是否仅含且必须含三项：【version】（字符串，值必须为"2.4"）、【nodes】（非空数组）、【edges】（数组，可为空但字段不能缺失）；拼写错一个字母（如"node"）或漏掉逗号导致数组闭合失败，都会触发400。
方法三：导出ComfyUI工作流后，用记事本打开.json文件，搜索console.log(、//、/*，这些调试痕迹会导致解析中断——平台在预处理阶段直接抛错，不进入模型调度流程。
验证关键字段值是否符合硬性约束
第一步：检查version字段是否为字符串"2.4"，不是数字2.4，不是"v2.4"，也不是"2.4.0"；写成2.4会触发JSON类型校验失败，返回"expected string but found number"。
第二步：定位nodes数组，逐项检查每个节点的type字段是否属于LiblibAI原生支持列表，例如"CLIPTextEncode"、"KSampler"、"SaveImage"；若出现"ImpactWildcardProcessor"或"WAS_Text_To_Image"，说明该工作流来自ComfyUI社区插件包，必须手动替换为等效原生节点，否则400报错固定为"unknown node type"。
第三步：检查denoising_strength（图生图场景）是否落在0.4–0.6闭区间内；传入0.35或0.61都会被拦截，错误提示明确写"out of range"，无需怀疑精度问题。
检查请求头完整性
打开浏览器开发者工具→Network→找到失败请求→Headers→向下滚动至Request Headers；确认以下四项全部存在且格式正确：
X-Liblib-Access-Key：值必须为20–30位纯字母数字组合，不能带空格或下划线；
Authorization：格式为Bearer 后跟一个有效token，中间有且仅有一个空格；
Content-Type：必须为application/json，少一个字母或大小写错误（如application/json;charset=utf-8）都会被拒；
Signature、Timestamp、SignatureNonce：三项必须同时存在，缺一即400；Timestamp必须是毫秒级整数，例如1726882080123，不是秒级时间戳。
【若Authorization字段值以Basic开头，说明你误用了HTTP Basic认证而非Bearer Token，这是典型配置错误】。
用curl命令隔离前端干扰复现问题
在终端执行以下命令（替换YOUR_ACCESS_KEY、YOUR_SECRET_KEY和实际JSON路径）：
curl -X POST "https://api.liblib.ai/v1/generate/webui/text2img?AccessKey=YOUR_ACCESS_KEY&Signature=xxx&Timestamp=1726882080123&SignatureNonce=abc123" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d @./payload.json
若curl成功而前端失败，说明问题出在JavaScript签名生成逻辑或请求体序列化过程；若curl也返回400，则问题100%在payload或参数拼接环节，可排除网络和浏览器策略干扰。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
