Skip to content

docs(send-to-guide): enhance turns are free; render is the paid step - #2827

Merged
somanshreddy merged 2 commits into
mainfrom
07-27-fix_send_to_guide_pricing
Jul 27, 2026
Merged

somanshreddy merged 2 commits into
mainfrom
07-27-fix_send_to_guide_pricing

Conversation

@somanshreddy

Copy link
Copy Markdown
Contributor

What

One-line correction to the Send-to authoring guide's pricing summary. The guide labeled Enhance as "the paid step"; the shipped model is that import and enhance turns are free, and only the final render is charged (a monthly free-render credit, then per-minute after).

Before / after

3. Enhance in HyperFrames ... HeyGen media. This is the paid step.
4. Render ... produces the MP4.

becomes

3. Enhance in HyperFrames ... HeyGen media. Enhance turns are free too.
4. Render ... produces the MP4. This is the paid step (a monthly free-render credit, then charged).

Why

Claude Design fetches this guide (via the get-guide tool) to author Send-to compositions, so the pricing framing it reads should match reality. This aligns the guide with the same fix applied across the internal Send-to docs.

The shipped pricing model is import + enhance turns free, only the final
render charged (a monthly free-render credit, then per-minute). The guide
labeled enhance as 'the paid step', which misstates the model to the
authoring agent. Move the paid label to Render.
@mintlify

mintlify Bot commented Jul 27, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
hyperframes 🟢 Ready View Preview Jul 27, 2026, 7:13 AM

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

@mintlify

mintlify Bot commented Jul 27, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
hyperframes 🟡 Building – Jul 27, 2026, 7:12 AM

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

@miguel-heygen miguel-heygen left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Blocking — the corrected billing sentence is still not the shipped contract. The current server-side source of truth distinguishes tiers: FREE users receive 3 renders per month and are blocked when that allotment is exhausted; paid tiers have no monthly free-render step and are billed 20 credits/minute at render completion (magic_edit/logic/usage_limits.py). “A monthly free-render credit, then charged” reads as one universal free render followed by charging, so Claude would still be taught the wrong boundary. Please state the tiered contract explicitly (for example: “Free accounts receive 3 renders per month; paid plans are charged 20 credits per rendered minute”).

Blocking — pin this new LLM-facing invariant in the existing semantic contract test. packages/cli/src/commands/claude-design/sendToGuideContract.test.ts exists specifically because wording regressions in this guide silently steer Claude incorrectly. Add a concept-level assertion that the guide identifies Enhance as free and Render as the paid/billed step, plus a negative assertion that the retired “Enhance … paid step” wording cannot return. This keeps the correction from becoming stale again while avoiding an exact-sentence snapshot.

Everything else is clean at exact head bca07d576e: one guide-only 2+/2- delta, signed commit, docs validation and all applicable checks green.

…t in the guide test

Address review: the pricing line must teach Claude the real tiered contract,
not a single universal free render. Per heygen-server usage_limits.py: FREE
accounts get 3 renders/month (then blocked, not billed); paid plans are charged
20 credits per rendered minute at completion. Enhance turns are free.

Also pin the invariant in sendToGuideContract.test.ts: assert Enhance=free /
Render=paid + the tiered figures, and a negative assertion blocking the retired
'Enhance ... paid step' wording from returning.
@somanshreddy

Copy link
Copy Markdown
Contributor Author

Both addressed in 80eeb2f26:

Tiered contract. Reworded to: "Render is the paid step: free accounts get 3 renders per month; paid plans are charged 20 credits per rendered minute." Confirmed against magic_edit/logic/usage_limits.py — FREE gets 3 renders/month (reserved at submission, blocked when exhausted, not billed); paid is 20 credits/rendered-minute at completion. Dropped the misleading "monthly free-render credit, then charged" universal framing.

Test pin. Added to sendToGuideContract.test.ts: a positive assertion that the guide marks Enhance free and Render the paid step plus the tiered figures (3 renders/month, 20 credits/rendered-minute), and a negative assertion that the retired "Enhance … paid step" wording cannot return — concept-level, no exact-sentence snapshot.

@miguel-heygen miguel-heygen left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Re-review at exact head 80eeb2f26c8dff1677c7f6d115fb970b446d2cc4 — both blockers are resolved.

The guide now states the shipped tiered contract precisely: Enhance turns are free; Render is the paid step; free accounts receive 3 renders/month; paid plans are charged 20 credits/rendered minute. The existing LLM-facing semantic contract test now pins those concepts independently and rejects the retired Enhance-as-paid wording without coupling to the full sentence. The two-file delta is clean and scoped; docs validation, build, lint, typecheck, format, producer/SDK/runtime-contract lanes are green, with only unrelated broad/Windows smoke lanes still settling and no failures.

Verdict: APPROVE
Reasoning: The pricing boundary and regression contract now match the source of truth and close both requested changes without widening scope.

— Magi

@somanshreddy
somanshreddy merged commit e3636db into main Jul 27, 2026
47 checks passed
@somanshreddy
somanshreddy deleted the 07-27-fix_send_to_guide_pricing branch July 27, 2026 19:48
dahans-msft2 pushed a commit to dahans-msft2/hyperframes that referenced this pull request Aug 6, 2026
…eygen-com#2827)

* docs(send-to-guide): enhance turns are free; render is the paid step

The shipped pricing model is import + enhance turns free, only the final
render charged (a monthly free-render credit, then per-minute). The guide
labeled enhance as 'the paid step', which misstates the model to the
authoring agent. Move the paid label to Render.

* docs(send-to-guide): state the tiered render billing contract + pin it in the guide test

Address review: the pricing line must teach Claude the real tiered contract,
not a single universal free render. Per heygen-server usage_limits.py: FREE
accounts get 3 renders/month (then blocked, not billed); paid plans are charged
20 credits per rendered minute at completion. Enhance turns are free.

Also pin the invariant in sendToGuideContract.test.ts: assert Enhance=free /
Render=paid + the tiered figures, and a negative assertion blocking the retired
'Enhance ... paid step' wording from returning.

This branch was successfully deployed

1 active deployment
staging - docs — 80eeb2f2 Deployed Jul 27, 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