1.Generate（文生图） - SKUAI接口文档

根据给定的提示和可选参数同步生成图像。
图像链接在有限的时间（24小时）内可用；如果你想保留图像，你必须下载它。
图像URL为官方原链接，请注意网络环境是否能访问。

请求参数

Header 参数

Authorization

string

必需

用户个人中心获取的密钥

示例值:

Body 参数application/json

image_request

object

必需

prompt

string

提示词

必需

用于生成图像的提示。

aspect_ratio

enum<string>

宽高比

可选

（不能与分辨率一起使用）用于图像生成的纵横比，它决定了图像的分辨率。默认为ASPECT_1_1。

枚举值:

ASPECT_10_16ASPECT_16_10ASPECT_9_16ASPECT_16_9ASPECT_3_2ASPECT_2_3ASPECT_4_3ASPECT_3_4ASPECT_1_1ASPECT_1_3ASPECT_3_1

默认值:

ASPECT_1_1

model

enum<string>

模型

可选

用于生成图像或编辑图像的模型/generate和/remix支持所有模型类型，但是/edit仅支持V_2和V_2_TURBO。

枚举值:

V_1V_1_TURBOV_2V_2_TURBO

默认值:

V_2

magic_prompt_option

enum<string>

魔法提示词

可选

确定是否应在生成请求时使用MagicPrompt

枚举值:

AUTOONOFF

seed

integer

种子

可选

范围：[0,2147483647]

style_type

enum<string>

样式类型

可选

要生成的样式类型；这仅适用于型号V_2及以上，不应为型号版本V_1指定。

枚举值:

AUTOGENERALREALISTICDESIGNRENDER_3DANIME

negative_prompt

string

否定提示词

可选

描述从图像中排除的内容。提示中的描述优先于否定提示中的说明。

num_images

string

图片数量

可选

范围：[1,8]，默认值：1

默认值:

resolution

enum<string>

分辨率

可选

（仅适用于2.0版的model_version，不能与aspect_ratio结合使用）用于图像生成的分辨率，以宽度x高度表示。如果未指定，则默认使用aspect_ratio。

枚举值:

RESOLUTION_512_1536RESOLUTION_576_1408RESOLUTION_576_1472RESOLUTION_576_1536RESOLUTION_640_1024RESOLUTION_640_1344RESOLUTION_640_1408RESOLUTION_640_1472RESOLUTION_640_1536RESOLUTION_704_1152RESOLUTION_704_1216RESOLUTION_704_1280RESOLUTION_704_1344RESOLUTION_704_1408RESOLUTION_704_1472RESOLUTION_720_1280RESOLUTION_736_1312RESOLUTION_768_1024RESOLUTION_768_1088RESOLUTION_768_1152RESOLUTION_768_1216RESOLUTION_768_1232RESOLUTION_768_1280RESOLUTION_768_1344RESOLUTION_832_960RESOLUTION_832_1024RESOLUTION_832_1088RESOLUTION_832_1152RESOLUTION_832_1216RESOLUTION_832_1248RESOLUTION_864_1152RESOLUTION_896_960RESOLUTION_896_1024RESOLUTION_896_1088RESOLUTION_896_1120RESOLUTION_896_1152RESOLUTION_960_832RESOLUTION_960_896RESOLUTION_960_1024RESOLUTION_960_1088RESOLUTION_1024_640RESOLUTION_1024_768RESOLUTION_1024_832RESOLUTION_1024_896RESOLUTION_1024_960RESOLUTION_1024_1024RESOLUTION_1088_768RESOLUTION_1088_832RESOLUTION_1088_896RESOLUTION_1088_960RESOLUTION_1120_896RESOLUTION_1152_704RESOLUTION_1152_768RESOLUTION_1152_832RESOLUTION_1152_864RESOLUTION_1152_896RESOLUTION_1216_704RESOLUTION_1216_768RESOLUTION_1216_832RESOLUTION_1232_768RESOLUTION_1248_832RESOLUTION_1280_704RESOLUTION_1280_720RESOLUTION_1280_768RESOLUTION_1280_800RESOLUTION_1312_736RESOLUTION_1344_640RESOLUTION_1344_704RESOLUTION_1344_768RESOLUTION_1408_576RESOLUTION_1408_640RESOLUTION_1408_704RESOLUTION_1472_576RESOLUTION_1472_640RESOLUTION_1472_704RESOLUTION_1536_512RESOLUTION_1536_576RESOLUTION_1536_640

示例

{
    "image_request": {
        "prompt": "a cat",
        "aspect_ratio": "ASPECT_1_1",
        "model": "V_2",
        "magic_prompt_option": "AUTO",
        "seed": 16545613,
        "num_images": 1
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

created

string

创建请求的时间。

必需

data

array [object {6}]

必需

prompt

string

提示词

可选

用于生成的提示。这可能与原始提示不同。

resolution

string

分辨率

可选

最终图像的分辨率。

is_image_safe

boolean

图片是否安全

可选

此请求是否通过安全检查。如果为false，url字段将为空。

seed

integer

种子

可选

种子

url

string

url

可选

图像链接

style_type

enum<string>

样式类型

可选

要生成的样式类型；这仅适用于型号V_2及以上，不应为型号版本V_1指定。

枚举值:

AUTOGENERALREALISTICDESIGNRENDER_3DANIME

示例

成功示例异常示例

{
    "created": "2000-01-23T04:56:07Z",
    "data": [
        {
            "prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there's an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
            "resolution": "1024x1024",
            "is_image_safe": true,
            "seed": 12345,
            "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
            "style_type": "REALISTIC"
        }
    ]
}