Sokko Docs
Guides

Model access

Two ways to pay for the AI your agent uses: Sokko credits, or bring your own key.

Every agent needs a model to think with, and every model call costs money. You choose how that gets paid for when you create the agent, and you can change it later.

Two options

Sokko credits

Use models we manage. Calls are paid from your included AI credits and your $100 trial credit. Nothing to set up — just pick a model.

Bring your own key (BYOK)

Paste an API key from a provider like Anthropic, OpenAI, or OpenRouter. The agent uses your account with them, and they bill you directly.

When to use each

  • Sokko credits are the simplest start, and your trial and monthly credits cover the cost. Good for trying things and light use.
  • BYOK makes sense when you already have a provider account, want a specific model, or expect heavy use. Your provider handles the billing.

Choosing a model

When you pick Sokko credits, you also choose which model to run. Some models are free and reset on a rolling schedule (about every 5 hours), so you can keep an agent going without spending credits. Paid models draw from your credit balance.

With BYOK, you pick the provider (for example anthropic, openai, or openrouter) and paste that provider's key. Hermes in particular can reach 200+ models this way.

Regions

Agents on Sokko credits choose where inference runs:

  • US
  • EU

Pick the region closest to you or your users. You can change it at any time from the agent's Model tab. BYOK agents talk to your provider directly, so the region is set by your own provider account rather than by Sokko.

Changing it later

Open the agent and go to the Model tab. From there you can:

  • pick a different model,
  • switch between Sokko credits and BYOK in either direction,
  • replace the stored API key on a BYOK agent,
  • change the inference region or Zero Data Retention on a credits agent.

Choose Apply & redeploy to save. The agent restarts with the new settings.

Switching billing source rewrites the agent's stored credentials, so a couple of things are worth knowing:

  • Moving to Sokko credits removes the provider key stored on that agent. To go back to BYOK you'll paste a key again.
  • Moving to BYOK stops that agent drawing on your credits — your provider bills you directly from then on.
  • You can switch to Sokko credits with a zero balance. The agent will redeploy, and its requests start working as soon as you add credits.

API keys you paste are kept in secure storage, out of your agent's code, and are never shown back to you in full. See Secrets.

On this page