Ideogram 3.0 图片生成接口 - QuickRouter API 中转接口
▼
Authorization
在 Header 添加参数 Authorization，其值为 Bearer 之后拼接 Token
示例：
Authorization: Bearer ********************
使用 Ideogram 3.0 模型，根据给定的提示和可选参数同步生成图像 具体参数请看官方文档：https://developer.ideogram.ai/api-reference/api-reference/generate-v3 返回的图像 URL 在 24 小时内有效，超过该时间将无法访问图像。 已反代图片
请求参数
Header 参数
Content-Type
string
必需
示例: application/json
Accept
string
必需
示例: application/json
Authorization
string
必需
示例: Bearer {{YOUR_API_KEY}}
Body 参数 application/json
prompt
string
必需
生成图像所需的提示文本
seed
integer
可选
随机种子。设置此值可获得可重复的生成结果 >= 0 <= 2147483647
resolution
可选
enum<string> 支持的分辨率选项 可选 枚举值: 512x1536 576x1408 576x1472 576x1536 640x1344 640x1408 640x1472 640x1536 704x1152 704x1216 704x1280 704x1344 704x1408 704x1472 736x1312 768x1088 768x1216 768x1280 768x1344 800x1280 832x960 832x1024 832x1088 832x1152 832x1216 832x1248 864x1152 896x960 896x1024 896x1088 896x1120 896x1152 960x832 960x896 960x1024 960x1088 1024x832 1024x896 1024x960 1024x1024 1088x768 1088x832 1088x896 1088x960 1120x896 1152x704 1152x832 1152x864 1152x896 1216x704 1216x768 1216x832 1248x832 1280x704 1280x768 1280x800 1312x736 1344x640 1344x704 1344x768 1408x576 1408x640 1408x704 1472x576 1472x640 1472x704 1536x512 1536x576 1536x640
aspect_ratio
可选
enum<string> 可选 用于图像生成的纵横比，决定图像的分辨率。不能与resolution参数同时使用。默认为1x1 枚举值: 1x3 3x1 1x2 2x1 9x16 16x9 10x16 16x10 2x3 3x2 3x4 4x3 4x5 5x4 1x1
rendering_speed
可选
enum<string> 渲染速度选项 可选 枚举值:
TURBO
可选
DEFAULT
可选
QUALITY
可选
默认值:
DEFAULT
可选
magic_prompt
可选
enum<string> 可选 决定是否在生成请求时使用Magic Prompt 枚举值:
AUTO
可选
ON
可选
OFF
可选
negative_prompt
string
可选
描述要在图像中排除的内容。提示中的描述优先于负面提示中的描述
num_images
integer
可选
要生成的图像数量 可选 >= 1 <= 8 默认值: 1
color_palette
可选
生成的颜色调色板，必须通过预设之一（name）或通过带有可选权重的颜色的十六进制表示（members）明确指定 One of:
object
object
可选
name
string
可选
预设调色板名称 必需
style_codes
array[string]
可选
表示图像风格的8字符十六进制代码列表。不能与style_reference_images或style_type一起使用
style_type
可选
enum<string> 要生成的风格类型 可选 枚举值:
AUTO
可选
GENERAL
可选
REALISTIC
可选
DESIGN
可选
默认值:
GENERAL
可选
{ "prompt": "voluptate reprehenderit", "seed": 511526458, "rendering_speed": "DEFAULT" } 请求
示例
{
"prompt": "voluptate reprehenderit",
"seed": 511526458,
"rendering_speed": "DEFAULT"
}请求示例代码
curl --location --request POST 'https://api.quickrouter.ai/ideogram/v1/ideogram-v3/generate' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"prompt": "voluptate reprehenderit",
"seed": 511526458,
"rendering_speed": "DEFAULT"
}'返回响应
响应参数 🟢 200 OK · application/json
code
integer
必需
message
string
必需
request_id
string
必需
data
object
必需
task_id
string
必需
task_status
string
必需
created_at
integer
必需
updated_at
integer
必需
{ "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" }
示例
{
"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"
}