创建图像（Recraftv3）

POST

/api/v1/images/generations

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

请求参数

Body 参数application/json

示例

{
    "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 '/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": 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
    }
}

修改于 2025-07-04 02:51:24

TTS文本转语音

生成音乐