Skip to content

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

Open
cloud-code-bot[bot] wants to merge 1 commit into
mainfrom
chore/sync-comfy-api-v2-spec
Open

cloud-code-bot[bot] wants to merge 1 commit into
mainfrom
chore/sync-comfy-api-v2-spec

Conversation

@cloud-code-bot

@cloud-code-bot cloud-code-bot Bot commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

Automated sync of the public Comfy API v2 and Comfy Router specifications used by the generated API references, and of the Comfy Router API pages generated from the Comfy API contract. Source: cloud@b3a28ce1.

router-openapi.yaml is the public Comfy Router contract, projected from the same upstream contract the Router pages are generated from and the same projection the Router SDKs vendor (the Python and Swift copies byte-for-byte; the TypeScript SDK reformats its copy with oxfmt). It is GENERATED - edit the upstream contract, not this copy. If this is the first sync that carries it, it renders nothing until this repository gives it an openapi: navigation entry.

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, development/comfy-router/higgsfield-byok.mdx and development/comfy-router/litellm.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.

development/comfy-router/pricing.mdx is NOT part of this sync: it is GENERATED in this repository by bun run router-pricing:gen from router-pricing/metronome-rates.json and the model pages, and this sync refuses to change it. To change the page, edit its generator or rate snapshot here.

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. When this repository's DOCS_SYNC_AUTOMERGE variable is true, .github/workflows/sync-pr-automerge.yml squash-merges it once every check has finished green; otherwise it waits for human review.

@coderabbitai

coderabbitai Bot commented Nov 3, 2026 •

Copy link
Copy Markdown

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: 9e2ef503-52b4-4e8b-9da7-a8148b6fd897

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Tip

🎯 Customize your risk assessments

Guide how CodeRabbit assesses merge risk and security architecture risk. Highlight sensitive changes and explain your security boundaries using Merge Risk Instructions and Security Risk Instructions in your review settings. Security architecture risk assessments require the Advanced plan or above.

✅ Automatic approvals, with your rules

Let CodeRabbit approve pull requests once required threads are resolved, pre-merge checks pass, and your risk limits are met. Enable Automatic approvals in review settings, with overrides for teams or file paths.

@github-actions

github-actions Bot commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

🌐 i18n translation sync check

English docs changed in this PR. 204 files in 4 languages may not be synced yet. The automated translation workflow handles these updates. Expand a language to see the files.

Japanese (ja): 51 files
  • ja/development/comfy-router/limitations.mdx
  • ja/development/comfy-router/models.mdx
  • ja/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx
  • ja/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx
  • ja/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx
  • ja/development/comfy-router/models/kling/kling-4-0/code.mdx
  • ja/development/comfy-router/models/luma/photon-1/code.mdx
  • ja/development/comfy-router/models/luma/photon-flash-1/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
  • ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx
  • ja/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx
  • ja/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx
  • ja/development/comfy-router/models/stability/control-sketch/code.mdx
  • ja/development/comfy-router/models/stability/control-structure/code.mdx
  • ja/development/comfy-router/models/stability/control-style-transfer/code.mdx
  • ja/development/comfy-router/models/stability/control-style/code.mdx
  • ja/development/comfy-router/models/stability/generate-core/code.mdx
  • ja/development/comfy-router/models/stability/generate-ultra/code.mdx
  • ja/development/comfy-router/models/stability/sd3-5-flash/code.mdx
  • ja/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx
  • ja/development/comfy-router/models/stability/sd3-5-large/code.mdx
  • ja/development/comfy-router/models/stability/sd3-5-medium/code.mdx
  • ja/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx
  • ja/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx
  • ja/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx
  • ja/development/comfy-router/models/stability/stable-fast-3d/code.mdx
  • ja/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx
  • ja/development/comfy-router/reference.mdx
  • ja/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx
  • ja/development/comfy-router/models/kling/kling-4-0/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • ja/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
  • ja/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx
  • ja/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx
  • ja/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx
  • ja/development/comfy-router/models/stability/control-sketch/code.mdx
  • ja/development/comfy-router/models/stability/control-structure/code.mdx
  • ja/development/comfy-router/models/stability/control-style-transfer/code.mdx
  • ja/development/comfy-router/models/stability/control-style/code.mdx
  • ja/development/comfy-router/models/stability/generate-core/code.mdx
  • ja/development/comfy-router/models/stability/generate-ultra/code.mdx
  • ja/development/comfy-router/models/stability/sd3-5-flash/code.mdx
  • ja/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx
  • ja/development/comfy-router/models/stability/sd3-5-large/code.mdx
  • ja/development/comfy-router/models/stability/sd3-5-medium/code.mdx
  • ja/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx
  • ja/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx
  • ja/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx
  • ja/development/comfy-router/models/stability/stable-fast-3d/code.mdx
  • ja/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx
Simplified Chinese (zh): 51 files
  • zh/development/comfy-router/limitations.mdx
  • zh/development/comfy-router/models.mdx
  • zh/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx
  • zh/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx
  • zh/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx
  • zh/development/comfy-router/models/kling/kling-4-0/code.mdx
  • zh/development/comfy-router/models/luma/photon-1/code.mdx
  • zh/development/comfy-router/models/luma/photon-flash-1/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
  • zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx
  • zh/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx
  • zh/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx
  • zh/development/comfy-router/models/stability/control-sketch/code.mdx
  • zh/development/comfy-router/models/stability/control-structure/code.mdx
  • zh/development/comfy-router/models/stability/control-style-transfer/code.mdx
  • zh/development/comfy-router/models/stability/control-style/code.mdx
  • zh/development/comfy-router/models/stability/generate-core/code.mdx
  • zh/development/comfy-router/models/stability/generate-ultra/code.mdx
  • zh/development/comfy-router/models/stability/sd3-5-flash/code.mdx
  • zh/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx
  • zh/development/comfy-router/models/stability/sd3-5-large/code.mdx
  • zh/development/comfy-router/models/stability/sd3-5-medium/code.mdx
  • zh/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx
  • zh/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx
  • zh/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx
  • zh/development/comfy-router/models/stability/stable-fast-3d/code.mdx
  • zh/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx
  • zh/development/comfy-router/reference.mdx
  • zh/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx
  • zh/development/comfy-router/models/kling/kling-4-0/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • zh/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
  • zh/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx
  • zh/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx
  • zh/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx
  • zh/development/comfy-router/models/stability/control-sketch/code.mdx
  • zh/development/comfy-router/models/stability/control-structure/code.mdx
  • zh/development/comfy-router/models/stability/control-style-transfer/code.mdx
  • zh/development/comfy-router/models/stability/control-style/code.mdx
  • zh/development/comfy-router/models/stability/generate-core/code.mdx
  • zh/development/comfy-router/models/stability/generate-ultra/code.mdx
  • zh/development/comfy-router/models/stability/sd3-5-flash/code.mdx
  • zh/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx
  • zh/development/comfy-router/models/stability/sd3-5-large/code.mdx
  • zh/development/comfy-router/models/stability/sd3-5-medium/code.mdx
  • zh/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx
  • zh/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx
  • zh/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx
  • zh/development/comfy-router/models/stability/stable-fast-3d/code.mdx
  • zh/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx
Korean (ko): 51 files
  • ko/development/comfy-router/limitations.mdx
  • ko/development/comfy-router/models.mdx
  • ko/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx
  • ko/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx
  • ko/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx
  • ko/development/comfy-router/models/kling/kling-4-0/code.mdx
  • ko/development/comfy-router/models/luma/photon-1/code.mdx
  • ko/development/comfy-router/models/luma/photon-flash-1/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
  • ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx
  • ko/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx
  • ko/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx
  • ko/development/comfy-router/models/stability/control-sketch/code.mdx
  • ko/development/comfy-router/models/stability/control-structure/code.mdx
  • ko/development/comfy-router/models/stability/control-style-transfer/code.mdx
  • ko/development/comfy-router/models/stability/control-style/code.mdx
  • ko/development/comfy-router/models/stability/generate-core/code.mdx
  • ko/development/comfy-router/models/stability/generate-ultra/code.mdx
  • ko/development/comfy-router/models/stability/sd3-5-flash/code.mdx
  • ko/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx
  • ko/development/comfy-router/models/stability/sd3-5-large/code.mdx
  • ko/development/comfy-router/models/stability/sd3-5-medium/code.mdx
  • ko/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx
  • ko/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx
  • ko/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx
  • ko/development/comfy-router/models/stability/stable-fast-3d/code.mdx
  • ko/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx
  • ko/development/comfy-router/reference.mdx
  • ko/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx
  • ko/development/comfy-router/models/kling/kling-4-0/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • ko/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
  • ko/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx
  • ko/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx
  • ko/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx
  • ko/development/comfy-router/models/stability/control-sketch/code.mdx
  • ko/development/comfy-router/models/stability/control-structure/code.mdx
  • ko/development/comfy-router/models/stability/control-style-transfer/code.mdx
  • ko/development/comfy-router/models/stability/control-style/code.mdx
  • ko/development/comfy-router/models/stability/generate-core/code.mdx
  • ko/development/comfy-router/models/stability/generate-ultra/code.mdx
  • ko/development/comfy-router/models/stability/sd3-5-flash/code.mdx
  • ko/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx
  • ko/development/comfy-router/models/stability/sd3-5-large/code.mdx
  • ko/development/comfy-router/models/stability/sd3-5-medium/code.mdx
  • ko/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx
  • ko/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx
  • ko/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx
  • ko/development/comfy-router/models/stability/stable-fast-3d/code.mdx
  • ko/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx
Spanish (es): 51 files
  • es/development/comfy-router/limitations.mdx
  • es/development/comfy-router/models.mdx
  • es/development/comfy-router/models/gemini-interactions/gemini-omni-1-1-flash/code.mdx
  • es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx
  • es/development/comfy-router/models/gemini-interactions/gemini-omni-flash-preview/code.mdx
  • es/development/comfy-router/models/kling/kling-4-0/code.mdx
  • es/development/comfy-router/models/luma/photon-1/code.mdx
  • es/development/comfy-router/models/luma/photon-flash-1/code.mdx
  • es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
  • es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx
  • es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx
  • es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx
  • es/development/comfy-router/models/stability/control-sketch/code.mdx
  • es/development/comfy-router/models/stability/control-structure/code.mdx
  • es/development/comfy-router/models/stability/control-style-transfer/code.mdx
  • es/development/comfy-router/models/stability/control-style/code.mdx
  • es/development/comfy-router/models/stability/generate-core/code.mdx
  • es/development/comfy-router/models/stability/generate-ultra/code.mdx
  • es/development/comfy-router/models/stability/sd3-5-flash/code.mdx
  • es/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx
  • es/development/comfy-router/models/stability/sd3-5-large/code.mdx
  • es/development/comfy-router/models/stability/sd3-5-medium/code.mdx
  • es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx
  • es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx
  • es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx
  • es/development/comfy-router/models/stability/stable-fast-3d/code.mdx
  • es/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx
  • es/development/comfy-router/reference.mdx
  • es/development/comfy-router/models/gemini-interactions/gemini-omni-1-2-flash/code.mdx
  • es/development/comfy-router/models/kling/kling-4-0/code.mdx
  • es/development/comfy-router/models/openai/gpt-image-2-6-flare/code.mdx
  • es/development/comfy-router/models/openai/gpt-image-2-6-sunburst/code.mdx
  • es/development/comfy-router/models/pika/pika-h3-flex-image-to-video/code.mdx
  • es/development/comfy-router/models/pika/pika-h3-flex-reference-to-video/code.mdx
  • es/development/comfy-router/models/pika/pika-h3-flex-text-to-video/code.mdx
  • es/development/comfy-router/models/stability/control-sketch/code.mdx
  • es/development/comfy-router/models/stability/control-structure/code.mdx
  • es/development/comfy-router/models/stability/control-style-transfer/code.mdx
  • es/development/comfy-router/models/stability/control-style/code.mdx
  • es/development/comfy-router/models/stability/generate-core/code.mdx
  • es/development/comfy-router/models/stability/generate-ultra/code.mdx
  • es/development/comfy-router/models/stability/sd3-5-flash/code.mdx
  • es/development/comfy-router/models/stability/sd3-5-large-turbo/code.mdx
  • es/development/comfy-router/models/stability/sd3-5-large/code.mdx
  • es/development/comfy-router/models/stability/sd3-5-medium/code.mdx
  • es/development/comfy-router/models/stability/sdxl-1-0-image-to-image/code.mdx
  • es/development/comfy-router/models/stability/sdxl-1-0-masking/code.mdx
  • es/development/comfy-router/models/stability/sdxl-1-0-text-to-image/code.mdx
  • es/development/comfy-router/models/stability/stable-fast-3d/code.mdx
  • es/development/comfy-router/models/stability/stable-point-aware-3d/code.mdx

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

@mintlify

mintlify Bot commented Nov 3, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
comfy 🟢 Ready View Preview Nov 7, 2026, 8:11 PM

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

@mattmillerai

Copy link
Copy Markdown
Member

CI blocker: Pika H3 Flex routes have no published Router rates

code-pages (router-pricing:check) and snippet-script-tests ("Router pricing coverage guard > publishes every Pika route") fail for the same reason. This sync adds pika/pika-h3-flex-text-to-video, pika/pika-h3-flex-image-to-video and pika/pika-h3-flex-reference-to-video to the Router catalog, and router-pricing/metronome-rates.json has no rates for any of them. Pika routes can't be waived, so the guard requires published rates.

I haven't added rates. The upstream source, metronome/pika/README.md at cloud@bd0c760f, lists the intended 1.43x per-resolution prices (lines 71-73). It also says "The three H3 Flex rows are not yet applied to either card", and the starting_at instant may change. This file mirrors rates that are applied on the card, so publishing these prices now would show a rate the card doesn't yet bill.

What unblocks this: the Router owner applies the H3 Flex rows to the prod card (or confirms the README prices and instant are final). Then the rates can be added as a supplemental source pinned to that README, as the Pika audio rates were in #2233.

@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from 77b3295 to 24be06c Compare November 4, 2026 01:09
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@bd0c760f) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@d52152ab) Nov 4, 2026
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@d52152ab) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@103489bd) Nov 4, 2026
@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from 31916f0 to c1962d0 Compare November 4, 2026 02:32
@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from f092cac to 98935f9 Compare November 4, 2026 05:18
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@103489bd) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@d3dda5ce) Nov 4, 2026
@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from 234571d to 5434859 Compare November 4, 2026 08:06
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@d3dda5ce) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@da62b595) Nov 4, 2026
@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from 1d034c5 to 524d037 Compare November 4, 2026 08:37
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@da62b595) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@d1827282) Nov 4, 2026
@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from 941e7d2 to a0179cd Compare November 4, 2026 19:18
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@d1827282) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@5c2cbba3) Nov 4, 2026
@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from cce0afd to a8885a2 Compare November 6, 2026 02:18
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@5c2cbba3) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@9a33c500) Nov 6, 2026
@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from c90f446 to efe89b3 Compare November 6, 2026 02:39
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@9a33c500) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@f17711fa) Nov 6, 2026
@mattmillerai

Copy link
Copy Markdown
Member

CI update for cloud@f17711fa: #2264 covers 16 of the 19 unpriced routes. Three routes still need rates.

code-pages (router-pricing:check) and snippet-script-tests fail on head 8b1c63f0 (run 42151714178). This sync adds 19 Router routes that have no row in router-pricing/metronome-rates.json and no waiver.

I merged #2264 (c402935d) into this head locally and re-ran the checks:

All three are billed upstream, so they are live routes and can't be waived. The cloud@f17711fa card has rows for them in services/comfy-api/scripts/metronome/openai/rates/rates.json (lines ~1341-1391) and services/comfy-api/scripts/metronome/kling/rates/rates.json (line ~360). Prod embargoed_models holds only kling/kling-4.0-flash, not kling/kling-4.0.

What unblocks this: stage rates for these three routes on main, either in #2264 or in a follow-up that uses the same staged-rate mechanism. Then merge it, and re-sync or merge main into this branch. I haven't pushed anything to this sync branch.

@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from 8b1c63f to 509c798 Compare November 6, 2026 04:26
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@f17711fa) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@f90e6627) Nov 6, 2026
@mattmillerai

Copy link
Copy Markdown
Member

CI update for cloud@f90e6627: four routes still need rates after #2264.

code-pages (router-pricing:check) and snippet-script-tests fail on head 08dc4cb6 (run 42162614138). This sync adds 20 Router routes that have no row in router-pricing/metronome-rates.json and no waiver.

I merged #2264 (c402935d) into this head locally and re-ran:

What unblocks this: stage rates for these four routes on main (in #2264 or a follow-up), merge it, then re-sync or merge main into this branch. I haven't pushed anything to this sync branch.

@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from 08dc4cb to 62012ac Compare November 6, 2026 06:21
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@f90e6627) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@1846b1cd) Nov 6, 2026
@mattmillerai

Copy link
Copy Markdown
Member

CI update for cloud@1846b1cd: there is a new blocker, and staging the four rates will not clear it alone.

code-pages, snippet-script-tests and translate all fail on head 62012ace (run 42173885644, run 42173885977) with the same error:

router-pricing/metronome-rates.json: Router model IDs are absent from the current catalog: kling/videos-video-extend

This sync withdraws that route (cloud#18382), but its rate row is still in the base rates list. code-pages:check itself passes (244 pages fresh). The job fails at router-pricing:check. This error throws first, so it hides the missing-rate errors from my earlier comments.

#2264 does not fix this. Its staging tolerance covers only cloud-cited supplemental_sources rows, so the same error remains on this head merged with #2264.

The row can't simply be deleted first. I tested each order locally:

Tree Change Result
main Delete the row Fails: the route's page is still listed, so it would render "Not published"
This head + #2264 Delete the row, add a waiver Fails: stale waiver, because the route is no longer listed
main + #2264 Move the row to a cloud-cited supplemental source gen-router-pricing.ts --check passes
This head + #2264 Move the row to a cloud-cited supplemental source Kling error is gone, gen-router-pricing.test.ts is 42 pass, 0 fail, and only the four routes below still fail

What unblocks this, all on main (in #2264 or a follow-up):

  1. Move the kling/videos-video-extend row into a supplemental source citing cloud#18382, then delete it once this sync has landed. It is a retired route, so it should not stay marked as staged.
  2. Stage rates for the four routes that are still unpriced. All four have rows on the card at cloud@1846b1cd:
    • openai/gpt-image-2.6-flare
    • openai/gpt-image-2.6-sunburst
    • kling/kling-4.0
    • stability/sd3.5-flash
  3. Update the hardcoded rate counts in gen-router-pricing.test.ts if the row count changes.
  4. Re-sync, or merge main into this branch.

I haven't run the full check with all four rates in place, so a later failure is still possible. The English and localized pricing pages also need regenerating on this branch.

I haven't pushed anything to this sync branch.

@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from 62012ac to bf0c7c0 Compare November 6, 2026 18:35
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@1846b1cd) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@a8e3f094) Nov 6, 2026
@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from bf0c7c0 to 300ab4b Compare November 7, 2026 01:18
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@a8e3f094) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@51285b3f) Nov 7, 2026
@cloud-code-bot
cloud-code-bot Bot force-pushed the chore/sync-comfy-api-v2-spec branch from 300ab4b to 07eedcd Compare November 7, 2026 20:07
@cloud-code-bot cloud-code-bot Bot changed the title chore: sync Comfy API v2 specification and Comfy Router pages (cloud@51285b3f) chore: sync Comfy API v2 specification and Comfy Router pages (cloud@b3a28ce1) Nov 7, 2026
@mattmillerai

Copy link
Copy Markdown
Member

CI update for cloud@b3a28ce1: merged with #2264, only two Stability 3D routes still need rates.

code-pages, snippet-script-tests and translate fail on head 07eedcd0 (run 42409529302, run 42409529190) with Router model IDs are absent from the current catalog: kling/videos-video-extend. That error is thrown first and hides the missing-rate errors.

I merged #2264 at a4e90c6d into this head locally and re-ran:

  • bun test ./.github/scripts/snippets/: 143 pass, 0 fail.
  • gen-router-pricing.ts --check: the retired Kling route is now skipped, and the GPT Image 2.6, Kling 4.0 and sd3.5-flash routes are priced. Two routes still fail as "Not published":
    • stability/stable-fast-3d
    • stability/stable-point-aware-3d

Upstream, both are served (services/comfy-api/server/middleware/stability_3d.go) and documented in services/comfy-api/scripts/metronome/router/stability/README.md, so a waiver doesn't look right.

What unblocks this: stage rates for those two routes in #2264, merge it, then re-sync or merge main into this branch and regenerate the pricing pages. I haven't pushed anything to this sync branch.

This branch was successfully deployed

1 active deployment
staging — 07eedcd0 Deployed Nov 7, 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