Generate 3.0（文生图）

方法: POST路径: /ideogram/v1/ideogram-v3/generate

使用 Ideogram 3.0 模型，根据给定的提示和可选参数同步生成图像 具体参数请看官方文档：https://developer.ideogram.ai/api-reference/api-reference/generate-v3

返回的图像 URL 在 24 小时内有效，超过该时间将无法访问图像。 已反代图片

请求参数

Header 参数

accept
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 multipart/form-data

prompt
string
必需
rendering_speed
string
可选
character_reference_images
file
可选
带 character 一致性，支持多图

请求示例代码

Shell

curl --location --request POST '/ideogram/v1/ideogram-v3/generate' \
--header 'accept: application/json' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'prompt=""' \
--form 'rendering_speed=""' \
--form 'character_reference_images=@""'

返回响应

🔴 500 成功

内容类型: application/json

响应结构

code
string
必需
message
string
必需
data
null
必需

示例

{
    "created": "2000-01-23 04:56:07+00:00",
    "data": [
        {
            "prompt": "A photo of a cat sleeping on a couch.",
            "resolution": "1024x1024",
            "is_image_safe": true,
            "seed": 12345,
            "url": "https://ideogram.ai/api/images/ephemeral/xtdZiqPwRxqY1Y7NExFmzB.png?exp=1743867804&sig=e13e12677633f646d8531a153d20e2d3698dca9ee7661ee5ba4f3b64e7ec3f89",
            "style_type": "GENERAL"
        }
    ]
}