Create Your Account

Go to hanzo.id and sign up with:

• Email + password -- the simplest path
• GitHub -- one-click OAuth, great for developers
• Google -- connect your workspace account
• Wallet -- sign in with an Ethereum-compatible wallet

Your Hanzo identity works everywhere: console, chat, platform, cloud, and all API services. One account, one login.

Open the Console

After signing up you will be redirected to console.hanzo.ai. This is your dashboard for managing projects, API keys, usage, and billing.

If you already have an account, go directly to console.hanzo.ai -- it will redirect through hanzo.id for authentication if you are not already logged in.

Create a Project

Projects are the top-level container for your work. Each project has its own API keys, usage limits, and billing scope.

1. In the console sidebar, click Projects
2. Click New Project
3. Enter a name (e.g. my-first-project)
4. Select your organization (if you belong to more than one)
5. Click Create

All resources -- API keys, models, usage logs -- are scoped to the active project.

Generate an API Key

1. Navigate to your project in the console
2. Click API Keys in the sidebar
3. Click Create Key
4. Give the key a descriptive name (e.g. dev-testing)
5. Copy the key immediately -- it will not be shown again

Your key will look like this:

hk-proj-abc123def456...

The hk- prefix identifies it as a Hanzo API key. See API Keys for a full breakdown of key types and prefixes.

Make Your First API Call

Every Hanzo service — AI, storage, identity, deploys — answers on one host, api.hanzo.ai, under /v1/<service>, with the same hk-* key. There is no second API host to configure.

curl

curl https://api.hanzo.ai/v1/chat/completions \
  -H "Authorization: Bearer hk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "zen5",
    "messages": [{"role": "user", "content": "Hello from Hanzo!"}]
  }'

List every model id the same way — /v1/models takes the same key:

curl https://api.hanzo.ai/v1/models \
  -H "Authorization: Bearer hk-your-api-key"

Python

Install the SDK:

pip install hanzoai

from hanzoai import Hanzo

client = Hanzo(api_key="hk-your-api-key")

response = client.chat.completions.create(
    model="zen5",
    messages=[{"role": "user", "content": "Hello from Hanzo!"}],
)
print(response.choices[0].message.content)

TypeScript

Install the SDK:

npm install @hanzo/ai

import Hanzo from '@hanzo/ai'

const client = new Hanzo({ apiKey: 'hk-your-api-key' })

const completion = await client.chat.completions.create({
  model: 'zen5',
  messages: [{ role: 'user', content: 'Hello from Hanzo!' }],
})
console.log(completion.choices[0].message.content)

Already have an HTTP client?

/v1/chat/completions takes and returns the same JSON shapes as the widely-implemented chat-completions format. That shape is an interchange format we do not own and had no reason to re-invent, so a client written against it works here once its base URL points at https://api.hanzo.ai/v1 and it sends your Hanzo key.

Prefer a UI? Open chat.hanzo.ai and start chatting -- it spends from the same balance.

Add Credits

Top up a prepaid balance at billing.hanzo.ai:

• Card -- pay by card through the billing portal (processed by Square).
• Crypto -- top up on-chain with HUSD, the platform stablecoin, from a connected wallet.

Every product -- API calls, deploys, storage -- draws down the same balance. Watch usage in the console's Usage & Billing views. For how metering, credits, and invoices fit together, see Credits & Billing.

Building a funded startup? You may qualify for up to $150,000 in credits through the Startup Program.