Generate（文生图）

请求参数

Header 参数

Authorization

string

必需

默认值:

Body 参数application/json

image_request

object

必需

prompt

string

提示词

必需

生成图像的提示

aspect_ratio

string

图像宽高比

可选

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

默认值:

ASPECT_1_1

model

string

使用模型

可选

用于生成的模型。默认为 V_2。

默认值:

V_2

示例值:

V_1V_2V_1_TURBOV_2_TURBO

magic_prompt_option

string

启用Magic提示

可选

确定是否应该在生成请求时使用 MagicPrompt，默认值AUTO

默认值:

AUTO

示例值:

AUTOONOFF

seed

integer

随机种子

可选

0到2147483647

style_type

string

样式类型

可选

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

示例值:

GENERALREALISTICDESIGNRENDER_3DANIME

negative_prompt

string

图像排除内容描述词

可选

描述从图像中排除的内容。提示中的描述优先于负提示中的描述。

resolution

string

图像分辨率

可选

（仅适用于 2.0 的 model_version，无法与 aspect_ratio 同时使用）用于图像生成的分辨率，以宽x高表示。如果没有指定，则默认为使用 aspect_ratio。

示例值:

RESOLUTION_576_1472

示例

{
  "image_request": {
    "model": "V_1_TURBO",
    "magic_prompt_option": "AUTO",
    "seed": 111,
    "prompt": "cat"
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/ideogram/generate' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "image_request": {
    "model": "V_1_TURBO",
    "magic_prompt_option": "AUTO",
    "seed": 111,
    "prompt": "cat"
  }
}'

返回响应

🟢200成功

application/json

Body

data

array[object (IdeogramImageObject) {6}]

必需

prompt

string

提示词

必需

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

resolution

string

分辨率

必需

最终图像的分辨率

is_image_safe

boolean

安全检查

必需

该请求是否通过安全检查。如果为假，网址字段将为空

seed

integer

生成种子

必需

0到2147483647之间的整数

url

string

图像链接

可选

生成的图像的直接链接

style_type

string

风格类型

可选

绘画风格，只在V_2模型中才会为有效值，V_1中为null

created

string

创建时间

必需

请求创建的时间

示例

{
  "created": "2024-11-02T12:27:52.881006+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A playful and curious cat with bright green eyes, perched on a wooden windowsill. Its soft white fur contrasts with the grayish-blue sky outside the window. The cat's ears are perked up, revealing its alert and attentive nature. The background shows a cozy, sunlit room with a patterned rug, a bookshelf filled with books, and a warm, inviting atmosphere.",
      "resolution": "1024x1024",
      "seed": 111,
      "style_type": null,
      "url": "https://ideogram.ai/api/images/ephemeral/YtBw8AqbSGOje-Lchk_TBA.png?exp=1730636879&sig=ae24e790bd7f323572cf8ec8805af0626adb9f5634df2b91e7e6c01bce49fd8b"
    }
  ]
}