Use Ideogram 4.0 with Comfy Router

Python, TypeScript and cURL snippets for generating images with Ideogram 4.0 over HTTP through Comfy Router, plus the request fields and the result shape

Use Ideogram 4.0 with Comfy Router. Ideogram 4.0 is Ideogram’s text-to-image model, which renders legible text inside generated images.

Quick start

Create a key at platform.comfy.org/profile/api-keys and export it as COMFY_API_KEY. The Python and TypeScript snippets use the Comfy SDKs (pip install comfy-sdk, npm install @comfyorg/sdk); the cURL snippet is the same call over raw HTTP.

Model ID: ideogram/ideogram-v4

Endpoint: POST https://api.comfy.org/v2/models/ideogram/ideogram-v4

Python

import uuid
from comfy_sdk import Comfy

# Reads COMFY_API_KEY from the environment. Save this key and reuse it if you
# retry this request after the SDK returns an error.
idempotency_key = str(uuid.uuid4())
with Comfy() as client:
    result = client.models.run(
        "ideogram/ideogram-v4",
        {
            "text_prompt": "a single red maple leaf on a plain white background, studio lighting",
            "resolution": "1024x1024",
            "rendering_speed": "DEFAULT",
        },
        idempotency_key=idempotency_key,
    )

print("image:", result["data"][0]["url"])

Schema

Input

enable_copyright_detection · boolean

Opt into post-generation copyright detection (Hive likeness and logo checks).

json_prompt · object

Structured V4 prompt. Disables Magic Prompt; consumed directly. Supply exactly one of text_prompt or json_prompt.

rendering_speed · string · default: "\"DEFAULT\""

The rendering speed setting that controls the trade-off between generation speed and quality

Possible values: DEFAULT, TURBO, QUALITY

resolution · string

Output resolution in WIDTHxHEIGHT. Omit to let the model pick an aspect ratio. Supported 2K values: 2048x2048, 1440x2880, 2880x1440, 1664x2496, 2496x1664, 1792x2240, 2240x1792, 1440x2560, 2560x1440, 1600x2560, 2560x1600, 1728x2304, 2304x1728, 1296x3168, 3168x1296, 1152x2944, 2944x1152, 1248x3328, 3328x1248, 1280x3072, 3072x1280.

text_prompt · string

Natural-language prompt. Enables Magic Prompt automatically. Supply exactly one of text_prompt or json_prompt.

Generated from the schema Router serves at GET /v2/models/ideogram/ideogram-v4/openapi.json, the same document it validates a call against before the request reaches the provider.

Output

created · string (date-time)

Timestamp when the generation was created.

Format: date-time

data · object[]

Array of generated image information.

data[].is_image_safe · boolean

Indicates whether the image is considered safe.

data[].prompt · string

The prompt used to generate this image.

data[].resolution · string

The resolution of the generated image (e.g., ‘1024x1024’).

data[].seed · integer

The seed value used for this generation.

data[].style_type · string

The style type used for generation (e.g., ‘REALISTIC’, ‘ANIME’).

data[].url · string

URL to the generated image.

Examples

Input

{
  "rendering_speed": "DEFAULT",
  "text_prompt": "A poster for a jazz festival, bold typography, warm colours"
}

Output

{
  "created": "2026-01-01T00:00:00Z",
  "data": [
    {
      "is_image_safe": true,
      "prompt": "A poster for a jazz festival, bold typography, warm colours",
      "resolution": "2048x2048",
      "seed": 918273645,
      "style_type": "REALISTIC",
      "url": "https://example.invalid/ideogram/ideogram-v4/generated.png"
    }
  ]
}

The URL is temporary. Download the image promptly if you need to keep it.

Before you ship

Save one Idempotency-Key for each call and reuse it for retries. Router can hold the connection for up to 10 minutes. The SDKs handle authentication; raw HTTP clients send the headers themselves.

Use X-Comfy-Error-Type to classify a failure. A 422 means Router rejected the input before calling the provider. Download generated assets promptly because result URLs can expire.

Headers

Authentication, idempotency, request IDs, error buckets, retry pacing, spend limits.

Using the Router API

Find models, inspect schemas, and retry safely.

Limitations

What Router does not do today, and what to use instead.