创建图像（Recraftv3）

POST

/recraftv3/api/v1/images/generations

给定提示和/或输入图像，模型将生成新图像。

请求参数

Authorization

Body 参数application/json

model

enum<string>

使用的模型名称

必需

枚举值:

recraftv3fluxsdcogviewhunyuanstepkling

prompt

string

描述所需图像的文本

必需

<= 500 字符

enum<integer>

生成图像的数量

可选

枚举值:

默认值:

style_id

string <uuid> | null

可选

使用之前上传的风格作为参考

style

enum<string> | enum<null>

生成图像的风格

可选

枚举值:

anydigital_illustrationillustration_3ddigital_illustration_seamlessdigital_illustration_pixel_artdigital_illustration_3ddigital_illustration_psychedelicdigital_illustration_hand_drawndigital_illustration_graindigital_illustration_glowdigital_illustration_80sdigital_illustration_watercolordigital_illustration_voxeldigital_illustration_infantile_sketchdigital_illustration_2d_art_posterdigital_illustration_kawaiidigital_illustration_halloween_drawingsdigital_illustration_2d_art_poster_2digital_illustration_engraving_colordigital_illustration_flat_air_artdigital_illustration_hand_drawn_outlinedigital_illustration_handmade_3ddigital_illustration_stickers_drawingsrealistic_imagerealistic_image_mockuprealistic_image_b_and_wrealistic_image_enterpriserealistic_image_hard_flashrealistic_image_hdrrealistic_image_natural_lightrealistic_image_studio_portraitrealistic_image_motion_blurvector_illustrationvector_illustration_seamlessvector_illustration_line_artvector_illustration_doodle_line_artvector_illustration_flat_2vector_illustration_70svector_illustration_cartoonvector_illustration_kawaiivector_illustration_linocutvector_illustration_engravingvector_illustration_halloween_stickersvector_illustration_line_circuit

默认值:

realistic_image

substyle

string | null

子风格

可选

response_format

enum<string> | enum<null>

返回生成图像的格式

可选

枚举值:

urlb64_json

默认值:

url

size

string | null

生成图像的大小

可选

默认值:

1024x1024

正则匹配:

^\d+x\d+$

controls

object | null

可选

一组自定义参数，用于调整生成过程

示例

{
    "model": "recraftv3", // recraftv3、flux系列、sd系列、cogview系列、hunyuan系列、step系列、kling系列
    "prompt": "鸟瞰图，海岸线，海水清澈见底，细节和自然之美。特写，超高清，最好的质量，超高细节的画质，8K分辨率", // 必需参数，描述所需图像的文本，最大长度为500个字符
    "n": 1, // 整数或null，默认为1，目前仅支持n=1和n=2
    "style_id": null, // UUID或null，使用之前上传的风格作为参考
    "style": "realistic_image", // 字符串或null，默认为realistic_image，生成图像的风格
    "substyle": null, // 字符串或null，子风格，具体内容在上面有涉及
    "response_format": "url", // 字符串或null，默认为url，返回生成图像的格式，必须是url或b64_json之一
    "size": "1024x1024", // 字符串或null，默认为1024x1024，生成图像的大小，以WxH格式表示
    "controls": null // 对象或null，一组自定义参数，用于调整生成过程
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/recraftv3/api/v1/images/generations' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "recraftv3", // recraftv3、flux系列、sd系列、cogview系列、hunyuan系列、step系列、kling系列
    "prompt": "鸟瞰图，海岸线，海水清澈见底，细节和自然之美。特写，超高清，最好的质量，超高细节的画质，8K分辨率", // 必需参数，描述所需图像的文本，最大长度为500个字符
    "n": 1, // 整数或null，默认为1，目前仅支持n=1和n=2
    "style_id": null, // UUID或null，使用之前上传的风格作为参考
    "style": "realistic_image", // 字符串或null，默认为realistic_image，生成图像的风格
    "substyle": null, // 字符串或null，子风格，具体内容在上面有涉及
    "response_format": "url", // 字符串或null，默认为url，返回生成图像的格式，必须是url或b64_json之一
    "size": "1024x1024", // 字符串或null，默认为1024x1024，生成图像的大小，以WxH格式表示
    "controls": null // 对象或null，一组自定义参数，用于调整生成过程
}'

返回响应

🟢200成功

application/json

成功生成图像

Body

created

integer

创建时间戳

必需

data

array [object {1}]

必需

url

string

生成图像的URL

可选

image

array[string]

可选

metadata

object

可选

credits

integer

可选

height

integer

可选

width

integer

可选

images

array [object {4}]

可选

random_seed

integer

可选

request_id

string

可选

transform_model

string

可选

示例

{
  "created": 1732457701,
  "data": [
    {
      "url": "https://sfile.chatglm.cn/chatglm4/121adf46-b582-449f-bf4b-6f19998c3622.png"
    }
  ],
  "image": [
    "https://sfile.chatglm.cn/chatglm4/121adf46-b582-449f-bf4b-6f19998c3622.png"
  ],
  "metadata": {
    "credits": 1,
    "height": 1024,
    "images": [
      {
        "image_id": "f64b8f0d-a2fa-4efc-9d34-5134faf3fc14",
        "image_invariants": {
          "preset": "realistic_image"
        },
        "transparent": false,
        "vector_image": false
      }
    ],
    "random_seed": 2978853182,
    "request_id": "8d4be7b1-989d-47b2-bc35-82a657a4f488",
    "transform_model": "recraftv3",
    "width": 1024
  }
}

修改于 2024-11-24 14:48:17

获取任务图片的seed（需设置mj或niji的私信ID）

Generate（文生图）