文生图 - Ecovai

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json

image_request

object

必需

prompt

string

生成图像的提示语

必需

aspect_ratio

string

可选

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

默认值:

ASPECT_1_1

model

enum<string>

可选

用于生成的模型（调用的不是完整模型名称，而是模型的版本部分）

枚举值:

V_1V_1_TURBOV_2V_2_TURBO

默认值:

V_2

magic_prompt_option

enum<string>

可选

确定是否应该在生成请求时使用“提示词魔法优化“

枚举值:

AUTOONOFF

默认值:

AUTO

seed

integer

可选

0 to 2147483647

style_type

enum<string>

可选

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

枚举值:

GENERALREALISTICDESIGNRENDER_3DANIME

negative_prompt

string

可选

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

resolution

string

最终图像的分辨率。

可选

示例值:

RESOLUTION_832_1152

示例

{
  "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 'https://api.ephone.ai/ideogram/generate' \
--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

created

string

必需

data

array [object {6}]

必需

is_image_safe

boolean

可选

prompt

string

可选

resolution

string

可选

seed

integer

可选

style_type

null

可选

url

string

可选

示例

{
  "created": "2024-12-20T16:10:56.882175+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/rdmsq6uHT8qdi_3ZCNlg6w.png?exp=1734797463&sig=ad766482b18ed3c4564d17af9836b8afc3c6ab9c79989e469c481157d91b0187"
    }
  ]
}