POST/ideogram/generate

ideogram（文生图）

Generates images synchronously based on a given prompt and optional parameters. 具体参数请看官方文档：https://developer.ideogram.ai/api-reference/api-reference/describe 根据给定的提示和可选参数同步生成图像。返回的图像 URL 在 24 小时内有效，超过该时间将无法访问图像。已反代图片

API Key application/json

Ideogram 兼容协议

调用与返回说明

这是本站提供的 Ideogram 兼容入口，路径沿用厂商动作命名。它不是让客户端直接访问 Ideogram，也不要求提交厂商 API Key；当前可用模型和权限以本站配置为准。

请求时注意

请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。

返回时注意

同步图片响应通常在 data、output 或等价字段中返回 URL、Base64 或图片对象；先检查 HTTP 状态和错误字段，再按返回格式保存结果。
URL 可能有有效期，Base64 需要按响应中的格式解码。不要把示例 URL 当作永久存储地址，也不要把 Markdown 预览当作二进制文件。

Request

请求

/ideogram/generate

Body

必填

Bodyobject

image_requestobject必填

图像请求对象 (必填)

promptstring必填

用于生成图像的提示词 (必填)

aspect_ratiostring必填

图像宽高比 (可选) 可选值: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

modelstring必填

使用的模型 (可选) 默认V_2,可选值:V_1/V_1_TURBO/V_2/V_2_TURBO

magic_prompt_optionstring必填

是否使用MagicPrompt (可选) 可选值:AUTO/ON/OFF

seedinteger必填

随机种子 (可选) 范围:0-2147483647

style_typestring必填

风格类型 (可选) 可选值:AUTO/GENERAL/REALISTIC/DESIGN/RENDER_3D/ANIME

negative_promptstring必填

反向提示词 (可选) 描述不想在图像中出现的内容

num_imagesinteger必填

生成图片数量 (可选) 范围:1-8,默认1

resolutionstring必填

分辨率 (可选) 可选值包含从512x1536到1536x640等多种分辨率组合

color_paletteobject必填

颜色调色板 (可选)

namestring必填

预设调色板名称 (与members二选一) 可选值:EMBER/FRESH/JUNGLE/MAGIC/MELON/MOSAIC/PASTEL/ULTRAMARINE

路径、查询与 Header 参数

参数	位置	类型	必填	说明	示例
`Content-Type`	Header	string	是	-	application/json
`Accept`	Header	string	是	-	application/json
`Authorization`	Header	string	是	必填。使用青云TOP API 的 API Key，保留 Bearer 后的空格。	Bearer YOUR_API_KEY

请求示例application/json

curl -X POST https://top.qingyuntop.ai/ideogram/generate \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "image_request": {
    "aspect_ratio": "ASPECT_10_16",
    "magic_prompt_option": "AUTO",
    "model": "V_1",
    "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 is 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."
  }
}'

Response

返回响应 `200`

HTTP 响应

响应 200object

createdstring必填

dataarray<object>必填

元素object

is_image_safeboolean

promptstring

resolutionstring

seedinteger

style_typenull

urlstring

响应示例json

{
  "created": "2024-12-15T17:32:00.965408+00:00",
  "data": [
    {
      "is_image_safe": true,
      "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 is 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": "768x1232",
      "seed": 1785282233,
      "style_type": null,
      "url": "https://ideogram.ai/api/images/ephemeral/WkoxvqiOTaaCqG1nO2tQoA.png?exp=1734370337&sig=110fe96dc9e01002c8d837e5b4cde1aaa266195561d231ce76e19e095e478ffe"
    }
  ]
}

Ideogram 兼容协议

调用与返回说明

请求时注意

请求头使用 Authorization: Bearer YOUR_API_KEY 和页面声明的 Content-Type。路径中的厂商名称不改变青云TOP API 的鉴权方式，也不要求客户端携带厂商密钥。
模型 ID、模型版本和后缀必须使用当前账号 GET /v1/models 返回且与本页协议匹配的值；旧示例中的固定型号不能视为永久可用。

返回时注意

同步图片响应通常在 data、output 或等价字段中返回 URL、Base64 或图片对象；先检查 HTTP 状态和错误字段，再按返回格式保存结果。
URL 可能有有效期，Base64 需要按响应中的格式解码。不要把示例 URL 当作永久存储地址，也不要把 Markdown 预览当作二进制文件。

ideogram（文生图）

调用与返回说明

请求时注意

返回时注意

请求

Body

路径、查询与 Header 参数

返回响应 200

调用与返回说明

请求时注意

返回时注意

返回响应 `200`