deeprelay billing subscribe

Start a subscription (prints a Stripe Checkout link)

Synopsis

Starts a subscription to the deeprelay plan. Prints a Stripe Checkout link; open it in a browser to pay.

The link is the honest shape of this command. Checkout is a hosted page — the card details go to Stripe, never through this CLI or our servers — so there is no headless way to complete a purchase. What the CLI *can* do is everything around it: quote the price before you commit, refuse a second subscription you already have, and confirm afterwards that the plan actually started.

Flat tier — $2.99 / month

Open this link to finish subscribing:

  https://checkout.stripe.com/c/pay/cs_live_...

The page is hosted by Stripe; the subscription starts once payment completes.
Check it landed with `deeprelay billing subscription`.

The price shown is read live from Stripe, not hardcoded. If it is missing, the plan name prints alone — that means the price could not be read right now, not that the plan is free. The Checkout page always shows the real figure.

Before you subscribe

deeprelay models list marks which models the plan covers (plan_covered in JSON). Models outside that list still bill pay-as-you-go from your credit balance while you are subscribed — the subscription does not make every model free, and deeprelay preflight will warn you before any call that would be charged.

deeprelay billing subscription prints the plan's quota even when you are not subscribed, so you can see what you would be getting.

After you subscribe

The subscription becomes active when Stripe confirms payment, which is usually immediate but is not synchronous with this command. Confirm with:

deeprelay billing subscription

To cancel, change payment method, or download invoices, use deeprelay billing cancel.

Permissions and errors

Requires an org admin API key with the billing write scope — subscribing spends organization money. A member key gets 403.

Situation	Result
Already subscribed	409 — one plan per organization
Subscriptions not configured on this deployment	503
Not an org admin	403

Examples

# Start a subscription.
deeprelay billing subscribe

# Get just the URL, for a script that opens a browser itself.
deeprelay billing subscribe --output json | jq -r .checkout_url

# Return the customer to your own app instead of the console.
deeprelay billing subscribe \
  --success-url https://example.com/thanks \
  --cancel-url  https://example.com/pricing

--success-url and --cancel-url default to the URLs the deployment is configured with; you rarely need to set them.

deeprelay billing subscribe [flags]

Options

      --cancel-url string    Where Stripe returns if the customer abandons checkout (defaults to the server's configured URL)
  -h, --help                 help for subscribe
      --success-url string   Where Stripe returns after a completed payment (defaults to the server's configured URL)

Options inherited from parent commands

      --api-base string   API base URL (override with DEEPRELAY_API_BASE env) (default "https://api.deeprelay.ai/v1")
      --debug             Enable debug logging to stderr
      --no-preflight      Skip the plan/credit check before inference requests (override with DEEPRELAY_NO_PREFLIGHT env)
  -o, --output string     Output format: table|json (default table on TTY, json otherwise) (default "table")

SEE ALSO

• deeprelay billing - Check your balance, add funds, and review deposits