配置Recraft API密钥，轻松调用矢量生成能力

想在自己的应用中轻松集成高质量矢量图像生成功能？只需三步：从Recraft控制台安全获取专属API密钥、通过环境变量安全注入项目、再以标准Bearer认证调用/v1/vector端点——即可用简洁的prompt、style和size参数实时生成可缩放SVG，全程规避硬编码风险与权限陷阱，让专业级矢量创作能力即刻为你所用。

如果您希望在自己的应用中集成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指向生成的矢量资源。

今天关于《配置Recraft API密钥，轻松调用矢量生成能力》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！