# Model access

> The four ways to pay for the model tokens a Pullfrog run spends, and how to fix a run that fails on credentials or balance.

Every Pullfrog run spends model tokens. Run on a free model, fund Pullfrog Router, bring your own API key, or use a subscription you already pay for.

| Route | What you pay | Set it up |
| --- | --- | --- |
| [Free models](https://pullfrog.com/docs/model-access#free-models) | Nothing per token | Pick the model and store an `OPENCODE_API_KEY` |
| [Pullfrog Router](https://pullfrog.com/docs/router) | A prepaid balance, at provider cost with no markup | Add a card in the console |
| [Your own API key](https://pullfrog.com/docs/api-keys) | Your provider bills you directly | Paste the key in the console |
| [Your existing subscription](https://pullfrog.com/docs/subscriptions) | Nothing extra | One CLI command, or one key |

The **Providers** section of the console's **Billing** card switches the account between **BYOK** (your own keys and subscriptions) and **Pullfrog Router**. A provider key stored with Pullfrog is used for the models it covers even on Router, and free models work under either.

Model access is separate from your [plan](https://pullfrog.com/docs/billing#plans). No plan includes model tokens, and paying for tokens does not require a plan.

## Free models

These models cost nothing per token. Pick one in the [model selector](https://pullfrog.com/docs/models#selecting-a-model).

| Model | Notes |
| --- | --- |
| Big Pickle | |
| Beam | Open-weights preview, free for a limited time; no training, kept 30 days |
| Flint | Recursive's Flint 40B, free for a limited time; free-period data may train the model, kept 30 days |
| MiMo | |

All of them are served by OpenCode Zen, which still authenticates each request. Store an `OPENCODE_API_KEY` the same way as [any other provider key](https://pullfrog.com/docs/api-keys). A run without one stops at session start with `No provider available`.

Any other free model OpenCode Zen starts offering shows up in the model selector within the hour, and leaves it when Zen ends the promotion. A repository that picked it then runs Big Pickle.

## Troubleshooting a failing run

1. **Does the repository's model match a credential you hold?** A repository set to an OpenAI model needs an OpenAI credential, whichever route you use. Check the model in the repository's console.
2. **On Router, is there a balance or a card on file?** An empty balance with no card stops every Router run.
3. **On BYOK, does the key exist?** It can live at the account, at the repository, or in GitHub Actions secrets. A secret the workflow references but nobody created resolves to an empty value, not an error.
4. **On a subscription, has it hit its usage limit?** Runs resume when the limit resets.
5. **Did GitHub refuse to start the job?** A run with no steps at all points to your GitHub Actions billing, not to Pullfrog. Check your GitHub account's billing settings.
