Generate（文生图） - OpenAI-Hub中文文档

根据给定的提示和可选参数同步生成图像。返回的图像 URL 在 24 小时内有效，超过该时间将无法访问图像。图像URL为官方原链接，请注意网络环境是否能访问。

请求参数

Header 参数

Authorization

string

必需

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接令牌
示例
Authorization: Bearer 2f68dbbf-519d-4f01-9636-e2421b68f379

默认值:

Bearer {{YOUR_API_KEY}}

Content-Type

string

可选

默认值:

application/json

Body 参数application/json

image_request

object

可选

prompt

string

必需

The prompt to use to generate the image.

示例值:

A serene tropical beach scene.

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_1_1

model

string

可选

The model used to generate. Defaults to V_2.

默认值:

V_2

示例值:

V_1

magic_prompt_option

string

可选

Determine if MagicPrompt should be used in generating the request or not

默认值:

AUTO

示例值:

AUTO

seed

string

可选

0 to 2147483647

示例值:

12345

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.

示例值:

GENERAL

negative_prompt

string

可选

Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt.

示例值:

Exclude dark clouds.

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.

示例值:

1024x1024

示例

{
    "image_request": {
        "model": "V_2",
        "magic_prompt_option": "AUTO"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

array [object {5}]

必需

seed

integer

必需

0 to 2147483647

示例值:

12345

prompt

string

必需

The prompt used for the generation. This may be different from the original prompt.

示例值:

A serene tropical beach scene.

resolution

string

必需

The resolution of the final image.

示例值:

1024x1024

url

string

必需

The direct link to the image generated.

示例值:

https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g

is_image_safe

boolean

必需

Whether this request passes safety checks. If false, the url field will be empty.

示例值:

true

created

string

必需

The time the request was created.

示例值:

2000-01-23T04:56:07.000Z

示例

{
    "data": [
        {
            "seed": 12345,
            "prompt": "A serene tropical beach scene.",
            "resolution": "1024x1024",
            "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g",
            "is_image_safe": true
        }
    ],
    "created": "2000-01-23T04:56:07.000Z"
}

🔴500Unexpected error