需先获取recraft api密钥并配置环境变量,再通过bearer认证调用/v1/vector端点提交prompt、style、size参数生成svg。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您希望在自己的应用中集成Recraft的矢量图像生成功能,但尚未配置API密钥,则无法发起有效请求。以下是完成Recraft API密钥配置并实现调用的关键步骤:
一、获取Recraft API密钥
Recraft平台为每个注册账户分配唯一的API密钥,该密钥是身份认证与权限控制的核心凭证,必须通过官方控制台手动获取。
1、访问 https://recraft.ai/dashboard/api-keys 并使用您的账户登录。
2、点击页面右上角的 “Create new API key” 按钮。
3、在弹出窗口中输入密钥名称(例如 my-app-production),勾选所需权限范围(至少需启用 vector-generation)。
4、点击 “Generate Key”,系统将显示一次性的密钥字符串。
5、立即复制该字符串,并妥善保存至安全位置——页面刷新后将无法再次查看明文密钥。
二、在应用中设置环境变量
将API密钥注入运行环境而非硬编码于源码中,可避免泄露风险并支持多环境灵活切换。
1、在项目根目录创建或编辑 .env 文件。
2、添加一行内容:RECRFT_API_KEY=sk-xxx-your-generated-key-here(替换为实际密钥)。
3、确保应用启动前已加载该文件,例如在Node.js中使用 dotenv.config() 初始化。
4、验证环境变量是否生效:在代码中打印 process.env.RECRFT_API_KEY 的前4个字符(如 sk-1),确认非undefined且不为空。
三、构造HTTP请求头认证
Recraft API要求所有请求在Header中携带有效的Authorization字段,格式为Bearer令牌机制,服务端据此校验密钥合法性。
1、在发起POST请求前,定义请求头对象:{"Authorization": "Bearer " + process.env.RECRFT_API_KEY}。
2、确保Header中不含多余空格,且 Bearer 与密钥之间仅有一个英文空格。
3、若使用curl测试,命令应形如:curl -H "Authorization: Bearer sk-xxx" https://api.recraft.ai/v1/generate。
4、收到响应状态码 401 Unauthorized 表示密钥无效或缺失;403 Forbidden 表示密钥存在但权限不足。
四、调用矢量生成端点
Recraft提供专用的/v1/vector端点处理SVG与可缩放矢量指令,需按指定JSON Schema提交提示词与参数。
1、设置请求URL为:https://api.recraft.ai/v1/vector。
2、请求体(body)中包含键 "prompt"(字符串)、"style"(枚举值如 flat 或 outline)和 "size"(如 1024x1024)。
3、将Content-Type Header设为:application/json。
4、发送请求后,成功响应将返回包含 "svg_url" 字段的JSON对象,该URL指向生成的矢量资源。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











