Generates images synchronously based on a given prompt and optional parameters.
具体参数请看官方文档：https://developer.ideogram.ai/api-reference/api-reference/describe
根据给定的提示和可选参数同步生成图像。
返回的图像 URL 在 24 小时内有效，超过该时间将无法访问图像。
已反代图片
POST
/ideogram/generateideogram（文生图）
API Key application/json
请求示例
curl -X POST https://top.qingyuntop.ai/ideogram/generate \
-H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
-H "Content-Type: application/json" \
-d '
{
"image_request": {
"aspect_ratio": "ASPECT_10_16",
"magic_prompt_option": "AUTO",
"model": "V_1",
"prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset."
}
}'请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
Content-Type | Header | string | 是 | - | application/json |
Accept | Header | string | 是 | - | application/json |
Authorization | Header | string | 是 | - | Bearer {{YOUR_API_KEY}} |
image_request | JSON body | object | 是 | 图像请求对象 (必填) | - |
image_request.prompt | JSON body | string | 是 | 用于生成图像的提示词 (必填) | - |
image_request.aspect_ratio | JSON body | string | 是 | 图像宽高比 (可选) 可选值:ASPECT_10_16/ASPECT_16_10/ASPECT_9_16/ASPECT_16_9/ASPECT_3_2/ASPECT_2_3/ASPECT_4_3/ASPECT_3_4/ASPECT_1_1/ASPECT_1_3/ASPECT_3_1 | - |
image_request.model | JSON body | string | 是 | 使用的模型 (可选) 默认V_2,可选值:V_1/V_1_TURBO/V_2/V_2_TURBO | - |
image_request.magic_prompt_option | JSON body | string | 是 | 是否使用MagicPrompt (可选) 可选值:AUTO/ON/OFF | - |
image_request.seed | JSON body | integer | 是 | 随机种子 (可选) 范围:0-2147483647 | - |
image_request.style_type | JSON body | string | 是 | 风格类型 (可选) 可选值:AUTO/GENERAL/REALISTIC/DESIGN/RENDER_3D/ANIME | - |
image_request.negative_prompt | JSON body | string | 是 | 反向提示词 (可选) 描述不想在图像中出现的内容 | - |
image_request.num_images | JSON body | integer | 是 | 生成图片数量 (可选) 范围:1-8,默认1 | - |
image_request.resolution | JSON body | string | 是 | 分辨率 (可选) 可选值包含从512x1536到1536x640等多种分辨率组合 | - |
image_request.color_palette | JSON body | object | 是 | 颜色调色板 (可选) | - |
image_request.color_palette.name | JSON body | string | 是 | 预设调色板名称 (与members二选一) 可选值:EMBER/FRESH/JUNGLE/MAGIC/MELON/MOSAIC/PASTEL/ULTRAMARINE | - |
返回响应 (200)
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
created | 响应 JSON | string | 是 | - | - |
data | 响应 JSON | array<object> | 是 | - | - |
data[].is_image_safe | 响应 JSON | boolean | 否 | - | - |
data[].prompt | 响应 JSON | string | 否 | - | - |
data[].resolution | 响应 JSON | string | 否 | - | - |
data[].seed | 响应 JSON | integer | 否 | - | - |
data[].style_type | 响应 JSON | null | 否 | - | - |
data[].url | 响应 JSON | string | 否 | - | - |
响应示例
{
"created": "2024-12-15T17:32:00.965408+00:00",
"data": [
{
"is_image_safe": true,
"prompt": "A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.",
"resolution": "768x1232",
"seed": 1785282233,
"style_type": null,
"url": "https://ideogram.ai/api/images/ephemeral/WkoxvqiOTaaCqG1nO2tQoA.png?exp=1734370337&sig=110fe96dc9e01002c8d837e5b4cde1aaa266195561d231ce76e19e095e478ffe"
}
]
}
来源原始接口定义（用于追溯）
以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。
{
"id": 495899664,
"name": "ideogram（文生图）",
"type": "http",
"serverId": "",
"preProcessors": [],
"postProcessors": [],
"inheritPreProcessors": {},
"inheritPostProcessors": {},
"description": "Generates images synchronously based on a given prompt and optional parameters.\n具体参数请看官方文档：https://developer.ideogram.ai/api-reference/api-reference/describe\n\n根据给定的提示和可选参数同步生成图像。\n返回的图像 URL 在 24 小时内有效，超过该时间将无法访问图像。\n已反代图片",
"operationId": "",
"sourceUrl": "",
"method": "post",
"path": "/ideogram/generate",
"tags": [],
"status": 1,
"requestBody": {
"type": "application/json",
"parameters": [],
"jsonSchema": {
"type": "object",
"properties": {
"image_request": {
"type": "object",
"properties": {
"prompt": {
"description": "用于生成图像的提示词 (必填)",
"type": "string"
},
"aspect_ratio": {
"description": "图像宽高比 (可选) 可选值:ASPECT_10_16/ASPECT_16_10/ASPECT_9_16/ASPECT_16_9/ASPECT_3_2/ASPECT_2_3/ASPECT_4_3/ASPECT_3_4/ASPECT_1_1/ASPECT_1_3/ASPECT_3_1",
"type": "string"
},
"model": {
"description": "使用的模型 (可选) 默认V_2,可选值:V_1/V_1_TURBO/V_2/V_2_TURBO",
"type": "string"
},
"magic_prompt_option": {
"description": "是否使用MagicPrompt (可选) 可选值:AUTO/ON/OFF",
"type": "string"
},
"seed": {
"description": "随机种子 (可选) 范围:0-2147483647",
"type": "integer"
},
"style_type": {
"description": "风格类型 (可选) 可选值:AUTO/GENERAL/REALISTIC/DESIGN/RENDER_3D/ANIME",
"type": "string"
},
"negative_prompt": {
"description": "反向提示词 (可选) 描述不想在图像中出现的内容",
"type": "string"
},
"num_images": {
"description": "生成图片数量 (可选) 范围:1-8,默认1",
"type": "integer"
},
"resolution": {
"description": "分辨率 (可选) 可选值包含从512x1536到1536x640等多种分辨率组合",
"type": "string"
},
"color_palette": {
"type": "object",
"properties": {
"name": {
"description": "预设调色板名称 (与members二选一) 可选值:EMBER/FRESH/JUNGLE/MAGIC/MELON/MOSAIC/PASTEL/ULTRAMARINE",
"type": "string"
}
},
"required": [
"name"
],
"description": "颜色调色板 (可选)",
"x-apifox-orders": [
"name"
]
}
},
"required": [
"prompt",
"aspect_ratio",
"model",
"magic_prompt_option",
"seed",
"style_type",
"negative_prompt",
"num_images",
"resolution",
"color_palette"
],
"description": "图像请求对象 (必填)",
"x-apifox-orders": [
"prompt",
"aspect_ratio",
"model",
"magic_prompt_option",
"seed",
"style_type",
"negative_prompt",
"num_images",
"resolution",
"color_palette"
]
}
},
"required": [
"image_request"
],
"x-apifox-orders": [
"image_request"
]
},
"examples": [
{
"value": "\n{\n \"image_request\": {\n \"aspect_ratio\": \"ASPECT_10_16\",\n \"magic_prompt_option\": \"AUTO\",\n \"model\": \"V_1\",\n \"prompt\": \"A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.\"\n }\n}",
"mediaType": "application/json",
"description": ""
}
],
"mediaType": "",
"oasExtensions": "",
"required": false,
"additionalContentTypes": []
},
"parameters": {
"path": [],
"query": [],
"cookie": [],
"header": [
{
"id": "NQs7bxnpZf",
"name": "Content-Type",
"required": true,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "application/json"
},
{
"id": "qb8tEQbCty",
"name": "Accept",
"required": true,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "application/json"
},
{
"id": "gBxcCbXhsa",
"name": "Authorization",
"required": true,
"enable": true,
"description": "",
"type": "string",
"sampleValue": "Bearer {{YOUR_API_KEY}}"
}
]
},
"commonParameters": {
"query": [],
"body": [],
"cookie": [],
"header": []
},
"auth": {
"type": "noauth"
},
"responses": [
{
"id": 136346022,
"name": "成功",
"code": 200,
"contentType": "json",
"jsonSchema": {
"type": "object",
"properties": {
"created": {
"type": "string"
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"is_image_safe": {
"type": "boolean"
},
"prompt": {
"type": "string"
},
"resolution": {
"type": "string"
},
"seed": {
"type": "integer"
},
"style_type": {
"type": "null"
},
"url": {
"type": "string"
}
},
"x-apifox-orders": [
"is_image_safe",
"prompt",
"resolution",
"seed",
"style_type",
"url"
]
}
}
},
"required": [
"created",
"data"
],
"x-apifox-orders": [
"created",
"data"
]
},
"itemSchema": {},
"description": "",
"mediaType": "",
"headers": [],
"oasExtensions": ""
}
],
"responseExamples": [
{
"name": "成功示例",
"responseId": 136346022,
"data": "{\n \"created\": \"2024-12-15T17:32:00.965408+00:00\",\n \"data\": [\n {\n \"is_image_safe\": true,\n \"prompt\": \"A serene tropical beach scene. Dominating the foreground are tall palm trees with lush green leaves, standing tall against a backdrop of a sandy beach. The beach leads to the azure waters of the sea, which gently kisses the shoreline. In the distance, there is an island or landmass with a silhouette of what appears to be a lighthouse or tower. The sky above is painted with fluffy white clouds, some of which are tinged with hues of pink and orange, suggesting either a sunrise or sunset.\",\n \"resolution\": \"768x1232\",\n \"seed\": 1785282233,\n \"style_type\": null,\n \"url\": \"https://ideogram.ai/api/images/ephemeral/WkoxvqiOTaaCqG1nO2tQoA.png?exp=1734370337&sig=110fe96dc9e01002c8d837e5b4cde1aaa266195561d231ce76e19e095e478ffe\"\n }\n ]\n}\n",
"description": "",
"oasKey": "",
"oasExtensions": "",
"id": "019fc09b-0b13-775e-923c-00f3f6873d00"
}
],
"codeSamples": [],
"projectId": 8662722,
"moduleId": 8310462,
"folderId": 92436106,
"ordering": 30,
"responsibleId": 0,
"commonResponseStatus": {},
"advancedSettings": {
"disabledSystemHeaders": {},
"isDefaultUrlEncoding": 1
},
"customApiFields": {},
"oasExtensions": "",
"mockScript": {},
"createdAt": "2026-08-02T03:53:34.000Z",
"updatedAt": "2026-08-06T12:15:55.000Z",
"creatorId": 2863449,
"editorId": 2863449,
"creatorUserId": 2863449,
"editorUserId": 2863449,
"responseChildren": [],
"visibility": "INHERITED",
"securityScheme": {},
"callbacks": ""
}