> ## 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.

# Stability Stable Image Ultra - ComfyUI ネイティブノードドキュメント

> Stability AI の超安定拡散モデルを用いて高品質な画像を生成するノード

<img src="https://mintcdn.com/dripart-docs-recommend-assets-api/zDHpPUeID0CgytL1/images/built-in-nodes/api_nodes/stability-ai/stability-ai-stable-image-ultra.jpg?fit=max&auto=format&n=zDHpPUeID0CgytL1&q=85&s=6786b6ed5e1af39b232e3d8ca8a1c386" alt="ComfyUI ネイティブ Stability Stable Image Ultra ノード" width="1731" height="1499" data-path="images/built-in-nodes/api_nodes/stability-ai/stability-ai-stable-image-ultra.jpg" />

Stability Stable Image Ultra ノードは、Stability AI の Stable Diffusion Ultra API を使用して高品質な画像を生成します。テキストから画像への生成（text-to-image）および画像から画像への生成（image-to-image）の両方をサポートしており、テキストプロンプトに基づいて、ディテールが豊かで芸術性の高いビジュアルを生成します。

## パラメータ

### 必須パラメータ

| パラメータ         | 型   | デフォルト値 | 説明                                                                                                                                                                         |
| ------------- | --- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| prompt        | 文字列 | ""     | 生成したい内容を記述したテキストです。要素、色、テーマを明確に指定した、明瞭で描写力のあるプロンプトほど、より優れた結果が得られます。特定の単語の重みを制御するには `(単語:重み)` の形式を使用できます。ここで重みは 0～1 の範囲の値です。例：`空は (青:0.3) で (緑:0.8)` とすると、空の色は青よりも緑が強調されます。 |
| aspect\_ratio | 選択  | "1:1"  | 出力画像の幅と高さの比率                                                                                                                                                               |
| style\_preset | 選択  | "None" | 生成画像に適用するオプションのスタイルプリセット                                                                                                                                                   |
| seed          | 整数  | 0      | ノイズ生成のための乱数シード（0～4294967294）                                                                                                                                               |

### オプションパラメータ

| パラメータ            | 型      | デフォルト値 | 説明                                                                           |
| ---------------- | ------ | ------ | ---------------------------------------------------------------------------- |
| image            | 画像     | -      | 画像から画像への生成（image-to-image）に使用する入力画像                                          |
| negative\_prompt | 文字列    | ""     | 出力画像に含めたくない要素を記述するテキストです。高度な機能です。                                            |
| image\_denoise   | 浮動小数点数 | 0.5    | 入力画像のデノイズ強度（0.0～1.0）。0.0 の場合、入力画像と完全に同一の出力となり、1.0 の場合、入力画像が存在しないのと同じ効果になります。 |

### 出力

| 出力    | 型  | 説明      |
| ----- | -- | ------- |
| IMAGE | 画像 | 生成された画像 |

## 注意事項

* 入力画像が指定されていない場合、`image_denoise` は無効になります。
* `style_preset` が `"None"` の場合、スタイルプリセットは適用されません。
* 画像から画像への生成では、入力画像が API 送信前に適切な形式に変換されます。

## ソースコード

\[ノードのソースコード（2025-05-03 更新）]

```python theme={null}

class StabilityStableImageUltraNode:
    """
    Generates images synchronously based on prompt and resolution.
    """

    RETURN_TYPES = (IO.IMAGE,)
    DESCRIPTION = cleandoc(__doc__ or "")  # Handle potential None value
    FUNCTION = "api_call"
    API_NODE = True
    CATEGORY = "api node/image/stability"

    @classmethod
    def INPUT_TYPES(s):
        return {
            "required": {
                "prompt": (
                    IO.STRING,
                    {
                        "multiline": True,
                        "default": "",
                        "tooltip": "What you wish to see in the output image. A strong, descriptive prompt that clearly defines" +
                                    "What you wish to see in the output image. A strong, descriptive prompt that clearly defines" +
                                    "elements, colors, and subjects will lead to better results. " +
                                    "To control the weight of a given word use the format `(word:weight)`," +
                                    "where `word` is the word you'd like to control the weight of and `weight`" +
                                    "is a value between 0 and 1. For example: `The sky was a crisp (blue:0.3) and (green:0.8)`" +
                                    "would convey a sky that was blue and green, but more green than blue."
                    },
                ),
                "aspect_ratio": ([x.value for x in StabilityAspectRatio],
                    {
                        "default": StabilityAspectRatio.ratio_1_1,
                        "tooltip": "Aspect ratio of generated image.",
                    },
                ),
                "style_preset": (get_stability_style_presets(),
                    {
                        "tooltip": "Optional desired style of generated image.",
                    },
                ),
                "seed": (
                    IO.INT,
                    {
                        "default": 0,
                        "min": 0,
                        "max": 4294967294,
                        "control_after_generate": True,
                        "tooltip": "The random seed used for creating the noise.",
                    },
                ),
            },
            "optional": {
                "image": (IO.IMAGE,),
                "negative_prompt": (
                    IO.STRING,
                    {
                        "default": "",
                        "forceInput": True,
                        "tooltip": "A blurb of text describing what you do not wish to see in the output image. This is an advanced feature."
                    },
                ),
                "image_denoise": (
                    IO.FLOAT,
                    {
                        "default": 0.5,
                        "min": 0.0,
                        "max": 1.0,
                        "step": 0.01,
                        "tooltip": "Denoise of input image; 0.0 yields image identical to input, 1.0 is as if no image was provided at all.",
                    },
                ),
            },
            "hidden": {
                "auth_token": "AUTH_TOKEN_COMFY_ORG",
            },
        }

    def api_call(self, prompt: str, aspect_ratio: str, style_preset: str, seed: int,
                 negative_prompt: str=None, image: torch.Tensor = None, image_denoise: float=None,
                 auth_token=None):
        # prepare image binary if image present
        image_binary = None
        if image is not None:
            image_binary = tensor_to_bytesio(image, 1504 * 1504).read()
        else:
            image_denoise = None

        if not negative_prompt:
            negative_prompt = None
        if style_preset == "None":
            style_preset = None

        files = {
            "image": image_binary
        }

        operation = SynchronousOperation(
            endpoint=ApiEndpoint(
                path="/proxy/stability/v2beta/stable-image/generate/ultra",
                method=HttpMethod.POST,
                request_model=StabilityStableUltraRequest,
                response_model=StabilityStableUltraResponse,
            ),
            request=StabilityStableUltraRequest(
                prompt=prompt,
                negative_prompt=negative_prompt,
                aspect_ratio=aspect_ratio,
                seed=seed,
                strength=image_denoise,
                style_preset=style_preset,
            ),
            files=files,
            content_type="multipart/form-data",
            auth_token=auth_token,
        )
        response_api = operation.execute()

        if response_api.finish_reason != "SUCCESS":
            raise Exception(f"Stable Image Ultra generation failed: {response_api.finish_reason}.")

        image_data = base64.b64decode(response_api.image)
        returned_image = bytesio_to_image_tensor(BytesIO(image_data))

        return (returned_image,)

```
