Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
48 commits
Select commit Hold shift + click to select a range
184d0b6
feat(api-nodes): add Comfy Cloud partner nodes
Aug 27, 2026
2c72df8
feat(api-nodes): add the Z-Image Turbo Comfy Cloud node
deepme987 Aug 28, 2026
d1d5b5d
feat(api-nodes): add Flux 2, Ideogram 4, LongCat and Capybara cloud n…
deepme987 Aug 28, 2026
0611e90
fix(api-nodes): accept the partner-node asset buckets for Comfy Cloud…
deepme987 Sep 1, 2026
ce10638
fix(api-nodes): quote the rate Comfy Cloud actually charges
deepme987 Sep 1, 2026
a379cd3
Merge remote-tracking branch 'origin/master' into deepme987/comfyui/c…
deepme987 Sep 1, 2026
7066c34
fix(api-nodes): show a real message when Comfy Cloud is unavailable
deepme987 Sep 1, 2026
5e432b8
refactor(api-nodes): name every Comfy Cloud node for its provider
deepme987 Sep 1, 2026
6f4335d
refactor(api-nodes): describe what each Comfy Cloud node actually does
deepme987 Sep 1, 2026
0cbffc4
fix(api-nodes): apply the Comfy Cloud bucket allowlist to the normali…
Sep 2, 2026
3b27581
refactor(api-nodes): cut the Comfy Cloud surface nothing here uses
Sep 2, 2026
020495e
fix(api-nodes): let the Wan 2.2 graph supply its own negative prompt
Sep 2, 2026
a4ae405
refactor(api-nodes): cut the Comfy Cloud comments back to the repo norm
deepme987 Sep 3, 2026
5485ccb
refactor(api-nodes): stop requiring response fields the node never reads
deepme987 Sep 3, 2026
92518f7
Merge branch 'master' into deepme987/comfyui/comfy-cloud-node/BE-9870
deepme987 Sep 3, 2026
74b26ef
refactor(api-nodes): put the task back in every Comfy Cloud node name
deepme987 Sep 3, 2026
dd0275d
Merge branch 'deepme987/comfyui/comfy-cloud-node/BE-9870' of https://…
deepme987 Sep 3, 2026
5c0b99c
refactor(api-nodes): give the workflow ids a shape that can outlive v1
deepme987 Sep 3, 2026
8f35261
feat(api-nodes): expose the rest of each Comfy Cloud pipeline's controls
deepme987 Sep 3, 2026
e9b68f2
feat(api-nodes): cut the shipped set to seven nodes
deepme987 Sep 3, 2026
2bf3ebe
feat(api-nodes): give Flux 2 a LoRA picker and both image nodes a mod…
deepme987 Sep 3, 2026
697453c
feat(api-nodes): give the two default image nodes a speed switch and …
deepme987 Sep 3, 2026
4fe0266
feat(api-nodes): add the default-pointer pickers and name pinned weig…
deepme987 Sep 3, 2026
7298d3a
refactor(api-nodes): drop the four capability nodes
deepme987 Sep 3, 2026
45594a1
feat(api-nodes): let a Comfy Cloud node return audio or a 3D model
deepme987 Sep 3, 2026
2147692
feat(api-nodes): add the Mage-Flow and MiniMax Music 3 Comfy Cloud nodes
deepme987 Sep 3, 2026
65ab9fd
feat(api-nodes): add the three MiniMax H3 video Comfy Cloud nodes
deepme987 Sep 3, 2026
2b1ede5
fix(api-nodes): give MiniMax H3 duration whole seconds
deepme987 Sep 3, 2026
e9b373d
Merge remote-tracking branch 'origin/master' into deepme987/comfyui/c…
deepme987 Sep 3, 2026
da0e7f3
refactor(api-nodes): rename the MiniMax H3 video nodes for what they do
deepme987 Sep 3, 2026
f8aac9b
feat(api-nodes): expose sampler, scheduler and text encoder on the Cl…
deepme987 Sep 3, 2026
e0603b2
feat(api-nodes): give Text to Video the same surface as its siblings
deepme987 Sep 3, 2026
ee9f1f0
Merge remote-tracking branch 'origin/master' into deepme987/comfyui/c…
deepme987 Sep 3, 2026
edadd35
refactor(comfy-cloud): simplify node surfaces per design review
deepme987 Sep 4, 2026
d64c72c
feat(comfy-cloud): mark the nodes BETA in name and description
deepme987 Sep 4, 2026
fd1e556
fix(comfy-cloud): accept the first-last-frame workflow id (BE-12049)
deepme987 Sep 4, 2026
9224439
Apply suggestion from @alexisrolland
alexisrolland Sep 4, 2026
7fd02bf
docs(comfy-cloud): the node rate is the list price, never a promo
deepme987 Sep 4, 2026
e6b424a
merge Alexis's caption_cfg removal
deepme987 Sep 4, 2026
3f0f3e7
chore(comfy-cloud): keep sending caption_cfg after its widget was rem…
deepme987 Sep 4, 2026
84c9b99
Use resolution selectors for Cloud image nodes
alexisrolland Sep 4, 2026
a91e56d
fix(comfy-cloud): the GPU rate is 0.001295, not 0.00185
deepme987 Sep 4, 2026
ed201ee
merge remote branch updates
deepme987 Sep 4, 2026
8be9ae9
Update nodes
alexisrolland Sep 4, 2026
caf6acb
Merge branch 'deepme987/comfyui/comfy-cloud-node/BE-9870' of https://…
alexisrolland Sep 4, 2026
4df5fc2
Fix linting
alexisrolland Sep 4, 2026
f7ee6e4
Disable unit test for disabled nodes
alexisrolland Sep 5, 2026
7cade6d
Merge branch 'master' into deepme987/comfyui/comfy-cloud-node/BE-9870
alexisrolland Sep 5, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
107 changes: 107 additions & 0 deletions comfy_api_nodes/apis/comfy_cloud.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
from typing import Literal

from pydantic import BaseModel, Field, field_validator


# Only the workflows this build ships. The backend serves more.
ComfyCloudWorkflow = Literal[
"z-image-turbo/text-to-image",
"flux-2/text-to-image",
"minimax-h3/text-to-video",
"minimax-h3/first-last-frame-to-video",
"minimax-h3/reference-to-video",
"minimax-h3/image-to-video",
"mage-flow/text-to-image",
"mage-flow-turbo/text-to-image",
"minimax-music-3/text-to-audio",
]


# Only the inputs the shipped nodes send. The manifests accept more.
class ComfyCloudWorkflowInputs(BaseModel):
prompt: str | None = Field(None)
image_url: str | None = Field(None)
assets: dict[str, "ComfyCloudAssetInput"] | None = Field(None)
audio_url: str | None = Field(None)
first_frame_url: str | None = Field(None)
last_frame_url: str | None = Field(None)
instruction: str | None = Field(None)
prompt_enhance: bool | None = Field(None)
enhance_prompt: bool | None = Field(None)
negative_prompt: str | None = Field(None)
aspect_ratio: str | None = Field(None)
duration_seconds: float | None = Field(None)
quality_mode: str | None = Field(None)
seed: int | None = Field(None, ge=0, le=0xFFFFFFFFFFFFFFFF)
scale: str | None = Field(None)
width: int | None = Field(None, ge=256, le=2048)
height: int | None = Field(None, ge=256, le=2048)
resolution: str | None = Field(None)
rendering_speed: str | None = Field(None)
color_correction: str | None = Field(None)
turbo: bool | None = Field(None)
style_lora: bool | None = Field(None)
model: str | None = Field(None)
lora: str | None = Field(None)
steps: int | None = Field(None, ge=1)
turbo_steps: int | None = Field(None, ge=1)
fast_steps: int | None = Field(None, ge=1)
cfg: float | None = Field(None, ge=0)
guidance: float | None = Field(None, ge=0)
shift: float | None = Field(None, ge=0)
turbo_strength: float | None = Field(None, ge=0)
style_strength: float | None = Field(None, ge=0)
megapixels: float | None = Field(None, gt=0)
size_multiple: int | None = Field(None, ge=1)
sampler: str | None = Field(None)
scheduler: str | None = Field(None)
denoise: float | None = Field(None, ge=0, le=1)
text_encoder: str | None = Field(None)
ref_image_size: str | None = Field(None)
lyrics: str | None = Field(None)
max_duration: float | None = Field(None, gt=0)
caption_cfg: float | None = Field(None, ge=0)
top_k: int | None = Field(None, ge=1)
tiled_decode: bool | None = Field(None)
tile_size: int | None = Field(None, ge=1)
tile_overlap: int | None = Field(None, ge=0)
audio_quality: str | None = Field(None)


class ComfyCloudAssetInput(BaseModel):
type: Literal["IMAGE", "VIDEO", "AUDIO"] = Field(...)
url: str = Field(...)


class ComfyCloudGenerateRequest(BaseModel):
workflow: ComfyCloudWorkflow = Field(...)
inputs: ComfyCloudWorkflowInputs = Field(...)


class ComfyCloudGenerateResponse(BaseModel):
task_id: str = Field(..., min_length=1)
status: str = Field(...)
polling_url: str | None = Field(None)
cancel_url: str | None = Field(None)

@field_validator("task_id")
@classmethod
def task_id_must_not_be_blank(cls, value: str) -> str:
if not value.strip():
raise ValueError("task_id must not be blank")
return value


class ComfyCloudStatusResponse(BaseModel):
task_id: str = Field(..., min_length=1)
status: str = Field(...)
progress: float | None = Field(None)
output_url: str | None = Field(None)
error: str | None = Field(None)

@field_validator("task_id")
@classmethod
def task_id_must_not_be_blank(cls, value: str) -> str:
if not value.strip():
raise ValueError("task_id must not be blank")
return value
Loading
Loading