Generate (文生图)

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

image_request

object

必需

prompt

string

提示词

必需

用于生成图像的提示。

aspect_ratio

string

图片宽高比例

可选

(Cannot be used in conjunction with resolution) The aspect ratio to use for image generation, which determines the image's resolution. Defaults to ASPECT_1_1.
（不能与分辨率一起使用）用于图像生成的宽高比，决定图像的分辨率

ASPECT_10_16、ASPECT_16_10、ASPECT_9_16、ASPECT_16_9、ASPECT_3_2、ASPECT_2_3、ASPECT_4_3、ASPECT_3_4、ASPECT_1_1、ASPECT_1_3、ASPECT_3_1

默认值:

ASPECT_1_1

magic_prompt_option

string

魔法提示

可选

确定是否应在生成请求时使用魔法提示
可选值：AUTO、ON、OFF

model

string

模型版本

可选

V_1、V_1_TURBO、V_2、V_2_TURBO

默认值:

V_2

style_type

string

样式类型

可选

The style type to generate with; this is only applicable for models V_2 and above and should not be specified for model versions V_1.
生成的样式类型；这仅适用于 V_2 及以上版本的模型，不应为 V_1 版本的模型指定。
示例值：GENERAL、REALISTIC、DESIGN、RENDER_3D、ANIME

negative_prompt

string

负向提示词

可选

Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt.
描述从图像中排除的内容。提示中的描述优先于负提示中的描述。

resolution

string

可选

(For model_version for 2.0 only, cannot be used in conjunction with aspect_ratio) The resolution to use for image generation, represented in width x height. If not specified, defaults to using aspect_ratio.
（仅适用于 2.0 的 model_version，无法与 aspect_ratio 同时使用）用于图像生成的分辨率，以宽 x 高表示。如果没有指定，则默认为使用 aspect_ratio。

color_palette

object

可选

用于生成的调色板必须通过预设之一（名称）指定，或者通过具有可选权重（成员）的颜色的十六进制表示形式显式指定。查看官方文档说明

seed

string

种子

可选

0 to 2147483647

示例

{
    "image_request": {
        "aspect_ratio": "ASPECT_10_16",
        "magic_prompt_option": "AUTO",
        "model": "V_1",
        "prompt": "一幅详细的图像描绘了一个广阔的石器时代城市，城市中高耸的摩天大楼由巨石和骨头构成。这里热闹非凡，各种性别和种族的人们共同展现出原始人和原始女性的统一外貌。他们身穿商务服装，与史前背景形成鲜明对比。化石化的塔楼点缀着石质天际线，而人们则保留着原始的设计，身上披着毛皮，搭配现代的西装和领带。形成了现代生活与史前时代的美丽融合。"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

created

string

必需

data

array [object {6}]

必需

is_image_safe

boolean

可选

prompt

string

可选

resolution

string

可选

seed

integer

可选

style_type

null

可选

url

string

可选

示例

{
    "created": "2024-10-30T18:45:11.507243+00:00",
    "data": [
        {
            "is_image_safe": true,
            "prompt": "A detailed image depicts a vast Stone Age city with towering skyscrapers made of stone and bones. The city bustles with activity, featuring people of various genders and races, all displaying a unified appearance of ancient men and women. They wear business attire, providing a striking contrast to the prehistoric background. Crystal-like towers adorn the skyline, while people maintain their original design, wearing fur garments alongside modern suits and ties. This creates a beautiful fusion of modern life and ancient times.",
            "resolution": "768x1232",
            "seed": 1705925986,
            "style_type": null,
            "url": "https://ideogram.ai/api/images/ephemeral/aUXMxzdBQy2lG08lbbEYJA.png?exp=1730400330&sig=7196e7d9ae95990d5e0f7e643ea7634399e7feb03f0e03a66d2fc612bdae47e2"
        }
    ]
}