Subscriptions
A subscription in Modem is a saved sign-in to a provider account. Modem stores and renews its authentication on the server. A relay link gives a native client a Modem URL and key, then serves its requests through one or more of those saved subscriptions.
This differs from a provider API key. A subscription uses the provider’s included allowance and any permitted credits; it does not turn that allowance into a provider API balance.
Start here
- Import or connect a subscription.
- Create a relay and copy its one-time key and generated native setup.
- Run the configured client, then inspect its requests in Usage.
- Add more accounts to use ordered multiplexing.
| Client | Subscription | Request format |
|---|---|---|
| Codex | ChatGPT | Codex HTTP Responses with inline history |
| Grok CLI | Grok | Chat Completions or Responses with inline history |
| Claude Code | Claude | Messages; availability note below |
The supported model list comes from the accounts behind the relay. A subscription does not necessarily expose every model sold through that provider’s API, or every feature of a model.
NOTE
The current source includes Claude import, relay setup, Messages, model discovery and quota reporting. These additions are still under development and are not established as available in the hosted release. Claude-specific instructions in this section apply to a deployment containing those additions. ChatGPT/Grok setup must also use the instructions returned by the deployment you actually use.
What a link owns
A link has a stable relay identity and an associated Live project, default product and owner customer. Its usage and rate rules apply to that project/product. Changing the link’s subscriptions changes its members; it does not create another project or another product.
Each subscription can participate in several links. Opening its details from Credentials lists every link containing it, including multiplexed links where it is not primary. Revoking a link invalidates its key and removes its associated project while retaining request history for Usage. The saved sign-ins remain available to other links.
Understand the limits
- Quotas and credits explains provider allowances, balances, freshness and Modem estimates.
- Client compatibility explains inline history, tool state and account metadata.
- Troubleshooting explains failed imports, unavailable catalogs, refusals and uncertain outcomes.