Recraft V3

模型名称

用于根据文本提示词生成图片，适合海报、插画、商品图、社媒配图和创意草图。

POST https://yesapi.online/v1/images/generations

参数	类型	必填	默认值	说明
`model`	string	是	-	固定值：`recraft-v3`
`prompt`	string	是	-	图片生成提示词，建议包含主体、场景、风格、光线、构图和细节要求
`n`	integer	否	`1`	生成图片数量
`size`	string	否	`1024x1024`	输出尺寸，如 `1024x1024`、`1024x1536`、`1536x1024`
`response_format`	string	否	`url`	`url` 或 `b64_json`
`seed`	integer	否	-	固定随机种子，便于复现相近构图
`negative_prompt`	string	否	-	不希望出现在图像中的内容

{
  "created": 1784534400,
  "data": [
    {
      "url": "https://yesapi.online/v1/images/cache/recraft-v3_example.png"
    }
  ]
}

字段	类型	说明
`created`	integer	请求创建时间戳
`data`	array	图片结果列表
`data[].url`	string	当 `response_format=url` 时返回的图片地址
`data[].b64_json`	string	当 `response_format=b64_json` 时返回的 Base64 图片数据

HTTP 状态码	错误类型	排查建议
`400`	Invalid request	检查 `model`、`prompt`、`size`、图片 URL 和参数格式
`401`	Unauthorized	检查 API Key 是否正确，Header 是否为 `Authorization: Bearer sk-...`
`402`	Insufficient balance	检查账户余额、套餐额度或充值状态
`413`	Payload too large	压缩输入图片，或改用图片 URL 方式提交
`429`	Rate limited	降低并发、增加重试间隔，或升级额度
`500`	Upstream error	稍后重试；如持续失败，记录请求参数并联系 YesAPI 支持

提示词尽量包含主体、背景、风格、镜头、光线、比例和质量要求。

电商图建议明确“保留商品主体、真实阴影、干净背景、不要改变 Logo 和文字”。

批量生成时建议保存请求参数、返回 URL、业务 ID，便于追踪和复现。

需要低成本批量调用时，可结合 YesAPI.online 的充值入口、优惠码和活动折扣，形成双重折扣。