Skip to content

chore: sync Comfy API v2 specification and Comfy Router pages (cloud@60dbd49) - #1765

Merged
mattmillerai merged 1 commit into
mainfrom
chore/sync-comfy-api-v2-spec
Sep 25, 2026
Merged

mattmillerai merged 1 commit into
mainfrom
chore/sync-comfy-api-v2-spec

Conversation

@comfy-pr-bot

@comfy-pr-bot comfy-pr-bot commented Sep 23, 2026 •

Copy link
Copy Markdown
Member

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@60dbd49.

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, development/comfy-router/limitations.mdx
and development/comfy-router/higgsfield-byok.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 model index
development/comfy-router/models.mdx, the serving-provider index
development/comfy-router/providers.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, and
providers.mdx exists only while some model publishes an
x-comfy-router-alt-providers leg.

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.

@mintlify

mintlify Bot commented Sep 23, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
comfy 🟢 Ready View Preview Sep 25, 2026, 5:47 AM

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

@github-actions

github-actions Bot commented Sep 23, 2026 •

Copy link
Copy Markdown

🌐 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/higgsfield-byok.mdx
  • 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-flash-260915/code.mdx
  • ja/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx
  • ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
  • ja/development/comfy-router/models/openai/gpt-6-luna/code.mdx
  • ja/development/comfy-router/models/openai/gpt-6-sol/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-1-5/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-1/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-2/code.mdx
  • ja/development/comfy-router/models/runway/gen4-turbo/code.mdx
  • ja/development/comfy-router/quickstart.mdx
  • ja/development/comfy-router/reference.mdx
  • ja/development/comfy-router/higgsfield-byok.mdx
  • ja/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx
  • ja/development/comfy-router/models/openai/gpt-6-luna/code.mdx
  • ja/development/comfy-router/models/openai/gpt-6-sol/code.mdx

Simplified Chinese (zh)

  • zh/development/comfy-router/higgsfield-byok.mdx
  • 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-flash-260915/code.mdx
  • zh/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx
  • zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
  • zh/development/comfy-router/models/openai/gpt-6-luna/code.mdx
  • zh/development/comfy-router/models/openai/gpt-6-sol/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-1-5/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-1/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-2/code.mdx
  • zh/development/comfy-router/models/runway/gen4-turbo/code.mdx
  • zh/development/comfy-router/quickstart.mdx
  • zh/development/comfy-router/reference.mdx
  • zh/development/comfy-router/higgsfield-byok.mdx
  • zh/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx
  • zh/development/comfy-router/models/openai/gpt-6-luna/code.mdx
  • zh/development/comfy-router/models/openai/gpt-6-sol/code.mdx

Korean (ko)

  • ko/development/comfy-router/higgsfield-byok.mdx
  • 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-flash-260915/code.mdx
  • ko/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code.mdx
  • ko/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
  • ko/development/comfy-router/models/openai/gpt-6-luna/code.mdx
  • ko/development/comfy-router/models/openai/gpt-6-sol/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-1-5/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-1/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-2-5-flare/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-2-5-sunburst/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-2/code.mdx
  • ko/development/comfy-router/models/runway/gen4-turbo/code.mdx
  • ko/development/comfy-router/quickstart.mdx
  • ko/development/comfy-router/reference.mdx
  • ko/development/comfy-router/higgsfield-byok.mdx
  • ko/development/comfy-router/models/byteplus/seedream-5-0-flash-260915/code.mdx
  • ko/development/comfy-router/models/openai/gpt-6-luna/code.mdx
  • ko/development/comfy-router/models/openai/gpt-6-sol/code.mdx

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

@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 1c98ae8 to 1079443 Compare September 23, 2026 07:41
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@ff27017) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@9cf09f9) Sep 23, 2026
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@9cf09f9) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@c5c47a8) Sep 23, 2026
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 1079443 to fe97554 Compare September 23, 2026 08:56
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@c5c47a8) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@0b57e74) Sep 23, 2026
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from fe97554 to b2713aa Compare September 23, 2026 09:02
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from b2713aa to 318da6e Compare September 23, 2026 17:35
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@0b57e74) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@d9be33b) Sep 23, 2026
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch 2 times, most recently from 318da6e to f6392df Compare September 23, 2026 22:42
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@d9be33b) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@95ccabc) Sep 23, 2026
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from f6392df to 9110230 Compare September 24, 2026 01:44
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@95ccabc) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@af38ded) Sep 24, 2026
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 9110230 to 358d580 Compare September 24, 2026 02:07
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@af38ded) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@2b28bdf) Sep 24, 2026
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 358d580 to 2142544 Compare September 24, 2026 02:52
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@2b28bdf) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@7ad38b3) Sep 24, 2026
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 2142544 to cef594c Compare September 24, 2026 21:34
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from cef594c to 549c087 Compare September 24, 2026 22:14
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@7ad38b3) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@08cf510) Sep 24, 2026
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 549c087 to bfeedb2 Compare September 24, 2026 23:07
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@08cf510) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@b3d4674) Sep 24, 2026
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from bfeedb2 to 7921746 Compare September 25, 2026 05:44
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@b3d4674) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@f2e4330) Sep 25, 2026
@comfy-pr-bot
comfy-pr-bot force-pushed the chore/sync-comfy-api-v2-spec branch from 7921746 to 6da14c5 Compare September 25, 2026 06:02
@comfy-pr-bot comfy-pr-bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@f2e4330) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@60dbd49) Sep 25, 2026
@mattmillerai
mattmillerai merged commit 7f225f5 into main Sep 25, 2026
17 checks passed
@github-actions
github-actions Bot deleted the chore/sync-comfy-api-v2-spec branch September 25, 2026 06:05

This branch was successfully deployed

1 active deployment
staging — 6da14c5e Deployed Sep 25, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants