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!"}]
  }'

Browse every model id with curl https://api.hanzo.ai/v1/models — the Zen family plus 400+ third-party models, all on the same key.

Python

Install the SDK:

pip install hanzoai
# or with the OpenAI-compatible client:
pip install openai

Using the OpenAI-compatible interface (works with any OpenAI SDK):

from openai import OpenAI

client = OpenAI(
    api_key="hk-your-api-key",
    base_url="https://api.hanzo.ai/v1",
)

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 hanzoai
# or with the OpenAI-compatible client:
npm install openai

Using the OpenAI-compatible interface:

import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'hk-your-api-key',
  baseURL: 'https://api.hanzo.ai/v1',
})

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

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.