Generate（文生图） - DeerAPI-API文档

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

curl --location --request POST 'https://api.deerapi.com/ideogram/generate' \ --header 'Authorization: {{api-key}}' \ --header 'Content-Type: application/json' \ --data-raw '{ "image_request": { "model": "V_2_TURBO", "magic_prompt_option": "AUTO", "seed": 111, "prompt": "cat", "num_images": 1 } }'

{ "data": [ { "seed": 12345, "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", "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g", "is_image_safe": true }, { "seed": 12345, "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", "url": "https://ideogram.ai/api/images/direct/8YEpFzHuS-S6xXEGmCsf7g", "is_image_safe": true } ], "created": "2000-01-23T04:56:07.000Z" }

请求参数

Header 参数

Authorization

string

可选

示例值:

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_1_1。

默认值:

ASPECT_1_1

model

enum<string>

可选

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

枚举值:

V_1V_1_TURBOV_2V_2_TURBO

默认值:

V_2

magic_prompt_option

enum<string>

可选

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

枚举值:

AUTOONOFF

默认值:

AUTO

seed

integer

可选

0 to 2147483647

style_type

enum<string>

可选

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

枚举值:

GENERALREALISTICDESIGNRENDER_3DANIME

num_images

string

可选

negative_prompt

string

可选

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

resolution

string

可选

最终图像的分辨率。

示例值:

RESOLUTION_832_1152

示例

返回响应

🟢200OK

application/json

成功生成图像

Body

data

array [object {5}]

必需

A list of ImageObjects that contain the generated image(s).

seed

integer

必需

0 to 2147483647

prompt

string

必需

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

resolution

string

必需

The resolution of the final image.

url

string

必需

The direct link to the image generated.

is_image_safe

boolean

必需

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

created

string

必需

The time the request was created.