需完成api认证、请求构造与响应解析:一、配置密钥与环境,用dotenv加载.env中的recrft_api_key并安装axios;二、构造含prompt、model、style和aspect_ratio的json请求体;三、用axios发送带bearer认证头的post请求;四、解码响应中的b64_json为buffer并保存为png;五、按http状态码区分处理400/401/403/429错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在Node.js应用中集成Recraft API以实现自动绘图功能,则需完成API认证、请求构造与响应解析等关键环节。以下是实现该功能的具体步骤:
一、配置Recraft API密钥与基础环境
Recraft API要求通过Bearer Token进行身份验证,必须将密钥安全地注入Node.js运行环境,避免硬编码泄露。同时需确保项目已安装必要的HTTP客户端依赖。
1、在Recraft开发者控制台创建新项目,复制生成的API Key。
2、在项目根目录创建.env文件,写入RECRFT_API_KEY=sk-xxx,并使用dotenv包加载环境变量。
3、执行npm install axios dotenv安装axios用于发起HTTP请求,dotenv用于读取环境配置。
二、构造符合Recraft要求的绘图请求体
Recraft API接受JSON格式的POST请求,其中prompt字段为必填项,model与style参数决定输出图像风格与质量等级,需严格匹配其文档所列枚举值。
1、定义请求对象,设置prompt为“a minimalist vector icon of a coffee cup”,model为recraft-v3。
2、添加style字段,可选值包括vector、digital-art或realistic,此处设为vector。
3、设置aspect_ratio为1:1,确保输出图像为正方形构图。
三、使用Axios发送异步绘图请求
Axios支持Promise链式调用与错误拦截,适合处理Recraft API返回的200成功响应或4xx/5xx异常状态,需显式设置请求头中的Authorization与Content-Type。
1、在代码中导入axios与dotenv,调用config()加载环境变量。
2、构建config对象,设置url为https://api.recraft.ai/v1/images/generations,method为POST。
3、在headers中添加Authorization: Bearer ${process.env.RECRFT_API_KEY}与Content-Type: application/json。
4、将上一步构造的请求体赋给data字段,调用axios(config)发起请求。
四、解析并保存返回的Base64图像数据
Recraft API成功响应中包含data[0].b64_json字段,其值为base64编码的PNG图像,需解码后写入本地文件系统,路径应具备可写权限且扩展名与内容类型一致。
1、从响应response.data.data[0].b64_json提取base64字符串。
2、使用Buffer.from(b64String, 'base64')将其转换为二进制缓冲区。
3、调用fs.writeFileSync('output.png', buffer)将图像保存至当前目录,文件名须含.png后缀。
五、处理常见API错误响应
Recraft API可能返回400(无效prompt)、401(密钥错误)、403(配额耗尽)或429(请求过频),每种状态需对应不同日志提示与降级逻辑,不可静默忽略。
1、在catch块中判断error.response.status,若为401则输出API密钥无效,请检查RECRFT_API_KEY环境变量。
2、若状态为429,暂停后续请求并记录Retry-After响应头指定的秒数。
3、若状态为400,打印error.response.data.detail中返回的具体校验失败原因。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!






