HeyGen Stripe Projects API key vs how you get a Sume key
HeyGen lets an agent provision a key with stripe projects add heygen/api. Sume keys are created in the dashboard, workspace-scoped and shown once.

HeyGen documents a Stripe Projects flow where an agent runs stripe projects add heygen/api and gets a key funded to a budget you set. Sume has no equivalent flow in its docs: you create the key in the dashboard, it is workspace-scoped, and top-ups are a dashboard operation.
HeyGen steps are from its Stripe Projects page; Sume steps from API keys and Credits, read 2026-10-01.
How does the HeyGen flow work?
The agent finds heygen/api in the Stripe Projects catalog, Stripe passes the user's identity to HeyGen, a Stripe payment token funds the account up to a budget, and the returned key is written to .env. The page says the agent never sees a card number, and warns that provisioning a paid service spends real money against the budget you set.
Non-interactive use needs billing already configured and the flags --json --yes --confirm-paid-service --accept-tos.
How do I get a Sume API key?
Use the API Keys dashboard to create and manage keys for the Developer API. Keys are workspace-scoped, and the dashboard reveals the full secret only when a key is created, so store it in a secret manager right away. Sume API keys, scopes and hosts covers the header and hosts.
How does an agent pay on Sume?
Not through the API. The credits docs say the dashboard can start a Stripe-backed manual top-up when billing is configured, and that API clients should treat top-ups as dashboard operations. The public Developer API exposes balance and usage reads, not a top-up creation endpoint.
What is the practical difference?
A person has to do the key and top-up steps once.
| Step | HeyGen with Stripe Projects | Sume |
|---|---|---|
| Create a key | stripe projects add heygen/api | API Keys dashboard |
| Fund it | Stripe payment token up to a budget | Dashboard top-up |
| Where the key lands | Project .env | You store it; shown once |
| Read balance by API | Not covered on the page | Balance and usage reads |
Sources
Related posts
More in Developers
- HeyGen create template via API: Sume has video_inputs, not templates
HeyGen now creates templates over the API and binds variables by element_id. Sume has no stored template object; send ordered video_inputs on each request.
- HeyGen studio video scene limit: 50 scenes, and Sume's 4-60 s plan
HeyGen studio videos allow 50 scenes and 30 minutes per scene. Sume multi-scene video_inputs share one 4-60 second window and one resolved avatar.
- HeyGen stale_edit_version 409 vs Sume idempotency_conflict
HeyGen returns 409 stale_edit_version when a template edit is out of date. Sume's 409 is idempotency_conflict: one key reused on a different payload.
- Hookdeck passes gzip bytes unchanged: verify Sume on raw bytes
Hookdeck now forwards binary and gzip bodies byte for byte. Read the raw bytes before parsing and verify the Sume sume-v1 signature over them.
Written by Sume