Skip to content
ca es en

← First steps

Account and credits

Create the account, understand the prepaid-credit model and generate an API key that never leaves the server.

6 slides 4 min read

  1. OpenRouter · Primers passos

    Account and credits

    From signup to your first key, with no billing surprises.

    OpenRouter · First steps arlaf.dev

  2. Create the account

    You sign up at openrouter.ai with email or an identity provider. One account gives you access to hundreds of models from many providers behind a single API.

    OpenRouter · First steps arlaf.dev

  3. Prepaid credits, not a subscription

    The model is pay-as-you-go: you load credit and each call draws it down by the tokens it spends. There's no fixed monthly fee.

    • You load credit once and usage consumes it.
    • Cost depends on the model and on input and output tokens.
    • Free model variants exist, with stricter limits.
    OpenRouter · First steps arlaf.dev

  4. The API key is a secret

    You generate the key in the keys panel. Anyone who holds it can spend your credit, so it lives on the server only — never in browser code or a public repo.

    OpenRouter · First steps arlaf.dev

  5. Keep the key out of the code

    # Variable d'entorn, mai escrita al codi font
export OPENROUTER_API_KEY="sk-or-v1-..."

# En un projecte, en un .env que NO es puja a git
echo "OPENROUTER_API_KEY=sk-or-v1-..." >> .env
echo ".env" >> .gitignore
    OpenRouter · First steps arlaf.dev
  6. A leaked key is credit gifted to strangers. Treat it like a password.
    OpenRouter · First steps arlaf.dev
Read the full note

Abans de fer cap crida necessites dues coses: un compte amb crèdit i una API key. OpenRouter és una passarel·la que exposa centenars de models de molts proveïdors darrere d’una sola API compatible amb OpenAI, i la facturació també és única — un sol saldo per a tots.

El compte i el saldo

Et registres a openrouter.ai i carregues crèdit prepagat. El funcionament és pay-as-you-go: no pagues una quota mensual, pagues el que gastes. Cada crida descompta del saldo segons el model triat i el nombre de tokens d’entrada i de sortida. Models més capaços costen més per token; models petits, gairebé res.

També hi ha variants gratuïtes d’alguns models — solen portar el sufix :free al slug — útils per provar, però amb límits de freqüència més estrictes i menys garanties de disponibilitat.

Nota: els preus per token, els límits del tier gratuït i els mínims de càrrega canvien sovint. Mira la pàgina de models i la de límits a la documentació abans de fer números.

La API key

Al panell de claus generes una API key. És el que autentica les teves crides i, sobretot, és el que es vincula al teu crèdit: qui la tingui pot gastar-lo.

Per això la key ha de viure només al servidor. Guarda-la en una variable d’entorn o un gestor de secrets, mai dins del codi que arriba al navegador ni en un repositori. Si fas una app de front-end, les crides passen per un backend teu que afegeix la key; el navegador no l’ha de veure mai.

Nota: si sospites que una key s’ha filtrat, revoca-la al panell i genera’n una de nova. És instantani i no trenca res que no hagis de tornar a configurar.