Generate 3.0（文生图）Generate

POST

/ideogram/v1/ideogram-v3/generate

使用 Ideogram 3.0 模型，根据给定的提示和可选参数同步生成图像
具体参数请看官方文档：https://developer.ideogram.ai/api-reference/api-reference/generate-v3
返回的图像 URL 在 24 小时内有效，超过该时间将无法访问图像。
已反代图片

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json

示例

{
    "prompt": "string",
    "seed": 0,
    "resolution": "512x1536",
    "aspect_ratio": "1x3",
    "rendering_speed": "DEFAULT",
    "magic_prompt": "AUTO",
    "negative_prompt": "string",
    "num_images": 1,
    "color_palette": {
        "name": "string"
    },
    "style_codes": [
        "string"
    ],
    "style_type": "GENERAL"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/ideogram/v1/ideogram-v3/generate' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "string",
    "seed": 0,
    "resolution": "512x1536",
    "aspect_ratio": "1x3",
    "rendering_speed": "DEFAULT",
    "magic_prompt": "AUTO",
    "negative_prompt": "string",
    "num_images": 1,
    "color_palette": {
        "name": "string"
    },
    "style_codes": [
        "string"
    ],
    "style_type": "GENERAL"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "data": [
        {
            "seed": 511526458,
            "prompt": "voluptate reprehenderit",
            "resolution": "1024x1024",
            "url": "https://v3.fal.media/files/koala/mSnuEvKTrnyY2mXY1i_qc_image.png",
            "is_image_safe": true,
            "style_type": "REALISTIC"
        }
    ],
    "created": "2025-08-27T18:23:28.806107195+08:00"
}

修改于 2025-09-28 16:57:05

提交swap_face任务

Generate 3.0（图片编辑）Edit