Recraft 免费额度怎么用：矢量插画每日生成次数与限制

Recraft 的主战场是网页工作台：选风格、写提示词、生成、导出矢量或位图。免费档适合做风格试验；如果要把生成能力接进自己的站点，就需要走 API，而 API 是否包含在免费档、是否必须付费档才能开通，以控制台实际显示为准。

网页端使用流程

1. 登录后在工作台选择生成类型，矢量插画、图标、套图各有对应入口，先定类型再写提示词。
2. 选定一个风格后再写描述词，风格决定了线条、配色和整体调性，同一提示词换风格效果差别很大。
3. 提交后等待出图，单次最多 2 张；不满意再调提示词，注意免费档每个风格每天只有 3 次生成机会。
4. 满意后导出，矢量类结果可导出为 SVG 便于二次编辑，位图类结果导出 PNG。

API 接入要点

如果控制台里提供了开发者入口，先在那里创建密钥，再把 base_url 和密钥写进环境变量，避免直接硬编码在代码里。base_url 是接口前缀，具体地址以控制台 API 文档页给出的为准，形态大致如下：

export RECRAFT_API_BASE="https://external.api.recraft.ai/v1"
export RECRAFT_API_KEY="控制台生成的 API Key"

模型名不在前端页面展示，需要在控制台的模型列表中查看，自家图像模型通常以 recraft 开头并带版本号。确认好模型名后，一次生成调用可以这样发：

curl -X POST "$RECRAFT_API_BASE/images/generations" \
  -H "Authorization: Bearer $RECRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "recraftv3",
    "prompt": "flat vector icon of a rocket, two colors, clean lines",
    "size": "1024x1024",
    "style": "vector_illustration",
    "n": 1
  }'

关键参数说明：

• model：图像模型名，务必与控制台模型列表逐字核对，写错会直接报模型不存在。
• prompt：提示词，建议写清主体、风格、配色和构图，英文描述通常更稳定。
• size：输出尺寸，不同模型支持的尺寸集合不同，不支持的尺寸会被拒绝。
• style：风格标识，决定是矢量插画、图标还是写实照片，取值同样以文档为准。
• n：单次生成张数，注意不要超过账号档位允许的上限。

额度耗尽与限流的排查顺序

1. 先看返回状态码：出现额度类错误时，第一步登录控制台查看当日剩余次数和套餐状态，确认是不是免费档当天次数已用完。
2. 若提示权限不足，检查这个密钥所属的账号档位是否允许调用该模型，第三方模型往往要更高档位。
3. 若返回限流错误，说明请求过于频繁，降低并发、在两次请求之间加退避等待再重试，不要原地死循环。
4. 最后再排查参数层：模型名拼写、尺寸是否受支持、请求头里的 Authorization 是否带了 Bearer 前缀。
5. 以上都正常但仍失败，去控制台的状态页或公告确认是否服务端波动，避免误判成自己代码的问题。