Generate Image（生成图片）

OpenAPI Specification

接口：POST /recraft/v1/images/generations（完整地址 https://api.allyang.cn/recraft/v1/images/generations）

鉴权：请求头 Authorization: Bearer {{YOUR_API_KEY}}。

请求头

• Authorization：可选，string，默认 Bearer {{YOUR_API_KEY}}。

请求体参数（application/json）

• prompt：必填，string，生成图片的提示词。

• size：string，尺寸，示例 1024x1024。

• style：string，风格，原文示例描述为 realistic_image。

• style_id：string，与 style 互斥；两者都不指定时使用 realistic_image 默认样式。

• substyle：string，子风格。

• response_format：string，返回形式，取值 url 或 b64_json，示例 url。

• controls：object，用于对生成过程做一些调整。

  • controls.colors：string，一系列可取的颜色，原文示例为 0 至 255 区间的 3 个整数组成的 RGB 颜色。
  • controls.background_color：string，把给定颜色用作背景色（原文键名写作 background_color 并带制表符转义）。

• 必填项：prompt；原文 required 列表另含一处疑似导出残留的键名 01JG62C25KPXTEEJE8PZ62WHJ1（非业务字段，待裁定）。

响应

• 200：成功；原文未给出响应字段，待补。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。