Generate 3.0（文生图）Generate - 薛定猫API官方文档

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

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

string

必需

示例值:

application/json

Authorization

string

必需

示例值:

Bearer {{YOUR_API_KEY}}

Body 参数application/json

prompt

string

必需

生成图像所需的提示文本

seed

integer

可选

随机种子。设置此值可获得可重复的生成结果

>= 0<= 2147483647

resolution

enum<string>

支持的分辨率选项

可选

枚举值:

512x1536576x1408576x1472576x1536640x1344640x1408640x1472640x1536704x1152704x1216704x1280704x1344704x1408704x1472736x1312768x1088768x1216768x1280768x1344800x1280832x960832x1024832x1088832x1152832x1216832x1248864x1152896x960896x1024896x1088896x1120896x1152960x832960x896960x1024960x10881024x8321024x8961024x9601024x10241088x7681088x8321088x8961088x9601120x8961152x7041152x8321152x8641152x8961216x7041216x7681216x8321248x8321280x7041280x7681280x8001312x7361344x6401344x7041344x7681408x5761408x6401408x7041472x5761472x6401472x7041536x5121536x5761536x640

aspect_ratio

enum<string>

可选

用于图像生成的纵横比，决定图像的分辨率。不能与resolution参数同时使用。默认为1x1

枚举值:

1x33x11x22x19x1616x910x1616x102x33x23x44x34x55x41x1

rendering_speed

enum<string>

渲染速度选项

可选

枚举值:

TURBODEFAULTQUALITY

默认值:

DEFAULT

magic_prompt

enum<string>

可选

决定是否在生成请求时使用Magic Prompt

枚举值:

AUTOONOFF

negative_prompt

string

可选

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

num_images

integer

要生成的图像数量

可选

>= 1<= 8

默认值:

color_palette

可选

生成的颜色调色板，必须通过预设之一（name）或通过带有可选权重的颜色的十六进制表示（members）明确指定

One of

object

name

string

预设调色板名称

必需

style_codes

array[string]

可选

表示图像风格的8字符十六进制代码列表。不能与style_reference_images或style_type一起使用

style_type

enum<string>

要生成的风格类型

可选

枚举值:

AUTOGENERALREALISTICDESIGN

默认值:

GENERAL

示例

{
    "prompt": "voluptate reprehenderit",
    "seed": 511526458,
    "rendering_speed": "DEFAULT"
   
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

request_id

string

必需

data

object

必需

task_id

string

必需

task_status

string

必需

created_at

integer

必需

updated_at

integer

必需

示例

{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "CjMT7WdSwWcAAAAAALvB3g",
    "data": {
        "task_id": "CjMT7WdSwWcAAAAAALvB3g",
        "task_status": "submitted",
        "created_at": 1733851336696,
        "updated_at": 1733851336696
    }
}