首次使用recraft遇403错误，主因是未完成邮箱验证、api密钥未配置、workspace角色不足、referer未白名单或密钥权限受限；需依次检查账户验证与api启用、正确设置authorization头、确认workspace编辑权限、添加允许的origin域名、核查密钥生成图像权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您首次尝试使用Recraft平台时遭遇403 Forbidden错误，提示“权限被拒绝”，这通常并非平台本身故障，而是身份验证未完成、API密钥未配置或账户访问策略限制所致。以下是针对性的修复步骤：
一、检查并启用Recraft账户权限
Recraft要求新用户完成邮箱验证及项目空间授权后，方可调用生成接口。未激活的账户默认处于只读受限状态。
1、登录Recraft官网，进入右上角头像菜单，选择「Settings」。
2、在「Account Security」页面确认邮箱状态为Verified；若显示「Not verified」，点击「Resend verification email」并查收邮件完成验证。
3、切换至「API Access」选项卡，确保「Enable API access」开关处于开启状态。
4、点击「Generate new API key」，复制生成的密钥（以recraft_开头），该密钥需用于后续所有请求头中。
二、正确配置请求头Authorization字段
Recraft API严格校验请求头中的认证信息，缺失、格式错误或过期的密钥将直接触发403响应。
1、在HTTP请求中添加Authorization头，值为Bearer {your_api_key}，其中{your_api_key}替换为上一步复制的完整密钥。
2、确认请求头中不含多余空格或换行符，且Bearer与密钥之间仅有一个英文空格。
3、若使用cURL命令，应形如：curl -H "Authorization: Bearer recraft_xxx" https://api.recraft.ai/v1/generate。
4、若在前端JavaScript中调用，须确保请求通过HTTPS发起，并避免在浏览器控制台直接暴露密钥（建议后端代理转发）。
三、检查项目空间（Workspace）成员角色
Recraft按Workspace隔离资源权限，即使API密钥有效，若当前密钥所属成员在目标Workspace中无「Editor」或更高角色，则无法提交生成任务。
1、进入Recraft控制台，点击左上角Workspace名称，选择目标项目空间。
2、点击右上角「Members」，查找您的账户邮箱，确认角色显示为Editor或Owner。
3、若角色为「Viewer」，请联系该Workspace的Owner，在成员列表中将您升级为Editor。
4、刷新页面后，重新尝试调用API或使用UI界面提交任务。
四、验证Referer与CORS策略（前端集成场景）
当在自有网页中嵌入Recraft SDK或直连其API端点时，Recraft服务端会校验请求来源，非白名单域名将返回403。
1、登录Recraft控制台，进入目标Workspace的「Settings」→「Security」→「Allowed Origins」。
2、在「Allowed Origins」输入框中，添加您网站的完整协议+域名，例如：https://yourdomain.com 或 http://localhost:3000（开发环境必需）。
3、每行仅填写一个Origin，禁止使用通配符*，保存更改。
4、清除浏览器缓存后，重新加载您的网页并测试SDK初始化是否成功。
五、检查API密钥绑定的使用范围限制
Recraft支持为每个API密钥设置细粒度权限，包括模型访问、输出格式、速率限制等。若密钥被限定为仅读取模板库，则调用图像生成功能必然返回403。
1、在「API Access」页面，找到已生成的密钥，点击右侧「Edit」图标。
2、展开「Permissions」区域，确认勾选了Generate images和Use all models（或至少包含您选用的具体模型）。
3、若启用了「Rate limit per minute」，检查数值是否大于0；若为0，该密钥将被完全禁用。
4、修改后点击「Save changes」，并使用新配置的密钥重试请求。
