API Reference
Complete API reference for all Hanzo Cloud services. Generated from OpenAPI 3.1.0 specifications.
Hanzo API Reference
Complete API documentation for every Hanzo service. All endpoints use a single API key and route through api.hanzo.ai.
Authentication
curl -H "Authorization: Bearer hk-your-api-key" https://api.hanzo.ai/v1/modelsGet your API key at console.hanzo.ai.
SDKs
Use our official SDKs instead of raw HTTP:
| Language | Package | Install |
|---|---|---|
| Python | hanzoai | pip install hanzoai |
| TypeScript | hanzoai | npm install hanzoai |
| Go | go-sdk | go get github.com/hanzoai/go-sdk |
| Rust | hanzo-ai | cargo add hanzo-ai |
| C/C++ | c-sdk | CMake FetchContent |
AI & Intelligence
Cloud
LLM inference gateway — chat completions, embeddings, image generation, audio
Chat
Multi-model AI chat with conversation management and tool use
Search
AI-powered search — indexing, query, and generative results
Bot
AI assistant framework — skills, channels, webhook integrations
Nexus
RAG pipeline — document ingestion, chunking, retrieval
Vector
Vector database — collections, embeddings, similarity search
ML
MLOps — model registry, training jobs, deployment
Automation
Flow
Visual workflow builder — triggers, actions, branching logic
Auto
Event-driven automation — schedules, webhooks, task chains
Operative
Computer use agent — browser automation, desktop control
Identity & Security
IAM
Identity — users, organizations, SSO, OIDC, OAuth2, SAML
DID
Decentralized identity — W3C DIDs, verifiable credentials
Guard
AI safety — PII redaction, prompt injection detection, content filtering
KMS
Secrets management — encryption keys, certificates, secret sync
Commerce & Business
Commerce
Headless commerce — products, orders, subscriptions, payments
Console
LLM observability — tracing, prompt management, evaluations
Analytics
Usage metrics — API calls, cost tracking, per-model analytics
Pricing
Pricing API — model costs, subscription plans, GPU tiers
Infrastructure
Gateway
API gateway — routing, rate limiting, circuit breakers
PaaS
Platform-as-a-Service — deployments, domains, databases
Platform
Application hosting — Git push deploy, scaling, logs
S3
Object storage — S3-compatible buckets, presigned URLs
DB
Serverless PostgreSQL — branches, pgvector, connection pooling
KV
Key-value store — Redis/Valkey-compatible, pub/sub, streams
MQ
Job queue — background tasks, retries, dead-letter queues
Stream
Kafka-compatible streaming — topics, consumers, partitions
PubSub
Pub/sub messaging — JetStream, subjects, durable consumers
Edge
Edge functions — serverless compute at 300+ locations
Registry
Container registry — Docker images, OCI artifacts, scanning
Visor
Cluster management — Kubernetes monitoring, resource visualization
Operations
Engine
Inference engine — GPU scheduling, quantization, model loading
O11y
Observability — metrics, logs, traces, alerts, dashboards
DNS
DNS management — zones, records, Cloudflare integration
ZT
Zero-trust networking — tunnels, access policies, service mesh
Unified Spec
The complete unified OpenAPI 3.1.0 specification covering all services is available as a single file:
- hanzo.yaml — All 35 services in one spec
All specs are also available in the hanzoai/openapi repository.
Getting Started
Authentication
API Keys
Organizations
Platform
SDKs
Overview
Hanzo Studio
LLM Gateway
MCP
Hanzo Dev
ZAP Protocol
Hanzo Tasks
Hanzo Functions
Hanzo PubSub
Hanzo O11y
Hanzo Zero Trust
How is this guide?
Last updated on