The guide to credits

Credits and spending

What credits are, what things cost, and how to check every entry yourself.

On this page
  1. What credits are
  2. Your balance
  3. What things cost
  4. Budgets
  5. Which model answers
  6. Receipts and the ledger
  7. Statements and giving
  8. Out of credits

The guides

For AI

And nothing else.

What credits are

Credits pay for AI on the woodls network. A new account starts with some, to spend within 60 days, and your computer earns more by lending. They can’t be bought, sold, sent to another person or cashed out, and they never become money. Credits says why.

Three numbers

Spendable, pending and reserved.

Your balance

woodls credits
  • Spendable: what you can spend now; starting credits say the day they end.
  • Pending: what your computer earned that can’t be spent yet, with when it can: 14 days after it was earned while your computer is new to woodls, then 7.
  • Reserved: set aside for answers running now. What an answer doesn’t use comes back when it ends.

Below them, every entry in plain words: “an answer, free: nothing was charged”, “+0.21 credits pending, for hosting”, “a reservation given back”. woodls whoami gives the short version, woodls status the overview, and woodls web the same in your browser, where nothing can be spent.

Per million tokens

The pieces of text a model reads and writes.

What things cost

woodls models

Each model’s price, in credits for every million tokens it reads and every million it writes. gpt-oss 20B and Qwen3.6 35B are both 8 credits a million tokens read and 30 written. You pay for exactly what was read and written, and 15% of it goes to the shared account that keeps the network running. A request woodls’ server refuses costs nothing. The prices page has every size.

Free, with no credits at all: a private group of your own or your friends’ computers, woodls code on your own provider’s key, a model on your computer, or your own server.

A ceiling

Set before anything is spent.

Budgets

Before a question is sent, the most it may cost is reserved: 5 credits unless you say otherwise, and never more than you have. The rest comes back when the answer ends.

woodls ask --budget 2 "…"
At most 2 credits for this question
woodls code --budget 10
At most 10 credits for the whole task
woodls code --daily-limit 20
At most 20 credits a day for woodls code (50 unless you say)

A computer you added to your account spends within its own daily limit, which you set when you add it (Your account).

The first served

Unless you choose.

Which model answers

A question goes to the model you name with --model, else to your saved model while a computer serves it, else to the first model the network serves now, and woodls says so when it isn’t yours.

woodls config set model gpt-oss
Prefer gpt-oss 20B; a part of its name will do
woodls ask --model qwen3.6 "…"
Ask this model, this once
woodls public
Which models are served now, and on how many computers

When the computer answering is busy, or none serves the model, woodls waits and tries again twice, after 5 seconds and then 15, and says so. Esc or Ctrl+C stops the wait.

Checked here

Not taken on trust.

Receipts and the ledger

Every entry is on woodls’ public ledger, signed by its witnesses, and each answer you pay for has a receipt signed by the computer that served it.

woodls history --receipts
The receipts checked here for your jobs
woodls ledger verify 1234
Check entry 1234’s receipt on your own computer
woodls ledger balance
Spendable, starting, earned and reserved
woodls ledger
The ledger’s newest checkpoint and its witnesses

ledger verify checks an entry against the ledger and its witnesses’ keys, which this computer pinned when it opened your account, without trusting woodls’ server.

For your records

And for the shared account.

Statements and giving

woodls credits statement 2026-11
Every entry of a month, or a year (2026), as a CSV file
woodls credits give 10 --to shared
Give earned credits to the shared account

The shared account pays for allowances and, later, for students’ credits. Credits can be given only to it, never to a person.

Two ways on

Earn, or use what’s free.

Out of credits

When a question needs more than you have, woodls says “not enough credits (spendable …)”, and how to go on: lend your computer with woodls host to earn more, which you can spend once it’s no longer pending, or ask a private group of yours, which is free (--group NAME).