> ## Documentation Index > Fetch the complete documentation index at: https://dripart-docs-recommend-assets-api.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Ideogram V2 - ComfyUI 原生节点文档 > 使用Ideogram V2 API创建高质量图像和文字渲染的节点 ComfyUI 原生 Ideogram V2 节点 Ideogram V2 节点让你能够利用Ideogram的第二代AI模型生成更加精细的图像，特别是在文字渲染、图像质量和整体美学方面有所提升。 ## 参数说明 ### 必需参数 | 参数 | 类型 | 默认值 | 说明 | | ------ | --- | ----- | --------------------------- | | prompt | 字符串 | "" | 描述要生成内容的文本提示词 | | turbo | 布尔值 | False | 是否使用turbo模式（更快的生成速度，可能质量较低） | ### 可选参数 | 参数 | 类型 | 默认值 | 说明 | | --------------------- | --- | ------ | ----------------------------------------------------------------------------------- | | aspect\_ratio | 选择项 | "1:1" | 图像宽高比，当resolution设置为"Auto"时有效 | | resolution | 选择项 | "Auto" | 输出图像分辨率，如果不设为"Auto"，将覆盖aspect\_ratio设置 | | magic\_prompt\_option | 选择项 | "AUTO" | 决定是否在生成过程中使用MagicPrompt功能，选项有\["AUTO", "ON", "OFF"] | | seed | 整数 | 0 | 随机种子值，范围0-2147483647 | | style\_type | 选择项 | "NONE" | 生成风格类型（仅V2有效），选项有\["AUTO", "GENERAL", "REALISTIC", "DESIGN", "RENDER\_3D", "ANIME"] | | negative\_prompt | 字符串 | "" | 指定不希望在图像中出现的元素 | | num\_images | 整数 | 1 | 生成图像数量，范围1-8 | ### 输出 | 输出 | 类型 | 说明 | | ----- | -- | ------- | | IMAGE | 图像 | 生成的图像结果 | ## 源码参考 \[节点源码 (更新于2025-05-03)] ```python theme={null} class IdeogramV2(ComfyNodeABC): """ Generates images synchronously using the Ideogram V2 model. Images links are available for a limited period of time; if you would like to keep the image, you must download it. """ def __init__(self): pass @classmethod def INPUT_TYPES(cls) -> InputTypeDict: return { "required": { "prompt": ( IO.STRING, { "multiline": True, "default": "", "tooltip": "Prompt for the image generation", }, ), "turbo": ( IO.BOOLEAN, { "default": False, "tooltip": "Whether to use turbo mode (faster generation, potentially lower quality)", } ), }, "optional": { "aspect_ratio": ( IO.COMBO, { "options": list(V1_V2_RATIO_MAP.keys()), "default": "1:1", "tooltip": "The aspect ratio for image generation. Ignored if resolution is not set to AUTO.", }, ), "resolution": ( IO.COMBO, { "options": list(V1_V1_RES_MAP.keys()), "default": "Auto", "tooltip": "The resolution for image generation. If not set to AUTO, this overrides the aspect_ratio setting.", }, ), "magic_prompt_option": ( IO.COMBO, { "options": ["AUTO", "ON", "OFF"], "default": "AUTO", "tooltip": "Determine if MagicPrompt should be used in generation", }, ), "seed": ( IO.INT, { "default": 0, "min": 0, "max": 2147483647, "step": 1, "control_after_generate": True, "display": "number", }, ), "style_type": ( IO.COMBO, { "options": ["AUTO", "GENERAL", "REALISTIC", "DESIGN", "RENDER_3D", "ANIME"], "default": "NONE", "tooltip": "Style type for generation (V2 only)", }, ), "negative_prompt": ( IO.STRING, { "multiline": True, "default": "", "tooltip": "Description of what to exclude from the image", }, ), "num_images": ( IO.INT, {"default": 1, "min": 1, "max": 8, "step": 1, "display": "number"}, ), #"color_palette": ( # IO.STRING, # { # "multiline": False, # "default": "", # "tooltip": "Color palette preset name or hex colors with weights", # }, #), }, "hidden": {"auth_token": "AUTH_TOKEN_COMFY_ORG"}, } RETURN_TYPES = (IO.IMAGE,) FUNCTION = "api_call" CATEGORY = "api node/image/ideogram/v2" DESCRIPTION = cleandoc(__doc__ or "") API_NODE = True def api_call( self, prompt, turbo=False, aspect_ratio="1:1", resolution="Auto", magic_prompt_option="AUTO", seed=0, style_type="NONE", negative_prompt="", num_images=1, color_palette="", auth_token=None, ): aspect_ratio = V1_V2_RATIO_MAP.get(aspect_ratio, None) resolution = V1_V1_RES_MAP.get(resolution, None) # Determine the model based on turbo setting model = "V_2_TURBO" if turbo else "V_2" # Handle resolution vs aspect_ratio logic # If resolution is not AUTO, it overrides aspect_ratio final_resolution = None final_aspect_ratio = None if resolution != "AUTO": final_resolution = resolution else: final_aspect_ratio = aspect_ratio if aspect_ratio != "ASPECT_1_1" else None operation = SynchronousOperation( endpoint=ApiEndpoint( path="/proxy/ideogram/generate", method=HttpMethod.POST, request_model=IdeogramGenerateRequest, response_model=IdeogramGenerateResponse, ), request=IdeogramGenerateRequest( image_request=ImageRequest( prompt=prompt, model=model, num_images=num_images, seed=seed, aspect_ratio=final_aspect_ratio, resolution=final_resolution, magic_prompt_option=( magic_prompt_option if magic_prompt_option != "AUTO" else None ), style_type=style_type if style_type != "NONE" else None, negative_prompt=negative_prompt if negative_prompt else None, color_palette=color_palette if color_palette else None, ) ), auth_token=auth_token, ) response = operation.execute() if not response.data or len(response.data) == 0: raise Exception("No images were generated in the response") image_urls = [image_data.url for image_data in response.data if image_data.url] if not image_urls: raise Exception("No image URLs were generated in the response") return (download_and_process_images(image_urls),) ```