Quickstart

1. Sign up at the dashboard (Dashboard in the sidebar, or Sign in on the home page); a new email address creates an account. New accounts have $5 of credits.
2. Create an API key under API keys, then install the CLI (Python 3.10 or later) with pip install unitfabric and sign it in with the line the API keys page shows, unitfabric login --url <control url> --key <key> with the control plane’s URL filled in. unitfabric templates lists the templates and their prices.
3. Write a manifest prompts.jsonl, one unit per line:

   {"prompt": "a red bicycle leaning on a brick wall", "seed": 1}
   {"prompt": "an isometric voxel city at dusk", "seed": 2}

4. Write a job spec job.yaml next to it:

   name: first images
   template: image/sdxl-turbo@1
   input: prompts.jsonl

5. Submit: unitfabric submit job.yaml uploads the manifest, then prints the job id, its status, its number of units and the price per unit.
6. Watch: unitfabric job <id> or the dashboard. Units move from pending to leased to done.
7. Download: unitfabric results <id> --out ./results writes one directory per unit with its files: here image.png, and done.json with the unit’s id, files and time. Run it again to fetch units that finished since; files already downloaded are not fetched again.
8. Top up: unitfabric topup 25 prints a card checkout link for $25 (any amount from $5 to $10,000, cents allowed), or use Billing in the dashboard (whole dollars). unitfabric account shows the new balance once the payment has gone through.