WWevi Developers

API Keys & Security

Environments, key security, hashing, and rate limits.

API Keys & Security

Wevi API keys provide secure programmatic access to Wevi’s REST endpoints and Model Context Protocol (MCP) server.


Environments

Wevi provides two distinct execution environments:

1. Live (wevi_live_...)

  • Produces production-grade video renders. Quality follows your account: free accounts export 720p with a watermark, and asking them for 1080p or 4K returns 403 with code: "EXPORT_QUALITY_LOCKED". Once you buy any credit pack, or have a paid plan, exports go up to 4K without the watermark (paidAccess: true in GET /billing/credits).
  • Spends credits from the same balance as the studio. Your plan's allowance is used first (rolled-over credits before the rest), then purchased credits.
  • Used for customer-facing video generation, Zapier bots, and production apps.

2. Test (wevi_test_...)

  • Every scene render carries the Wevi watermark, regardless of plan.
  • Exports are capped at 720p (a higher quality is accepted but downgraded).
  • Renders and exports never spend credits, but each key has a hard daily sandbox allowance (below).
  • Projects created with a test key stay sandboxed even when opened later in the web app; sandbox exports are labelled "(Sandbox)" and carry sandbox: true.
  • Ideal for local integration testing, CI/CD automated test pipelines, and MCP experimentation.

Sandbox daily allowance

LimitPer test keyResets
Scene renders20 / day00:00 UTC
Video exports5 / day00:00 UTC
Scenes per project4—

Unchanged scenes are reused between publishes and do not count again. When a cap is hit the API returns 429 with limit, used, requested and resetsAt, and the MCP tool relays that message. Switch to a wevi_live_ key for production volume.


Credits

Credits are Wevi's one currency. You spend them wherever Wevi does work for you: in the studio (scene renders and exports), by the studio agent, and through API keys and MCP connectors. There is no separate API bill.

Prices, plan allowances and per-action costs are set by Wevi and can change, so this page does not list numbers. The current ones always come back from:

  • GET /billing/pricing (no sign-in): plans (each plan's api_credits feature is its credit allowance), packs, costs (credits per action) and rules (the free video length, rollover, browser minutes).
  • GET /billing/credits and the wevi_get_credits MCP tool: your balance, paidAccess, the per-action costs, and this key's monthly cap.

What costs credits

ActionCharged
Scene render: a new scene, or one changed since its last renderPer scene (costs.SCENE_RENDER)
ExportPer export, more at higher quality (costs.EXPORT_720P, EXPORT_1080P, EXPORT_4K)
Storyboard draft, API or MCP (POST /ai/storyboard/draft)Per draft (costs.STORYBOARD_DRAFT)
Page capture, API or MCP (POST /browse/capture, scene auto-capture)Per capture (costs.UI_CAPTURE)
Live browser session, API or MCPFree for the first rules.browseFreeMinutes, then per started block of rules.browseBlockMinutes
Studio agent: reading the product and planning the storyboardPer video (costs.AGENT_PLAN)
Creating a project, re-picking captured componentsFree

Re-publishing a project re-renders only scenes that changed, and only those are charged. A scene rendered again only to add or remove the watermark (after you buy a pack, for example) is not charged again.

Sandbox keys (wevi_test_…) never spend credits. Their renders are watermarked, capped at 720p and limited per day (see Sandbox daily allowance).

Studio agent videos

  • The agent shows the video's price with the storyboard.
  • Approving the storyboard sets that estimate aside. If your balance is short, you top up before the run starts, never partway.
  • You are never charged more than the estimate shown. Wevi absorbs any overrun.
  • Re-renders the agent makes to fix its own work are free.
  • A change you ask for costs its re-rendered scenes, plus the export.

Free accounts and plans

  • Free ("Your first video free"): a one-time credit grant, not monthly. Free videos run up to the free length (rules.freeVideoMaxSeconds) and export at 720p with a watermark.
  • Paid plans add a monthly allowance. Unused monthly credits roll over for rules.rolloverMonths month(s), up to one month's allowance, and rolled-over credits are spent first.
  • Enterprise: unlimited.

The plans on sale, their prices and allowances are on the pricing page in the app and in plans from GET /billing/pricing.

Team seats

The Team plan puts several people, the owner included, on one plan and one balance; the number of seats is the plan's team_seats feature. The owner invites people by email from Profile → Team in the app; whoever accepts with the invited address takes a seat. Members:

  • use the Team plan's features: no watermark, 1080p and 4K, longer videos, their own music and voice;
  • spend the team's shared credits, from the studio, the studio agent, and their own API keys and connectors;
  • keep their own projects, brands and API keys.

Only the owner buys credits and manages billing. A member's attempt to buy a pack is refused with 403 and code: "TEAM_MEMBER_BILLING". The credit history names which member spent what.

Credit packs

Packs are the main way to buy credits. Buying any pack unlocks exports without the watermark, 1080p and 4K exports, longer videos, and choosing your own music and voice. Purchased credits never expire. The packs on sale and their prices are packs in GET /billing/pricing and GET /billing/credits.

Spending order

  1. Your plan allowance, rolled-over credits first.
  2. Then purchased credits.

Credits set aside for a studio agent video in progress (held) are not available for anything else.

When credits run out

The API returns 402 Payment Required. Every error comes in the same envelope, with the details under error:

{
  "success": false,
  "error": {
    "message": "This needs 3 credits but 1 is available. Buy a credit pack or upgrade your plan at https://app.wevi.ai/app/profile?id=billing&topup=1.",
    "statusCode": 402,
    "code": "INSUFFICIENT_CREDITS",
    "creditsRequired": 3,
    "creditsAvailable": 1,
    "creditsHeld": 0,
    "planRemaining": 1,
    "purchasedBalance": 0,
    "topUpUrl": "https://app.wevi.ai/app/profile?id=billing&topup=1"
  },
  "timestamp": "2026-10-14T12:00:00.000Z",
  "path": "/api/v2/projects/PROJECT_ID/publish"
}

If an API key has its own monthly cap and reaches it, the API returns 402 with code: "KEY_MONTHLY_CAP". Raise or remove the cap on the API Keys & MCP page, or use another key.

A free account whose video runs past the free length gets 403 Forbidden, with the limit and the video's length:

{
  "success": false,
  "error": {
    "message": "Free videos can run up to 45 seconds and this one runs 52. Remove a scene to bring it within that.",
    "statusCode": 403,
    "code": "FREE_VIDEO_TOO_LONG",
    "maxSeconds": 45,
    "seconds": 52
  },
  "timestamp": "2026-10-14T12:00:00.000Z",
  "path": "/api/v2/projects/PROJECT_ID/publish"
}

Remove a scene, or buy any credit pack to make longer videos.

Where to buy and see your balance

  • Profile → Billing (app.wevi.ai/app/profile?id=billing): buy credit packs, choose a plan, and see your balance.
  • Profile → API Keys & MCP: spend per key, per-key monthly caps, sandbox allowance for today, and recent API activity.
  • GET /billing/credits and the wevi_get_credits MCP tool: your balance and per-action costs, so an agent can check before starting a large batch.

Key limits & lifecycle

RuleValue
Active Live keys per account10
Active Test keys per account5
RevocationImmediate; the next request gets 401
ExpiryOptional date set at creation; expired keys are refused like revoked ones
RetentionRevoked and expired keys are kept on record with their usage history. The dashboard hides them after 30 days behind a "Show older revoked" toggle

Security Architecture

  • One-Time Secret Display: When an API key is generated, the plaintext secret is revealed only once. Wevi does not store the raw secret key.
  • SHA-256 Hash Storage: The backend hashes keys with SHA-256 before storing them in PostgreSQL.
  • Instant Revocation: Revoking a key from your dashboard immediately disconnects all active Claude Desktop instances and API clients.

Rate Limits

Limits count requests per endpoint from the same IP address, per minute.

EndpointRequests per minute
Most endpoints120
POST /projects/:id/publish, POST /projects/:id/render/start, scene auto-capture, POST /browse/capture10
POST /browse/sessions12
POST /browse/sessions/:id/actions, GET /browse/sessions/:id/outline60

Past a limit the server responds with HTTP status 429 Too Many Requests. Sandbox keys also have the daily allowance above, and live browser sessions a daily allowance of browser minutes (429 with code: "BROWSE_DAILY_MINUTES").