The most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface. The fastest local inference engine in the world.
[Partner Nodes] feat: add Krea2 nodes (#14130)
Alexander Piskun175e85466a05
diff --git a/comfy_api_nodes/apis/krea.py b/comfy_api_nodes/apis/krea.pynew file mode 100644index 000000000..6e294a3b7--- /dev/null+++ b/comfy_api_nodes/apis/krea.py@@ -0,0 +1,46 @@+"""Pydantic models for the Krea image-generation API."""++from pydantic import BaseModel, Field+++class KreaMoodboard(BaseModel):+ id: str = Field(...)+ strength: float = Field(default=0.35, ge=-0.5, le=1.5)+++class KreaImageStyleReference(BaseModel):+ strength: float = Field(..., ge=-2.0, le=2.0)+ url: str | None = Field(default=None)+++class KreaGenerateImageRequest(BaseModel):+ prompt: str = Field(...)+ aspect_ratio: str = Field(...)+ resolution: str = Field(...)+ seed: int | None = Field(default=None)+ creativity: str = Field(default="medium")+ moodboards: list[KreaMoodboard] | None = Field(default=None)+ image_style_references: list[KreaImageStyleReference] | None = Field(default=None)+++class KreaJobResult(BaseModel):+ urls: list[str] | None = Field(default=None)+ style_id: str | None = Field(default=None)+++class KreaJob(BaseModel):+ job_id: str = Field(...)+ status: str = Field(...)+ created_at: str = Field(...)+ completed_at: str | None = Field(default=None)+ result: KreaJobResult | None = Field(default=None)+++class KreaAssetResponse(BaseModel):+ id: str = Field(...)+ image_url: str = Field(...)+ uploaded_at: str = Field(...)+ width: float | None = Field(default=None)+ height: float | None = Field(default=None)+ size_bytes: float | None = Field(default=None)+ mime_type: str | None = Field(default=None)diff --git a/comfy_api_nodes/nodes_krea.py b/comfy_api_nodes/nodes_krea.pynew file mode 100644index 000000000..003a8a654--- /dev/null+++ b/comfy_api_nodes/nodes_krea.py@@ -0,0 +1,290 @@+"""Krea image-generation nodes."""++import re++from typing_extensions import override++from comfy_api.latest import IO, ComfyExtension, Input+from comfy_api_nodes.apis.krea import (+ KreaAssetResponse,+ KreaGenerateImageRequest,+ KreaImageStyleReference,+ KreaJob,+ KreaMoodboard,+)+from comfy_api_nodes.util import (+ ApiEndpoint,+ download_url_to_image_tensor,+ poll_op,+ sync_op,+ tensor_to_bytesio,+ validate_string,+)+++class KreaIO:+ STYLE_REF = "KREA_STYLE_REF"+++async def _upload_image_to_krea_assets(cls: type[IO.ComfyNode], image: Input.Image) -> str:+ """Upload an image to Krea's /assets endpoint and return the Krea-hosted image URL."""+ img_io = tensor_to_bytesio(image, total_pixels=2048 * 2048, mime_type="image/png")+ response = await sync_op(+ cls,+ endpoint=ApiEndpoint(path="/proxy/krea/assets", method="POST"),+ response_model=KreaAssetResponse,+ files=[("file", (img_io.name, img_io, "image/png"))],+ content_type="multipart/form-data",+ max_retries=1,+ wait_label="Uploading reference",+ )+ return response.image_url+++_MODEL_MEDIUM = "Krea 2 Medium"+_MODEL_LARGE = "Krea 2 Large"+_MODEL_ENDPOINTS: dict[str, str] = {+ _MODEL_MEDIUM: "/proxy/krea/generate/image/krea/krea-2/medium",+ _MODEL_LARGE: "/proxy/krea/generate/image/krea/krea-2/large",+}++_ASPECT_RATIOS = ["1:1", "4:3", "3:2", "16:9", "2.35:1", "4:5", "2:3", "9:16"]+_RESOLUTIONS = ["1K"]+_CREATIVITY_LEVELS = ["raw", "low", "medium", "high"]+_KREA_QUEUED_STATUSES = ["backlogged", "queued", "scheduled"]++_UUID_RE = re.compile(r"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$")+++def _krea_model_inputs() -> list:+ """Nested inputs shared by both Krea 2 Medium and Large under the DynamicCombo."""+ return [+ IO.Combo.Input(+ "aspect_ratio",+ options=_ASPECT_RATIOS,+ tooltip="Output aspect ratio.",+ ),+ IO.Combo.Input(+ "resolution",+ options=_RESOLUTIONS,+ tooltip="Resolution scale.",+ ),+ IO.Combo.Input(+ "creativity",+ options=_CREATIVITY_LEVELS,+ default="medium",+ tooltip="Prompt interpretation strength: raw stays closest to the prompt; high is most creative.",+ ),+ IO.String.Input(+ "moodboard_id",+ default="",+ tooltip="Optional Krea moodboard UUID (e.g. from the Krea website). "+ "Leave empty to disable. Only one moodboard is supported per request.",+ optional=True,+ ),+ IO.Float.Input(+ "moodboard_strength",+ default=0.35,+ min=-0.5,+ max=1.5,+ step=0.05,+ tooltip="Moodboard influence; ignored when moodboard_id is empty.",+ optional=True,+ ),+ IO.Custom(KreaIO.STYLE_REF).Input(+ "style_reference",+ optional=True,+ tooltip="Optional chain of style references (max 10) from Krea 2 Style Reference nodes.",+ ),+ ]+++class Krea2ImageNode(IO.ComfyNode):++ @classmethod+ def define_schema(cls) -> IO.Schema:+ return IO.Schema(+ node_id="Krea2ImageNode",+ display_name="Krea 2 Image",+ category="api node/image/Krea",+ description=(+ "Generate images via Krea 2 — pick Medium (expressive illustrations) or "+ "Large (expressive photorealism). Supports an optional moodboard and up "+ "to 10 chained image style references."+ ),+ inputs=[+ IO.String.Input(+ "prompt",+ multiline=True,+ default="",+ tooltip="Text prompt for the image.",+ ),+ IO.DynamicCombo.Input(+ "model",+ options=[+ IO.DynamicCombo.Option(_MODEL_MEDIUM, _krea_model_inputs()),+ IO.DynamicCombo.Option(_MODEL_LARGE, _krea_model_inputs()),+ ],+ tooltip="Krea 2 Medium is best for expressive illustrations; "+ "Krea 2 Large is best for expressive photorealism.",+ ),+ IO.Int.Input(+ "seed",+ default=0,+ min=0,+ max=2147483647,+ control_after_generate=True,+ tooltip="Random seed for reproducibility.",+ ),+ ],+ outputs=[IO.Image.Output()],+ hidden=[+ IO.Hidden.auth_token_comfy_org,+ IO.Hidden.api_key_comfy_org,+ IO.Hidden.unique_id,+ ],+ is_api_node=True,+ price_badge=IO.PriceBadge(+ depends_on=IO.PriceBadgeDepends(+ widgets=["model", "model.moodboard_id"],+ inputs=["model.style_reference"],+ ),+ expr="""+ (+ $isLarge := widgets.model = "krea 2 large";+ $hasMoodboard := $length($lookup(widgets, "model.moodboard_id")) > 0;+ $hasStyle := $lookup(inputs, "model.style_reference").connected;+ $usd := $hasMoodboard+ ? ($isLarge ? 0.07 : 0.04)+ : ($hasStyle+ ? ($isLarge ? 0.065 : 0.035)+ : ($isLarge ? 0.06 : 0.03));+ {"type":"usd","usd": $usd}+ )+ """,+ ),+ )++ @classmethod+ async def execute(+ cls,+ prompt: str,+ model: dict,+ seed: int,+ ) -> IO.NodeOutput:+ validate_string(prompt, strip_whitespace=False, min_length=1)++ model_choice = model["model"]+ endpoint_path = _MODEL_ENDPOINTS.get(model_choice)+ if endpoint_path is None:+ raise ValueError(f"Unknown Krea 2 model: {model_choice!r}")++ moodboards: list[KreaMoodboard] | None = None+ mb_id = (model.get("moodboard_id") or "").strip()+ if mb_id:+ if not _UUID_RE.match(mb_id):+ raise ValueError(f"moodboard_id must be a UUID (received {mb_id!r}); copy it from the Krea website.")+ mb_strength = model.get("moodboard_strength")+ moodboards = [KreaMoodboard(id=mb_id, strength=0.35 if mb_strength is None else float(mb_strength))]++ style_reference = model.get("style_reference")+ image_style_references: list[KreaImageStyleReference] | None = None+ if style_reference:+ if len(style_reference) > 10:+ raise ValueError(f"Krea 2 accepts at most 10 image_style_references; received {len(style_reference)}.")+ image_style_references = [+ KreaImageStyleReference(url=ref["url"], strength=float(ref["strength"])) for ref in style_reference+ ]+ initial = await sync_op(+ cls,+ ApiEndpoint(path=endpoint_path, method="POST"),+ response_model=KreaJob,+ data=KreaGenerateImageRequest(+ prompt=prompt,+ aspect_ratio=model["aspect_ratio"],+ resolution=model["resolution"],+ seed=seed,+ creativity=model["creativity"],+ moodboards=moodboards,+ image_style_references=image_style_references,+ ),+ )+ job = await poll_op(+ cls,+ ApiEndpoint(path=f"/proxy/krea/jobs/{initial.job_id}", method="GET"),+ response_model=KreaJob,+ status_extractor=lambda r: r.status,+ queued_statuses=_KREA_QUEUED_STATUSES,+ )+ if not job.result or not job.result.urls:+ raise RuntimeError(f"Krea 2 job {job.job_id} completed without any image URLs.")+ image = await download_url_to_image_tensor(job.result.urls[0])+ return IO.NodeOutput(image)+++class Krea2StyleReferenceNode(IO.ComfyNode):++ @classmethod+ def define_schema(cls) -> IO.Schema:+ return IO.Schema(+ node_id="Krea2StyleReferenceNode",+ display_name="Krea 2 Style Reference",+ category="api node/image/Krea",+ description=(+ "Add an image style reference to a Krea 2 generation. Chain multiple Krea 2 "+ "Style Reference nodes (max 10) and feed the final `style_reference` output "+ "into Krea 2 Image. Each image is uploaded to ComfyAPI storage and passed as URL."+ ),+ inputs=[+ IO.Image.Input(+ "image",+ tooltip="Reference image whose style influences the generation.",+ ),+ IO.Float.Input(+ "strength",+ default=1.0,+ min=-2.0,+ max=2.0,+ step=0.05,+ tooltip="Reference strength; negative values invert the style influence.",+ ),+ IO.Custom(KreaIO.STYLE_REF).Input(+ "style_reference",+ optional=True,+ tooltip="Optional incoming chain of style references; this node appends one more.",+ ),+ ],+ outputs=[IO.Custom(KreaIO.STYLE_REF).Output(display_name="style_reference")],+ hidden=[+ IO.Hidden.auth_token_comfy_org,+ IO.Hidden.api_key_comfy_org,+ IO.Hidden.unique_id,+ ],+ )++ @classmethod+ async def execute(+ cls,+ image: Input.Image,+ strength: float,+ style_reference: list[dict] | None = None,+ ) -> IO.NodeOutput:+ chain: list[dict] = list(style_reference) if style_reference else []+ if len(chain) >= 10:+ raise ValueError("Krea 2 accepts at most 10 image_style_references in one generation.")+ url = await _upload_image_to_krea_assets(cls, image)+ chain.append({"url": url, "strength": float(strength)})+ return IO.NodeOutput(chain)+++class KreaExtension(ComfyExtension):+ @override+ async def get_node_list(self) -> list[type[IO.ComfyNode]]:+ return [+ Krea2ImageNode,+ Krea2StyleReferenceNode,+ ]+++async def comfy_entrypoint() -> KreaExtension:+ return KreaExtension()