ideogram（文生图）
POST /ideogram/generate
说明
Generates images synchronously based on a given prompt and optional parameters. 具体参数请看官方文档：https://developer.ideogram.ai/api-reference/api-reference/describe
根据给定的提示和可选参数同步生成图像。 返回的图像 URL 在 24 小时内有效，超过该时间将无法访问图像。 已反代图片
概览
| Method | POST |
|---|---|
| Path | /ideogram/generate |
| Type | http |
| Status | 1 |
| Module | 2102810 |
| Folder | 47229507 |
参数
{ "query": [], "path": [], "cookie": [], "header": [ { "id": "NQs7bxnpZf", "name": "Content-Type", "required": true, "description": "", "type": "string", "enable": true, "sampleValue": "application/json" }, { "id": "qb8tEQbCty", "name": "Accept", "required": true, "description": "", "type": "string", "enable": true, "sampleValue": "application/json" }, { "required": true, "description": "", "type": "string", "id": "gBxcCbXhsa", "enable": true, "name": "Authorization", "sampleValue": "Bearer {{YOUR_API_KEY}}" } ] }
请求体
{ "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" ] }, "required": false, "mediaType": "", "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": "" } ], "oasExtensions": "" }
响应
[ { "id": 585438680, "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" } } } } }, "required": [ "created", "data" ] }, "itemSchema": {}, "description": "", "mediaType": "", "headers": [], "oasExtensions": "" } ]
响应示例
[ { "name": "成功示例", "responseId": 585438680, "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": 455446578 } ]