recraft错误代码分五类：一、连接类（代理/dns/防火墙）；二、认证类（401/403，需清缓存重登录）；三、配额类（查控制台、降并发）；四、输入类（prompt长度、图格式、宽高比）；五、用/diagnose页一键检测。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Recraft过程中遇到各类错误代码，系统通常会返回特定的错误标识以提示问题类型。以下是针对这些错误代码的分类解析与对应处理方式：
一、连接类错误代码
此类错误表明Recraft客户端无法正常与后端服务建立或维持网络通信，常见于代理配置异常、DNS解析失败或防火墙拦截场景。
1、检查当前网络是否可访问 recraft.ai 域名，可在终端执行 ping recraft.ai 或 curl -I https://recraft.ai 验证连通性。
2、确认系统代理设置未启用全局代理，或已将 recraft.ai 及其子域名加入代理白名单。
3、若使用企业网络，联系管理员确认是否屏蔽了 WebSocket 连接（wss://api.recraft.ai）或 CORS 请求头。
二、认证与权限类错误代码
该类错误多由凭证失效、Token过期、账户权限不足或跨域调用未授权导致，服务端通常返回 401 或 403 状态码及对应错误标识。
1、清除浏览器中与 Recraft 相关的所有 Cookie 和 LocalStorage 数据，尤其是 auth_token 和 session_id 字段。
2、重新登录账户，确保登录时未启用隐私模式或广告拦截插件，避免身份令牌被拦截。
3、如为 API 调用场景，验证请求 Header 中是否包含有效的 Authorization: Bearer
三、资源与配额类错误代码
当用户超出免费层限制、并发数超限、图像生成次数耗尽或模型调用配额用完时，服务将返回明确的配额拒绝错误。
1、登录 Recraft 控制台，在 Billing & Usage 页面查看当前周期剩余配额及历史消耗趋势。
ApiPost是一个支持团队协作，支持模拟POST、GET、PUT等常见请求，并可直接生成文档的API调试、管理工具，ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具，ApiPost官方版界面美观大方，功能强劲实用，支持团队协作，支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键
2、确认所选模型是否属于付费层级（如 recraft-v3-pro），免费账户默认仅可调用 recraft-v3-base。
3、若批量提交任务失败，将并发请求数降至 1 并逐个重试，避免触发速率限制（RateLimit: 5 req/sec）。
四、输入内容类错误代码
该类错误源于用户提交的提示词（prompt）、图像参数或格式不符合接口规范，例如超长文本、非法 Base64 编码、不支持的宽高比等。
1、校验 prompt 字符长度是否超过 1000 字符 限制，截断冗余描述并保留核心关键词。
2、如上传参考图，确认文件为 JPEG/PNG 格式、大小不超过 8MB，且 Base64 字符串无换行或空格。
3、检查 width/height 参数是否为 64 的整数倍，且组合符合预设比例（如 1:1、16:9、4:3），禁止提交 0 或负值。
五、一键诊断工具使用说明
Recraft 官方提供内置诊断页（/diagnose），可自动捕获当前环境关键指标并定位典型故障点。
1、在任意 Recraft 页面地址栏末尾追加路径 /diagnose，例如 https://app.recraft.ai/diagnose。
2、页面加载后自动执行五项检测：网络连通性、认证状态、WebSocket 可用性、本地存储完整性、API 健康度。
3、每项检测完成后显示状态图标（✅ 表示通过，❌ 表示失败），点击失败项可展开详细错误上下文及修复指引。
