Generate (文生图)

概览

• 请求方法：POST
• 路径：/ideogram/generate
• 内容类型：application/json

---

认证方式

• Authorization: Bearer sk-xxx（必选）

---

请求示例

Header

Header	示例	必填
Content-Type	application/json	是
Authorization	Bearer sk-xxxx	是

请求体（JSON）

{
  "image_request": {
    "prompt": "一幅详细的图像描绘了一个广阔的石器时代城市...",
    "model": "V_2",
    "aspect_ratio": "ASPECT_10_16",
    "magic_prompt_option": "AUTO"
  }
}

参数说明

参数	类型	必填	默认	描述
image_request	object	是	-	图像请求对象，详见官方文档
- prompt	string	是	-	提示词
- model	string	否	V_2	模型版本，可选 V_1/V_1_TURBO/V_2/V_2_TURBO
- aspect_ratio	string	否	ASPECT_1_1	生成比例
- resolution	string	否	-	2.0仅支持，用于图像分辨率
- style_type	string	否	-	样式类型，V_2及以上
- negative_prompt	string	否	-	负向提示词
- color_palette	object	否	-	调色板配置
- seed	string	否	-	随机种子

---

返回示例（200）

{
  "created": "2024-10-30T18:45:11.507243+00:00",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A detailed image depicts a vast Stone Age city...",
      "resolution": "768x1232",
      "seed": 1705925986,
      "style_type": null,
      "url": "https://ideogram.ai/api/images/ephemeral/aUXMxzdBQy..."
    }
  ]
}