chore: sync Comfy API v2 specification and Comfy Router pages (cloud@fdf7af6) by comfy-pr-bot · Pull Request #1687 · Comfy-Org/docs

comfy-pr-bot · 2026-09-15T23:57:12Z

Automated sync of the public Comfy API v2 specification used by
the generated API reference, and of the Comfy Router API
pages generated from the Comfy API contract. Source:
cloud@fdf7af6.

development/comfy-router/reference.mdx is GENERATED - edit the upstream
contract, not this copy. It is regenerated on every sync and an
edit made here is overwritten by the next one.

development/comfy-router/quickstart.mdx and development/comfy-router/limitations.mdx
are hand-written upstream and published verbatim. They are likewise
overwritten on every sync, so edit them upstream. If this is the
first sync that carries one of them, it also needs a navigation
entry in this repository before it renders.

router-schemas/<provider>/<model>.json are the exact
GET /v2/models/{id}/openapi.json documents for every model with an
authored schema; the docs generator
(.github/scripts/snippets/gen-code-pages.ts) reads them. They are
GENERATED and the directory is MIRRORED on every sync, so a document
removed upstream is removed here too - edit the upstream contract,
not these copies.

development/comfy-router/models/**/code.mdx, the provider index
development/comfy-router/models.mdx and the docs.json
entries for them are this repository's OWN derived output: the sync
runs bun run code-pages:gen -- --prune over the documents above and
commits the result, so code-pages is green as opened and no regen
commit is needed on this branch. They are GENERATED and PRUNED - a
page whose model left the catalog is deleted here too.

This is the single rolling sync pull request for the published
Comfy API v2 specification and Comfy Router pages. It lives on
chore/sync-comfy-api-v2-spec, and every later upstream change
force-updates that branch and refreshes this description with the
new source commit — so there is only ever one open sync pull request
here, and its diff is always the current one. Please do not push
commits to this branch; the next sync would overwrite them (it
checks first and fails rather than doing so silently).

The projection strips internal operations and non-public source
annotations, and fails before this pull request can be created if
a known internal marker survives. This pull request is never
auto-merged and requires human review.

github-actions · 2026-09-15T23:57:32Z

🌐 i18n translation sync reminder

@comfyui-wiki English documentation was updated in this PR. Please complete or schedule translation updates for the following files:

Japanese (`ja`)

ja/development/comfy-router/limitations.mdx
ja/development/comfy-router/models.mdx
ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx
ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx
ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx
ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx
ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx
ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx
ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx
ja/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx
ja/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx
ja/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx
ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx
ja/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx
ja/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx
ja/development/comfy-router/models/google/imagen-3-0-fast-generate-001/code.mdx
ja/development/comfy-router/models/google/imagen-3-0-generate-001/code.mdx
ja/development/comfy-router/models/google/imagen-3-0-generate-002/code.mdx
ja/development/comfy-router/models/heygen/starfish/code.mdx
ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
ja/development/comfy-router/models/kling/kling-v2-6/code.mdx
ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx
ja/development/comfy-router/models/kling/kling-v3/code.mdx
ja/development/comfy-router/models/kling/kling-video-o1/code.mdx
ja/development/comfy-router/models/recraft/recraftv2/code.mdx
ja/development/comfy-router/models/recraft/recraftv3/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-1-pro/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-1-utility/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-1-vector/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-1/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-pro/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-styles-pro/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-styles-vector/code.mdx
ja/development/comfy-router/models/recraft/recraftv4-styles/code.mdx
ja/development/comfy-router/models/recraft/recraftv4/code.mdx
ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx
ja/development/comfy-router/quickstart.mdx
ja/development/comfy-router/reference.mdx

Simplified Chinese (`zh`)

zh/development/comfy-router/limitations.mdx
zh/development/comfy-router/models.mdx
zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx
zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx
zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx
zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx
zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx
zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx
zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx
zh/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx
zh/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx
zh/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx
zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx
zh/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx
zh/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx
zh/development/comfy-router/models/google/imagen-3-0-fast-generate-001/code.mdx
zh/development/comfy-router/models/google/imagen-3-0-generate-001/code.mdx
zh/development/comfy-router/models/google/imagen-3-0-generate-002/code.mdx
zh/development/comfy-router/models/heygen/starfish/code.mdx
zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
zh/development/comfy-router/models/kling/kling-v2-6/code.mdx
zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx
zh/development/comfy-router/models/kling/kling-v3/code.mdx
zh/development/comfy-router/models/kling/kling-video-o1/code.mdx
zh/development/comfy-router/models/recraft/recraftv2/code.mdx
zh/development/comfy-router/models/recraft/recraftv3/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-1-pro/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-1-utility/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-1-vector/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-1/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-pro/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-styles-pro/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-styles-vector/code.mdx
zh/development/comfy-router/models/recraft/recraftv4-styles/code.mdx
zh/development/comfy-router/models/recraft/recraftv4/code.mdx
zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx
zh/development/comfy-router/quickstart.mdx
zh/development/comfy-router/reference.mdx

Korean (`ko`)

ko/development/comfy-router/limitations.mdx
ko/development/comfy-router/models.mdx
ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx
ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx
ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx
ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx
ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx
ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx
ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx
ko/development/comfy-router/models/byteplus/seedream-4-0-250828/code.mdx
ko/development/comfy-router/models/byteplus/seedream-4-5-251128/code.mdx
ko/development/comfy-router/models/byteplus/seedream-5-0-260128/code.mdx
ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx
ko/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx
ko/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx
ko/development/comfy-router/models/google/imagen-3-0-fast-generate-001/code.mdx
ko/development/comfy-router/models/google/imagen-3-0-generate-001/code.mdx
ko/development/comfy-router/models/google/imagen-3-0-generate-002/code.mdx
ko/development/comfy-router/models/heygen/starfish/code.mdx
ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
ko/development/comfy-router/models/kling/kling-v2-6/code.mdx
ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx
ko/development/comfy-router/models/kling/kling-v3/code.mdx
ko/development/comfy-router/models/kling/kling-video-o1/code.mdx
ko/development/comfy-router/models/recraft/recraftv2/code.mdx
ko/development/comfy-router/models/recraft/recraftv3/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-1-pro-vector/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-1-pro/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-1-utility-pro-vector/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-1-utility-pro/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-1-utility/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-1-vector/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-1/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-pro/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-styles-pro-vector/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-styles-pro/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-styles-vector/code.mdx
ko/development/comfy-router/models/recraft/recraftv4-styles/code.mdx
ko/development/comfy-router/models/recraft/recraftv4/code.mdx
ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx
ko/development/comfy-router/quickstart.mdx
ko/development/comfy-router/reference.mdx

Local sync: npm run translate (see README — Automated translation)

mintlify · 2026-09-15T23:59:09Z

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
comfy	🟢 Ready	View Preview	Sep 18, 2026, 1:25 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

…oud@fdf7af6

mintlify Bot deployed to staging September 15, 2026 23:59 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 173610b to 5690fc7 Compare September 16, 2026 01:26

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@08ec7a1)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@e530772) Sep 16, 2026

mintlify Bot deployed to staging September 16, 2026 01:29 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 5690fc7 to 5f02f44 Compare September 16, 2026 03:33

mintlify Bot deployed to staging September 16, 2026 03:37 View deployment

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@e530772)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@1eab676) Sep 16, 2026

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 5f02f44 to 99bfb67 Compare September 16, 2026 09:36

mintlify Bot deployed to staging September 16, 2026 09:40 View deployment

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@1eab676)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@2789054) Sep 16, 2026

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 99bfb67 to d3e7a26 Compare September 16, 2026 10:43

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@2789054)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@9ddf5d1) Sep 16, 2026

mintlify Bot deployed to staging September 16, 2026 10:47 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from d3e7a26 to 3934d45 Compare September 16, 2026 12:11

mintlify Bot deployed to staging September 16, 2026 12:15 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 3934d45 to 7b4350e Compare September 16, 2026 15:37

mintlify Bot deployed to staging September 16, 2026 15:41 View deployment

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@9ddf5d1)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@e5eefb1) Sep 16, 2026

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 7b4350e to 73ec548 Compare September 16, 2026 19:06

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@e5eefb1)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@2ca009b) Sep 16, 2026

mintlify Bot deployed to staging September 16, 2026 19:09 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 73ec548 to c8d5cca Compare September 16, 2026 19:25

mintlify Bot deployed to staging September 16, 2026 19:29 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from c8d5cca to 3d5a19f Compare September 16, 2026 20:11

mintlify Bot deployed to staging September 16, 2026 20:15 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 3d5a19f to 7f2b6e1 Compare September 16, 2026 20:46

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@2ca009b)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@996a63c) Sep 16, 2026

mintlify Bot deployed to staging September 16, 2026 20:50 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 7f2b6e1 to 11816f0 Compare September 16, 2026 23:25

mintlify Bot deployed to staging September 16, 2026 23:28 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 11816f0 to f8d78b1 Compare September 17, 2026 00:58

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@996a63c)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@0131423) Sep 17, 2026

mintlify Bot deployed to staging September 17, 2026 01:01 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from f8d78b1 to d37cf6e Compare September 17, 2026 15:25

mintlify Bot deployed to staging September 17, 2026 15:29 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from d37cf6e to 8c37a2b Compare September 17, 2026 20:54

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@0131423)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@2bdc0c1) Sep 17, 2026

mintlify Bot deployed to staging September 17, 2026 20:57 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 8c37a2b to ae8cd73 Compare September 17, 2026 22:34

mintlify Bot deployed to staging September 17, 2026 22:37 View deployment

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@2bdc0c1)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@0887294) Sep 17, 2026

mintlify Bot deployed to staging September 18, 2026 00:18 View deployment

mattmillerai mentioned this pull request Sep 18, 2026

fix(code-pages): redirect the URL of every model page --prune deletes #1701

Merged

3 tasks

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 65b4bdd to c4bd89c Compare September 18, 2026 00:48

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@0887294)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@ec6587d) Sep 18, 2026

mattmillerai mentioned this pull request Sep 18, 2026

test(code-pages): make the docs.json redirect round-trip hermetic #1702

Merged

3 tasks

mintlify Bot deployed to staging September 18, 2026 00:52 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from c4bd89c to acec9cb Compare September 18, 2026 00:56

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@ec6587d)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@c4615c0) Sep 18, 2026

mintlify Bot deployed to staging September 18, 2026 01:00 View deployment

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from acec9cb to 6144ec8 Compare September 18, 2026 01:06

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@c4615c0)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@8759533) Sep 18, 2026

mintlify Bot deployed to staging September 18, 2026 01:10 View deployment

chore: sync Comfy API v2 specification and Comfy Router pages from cl…

b86e074

…oud@fdf7af6

comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 6144ec8 to b86e074 Compare September 18, 2026 01:21

comfy-pr-bot changed the title ~~chore: sync Comfy API v2 specification and Comfy Router pages (cloud@8759533)~~ chore: sync Comfy API v2 specification and Comfy Router pages (cloud@fdf7af6) Sep 18, 2026

mintlify Bot deployed to staging September 18, 2026 01:25 View deployment

mattmillerai mentioned this pull request Sep 18, 2026

ci: fail a PR that edits sync-owned Comfy Router files #1705

Merged

Navigation Menu

chore: sync Comfy API v2 specification and Comfy Router pages (cloud@fdf7af6) - #1687

chore: sync Comfy API v2 specification and Comfy Router pages (cloud@fdf7af6)#1687
comfy-pr-bot wants to merge 1 commit into
mainfrom
chore/sync-comfy-api-v2-spec

comfy-pr-bot commented Sep 15, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Sep 15, 2026 •

edited

Loading

Uh oh!

mintlify Bot commented Sep 15, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

comfy-pr-bot commented Sep 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Sep 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🌐 i18n translation sync reminder

Japanese (ja)

Simplified Chinese (zh)

Korean (ko)

Uh oh!

mintlify Bot commented Sep 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

comfy-pr-bot commented Sep 15, 2026 •

edited

Loading

github-actions Bot commented Sep 15, 2026 •

edited

Loading

Japanese (`ja`)

Simplified Chinese (`zh`)

Korean (`ko`)

mintlify Bot commented Sep 15, 2026 •

edited

Loading