recraft api提供安全集成路径：前端调用后端代理接口，后端用bearer token转发请求至/v1/images/generate，支持多尺寸异步生成与错误分类处理。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在自己的网站中嵌入AI生成图像的功能，Recraft API 提供了直接调用其多风格绘图能力的接口。以下是将Recraft API 集成到网页前端与后端服务中的具体实施路径：
一、获取API密钥并配置认证
Recraft API 要求每个请求携带有效的 Bearer Token，该 Token 需通过开发者账户在 Recraft 官网控制台申请获得，并具备对应模型调用权限。密钥不可硬编码于前端代码中，必须由后端代理转发请求以保障安全。
1、访问 https://recraft.ai/dashboard/api-keys 登录您的开发者账户。
2、点击“Create new API key”，选择作用域为 image-generation，复制生成的密钥字符串。
3、在后端服务环境变量中设置 RECRACFT_API_KEY，例如 Node.js 中使用 process.env.RECRACFT_API_KEY 读取。
二、构建图像生成请求的后端代理接口
为避免跨域限制与密钥泄露，所有对 Recraft API 的 POST 请求需经由自有服务器中转。该接口接收前端传入的提示词与参数，组装标准请求体后转发至 Recraft 的 /v1/images/generate 端点。
1、在后端路由中定义一个 POST 接口，如 /api/generate-image。
2、解析前端 JSON 请求体，提取 prompt、model（如 recraft-v3）、style（如 realistic、anime）等字段。
3、使用 fetch 或 axios 向 https://api.recraft.ai/v1/images/generate 发起带 Authorization 头的请求，Body 格式为 application/json，包含 prompt、model、style、aspect_ratio 等键。
三、前端调用代理接口并渲染结果
前端不直接连接 Recraft 服务，而是向自身域名下的代理接口发起请求，接收返回的生成任务 ID 或直接的图像 URL，再加载至页面 DOM 中。响应格式取决于后端是否启用同步返回或轮询机制。
1、在网页 JavaScript 中调用 fetch('/api/generate-image', { method: 'POST', body: JSON.stringify({ prompt: 'a cyberpunk cat wearing sunglasses', style: 'cyberpunk' }) })。
2、等待响应，若返回字段含 image_url，则创建 <img> 元素并将其 src 设置为该值。
3、若返回的是 task_id，则启动定时 fetch /api/task-status?id=xxx 直至 status 字段变为 completed，再提取 image_url。
四、处理图像生成失败与错误响应
Recraft API 在提示词违规、配额耗尽、模型不可用等情况下会返回 4xx 或 5xx 状态码及 JSON 错误体。前端需识别 error.message 或 error.type 字段，向用户展示可理解的提示，而非原始报错信息。
1、检查响应状态码，对非 200 响应调用 response.json() 解析错误详情。
2、根据 error.type 字段匹配处理逻辑：若为 invalid_prompt，提示用户修改描述；若为 rate_limit_exceeded，显示“今日绘图次数已用完”。
3、在 UI 中使用红色文字容器显示 error.message 内容，例如“提示词包含禁止词汇，请更换表述”。
五、支持多尺寸输出与异步轮询机制
Recraft 支持通过 aspect_ratio 参数指定输出宽高比（如 1:1、16:9、4:3），但部分尺寸可能触发异步生成流程，需后端提供任务状态查询接口供前端轮询，确保图像就绪后再渲染。
1、前端发起生成请求时，在 payload 中加入 "aspect_ratio": "16:9" 字段。
2、后端收到请求后，若 Recraft 响应中包含 "status": "queued"，则保存 task_id 到内存或 Redis，并立即返回该 ID 给前端。
3、前端每 2 秒调用一次 /api/task-status?task_id=xxx，直到响应中出现 "image_url" 字段为止。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
