15 KiB
name, description
| name | description |
|---|---|
| hanzo-api-ai | Hanzo AI — the model API on /v1 (/v1/chat/completions, /v1/messages, /v1/models and the rest of hanzoai/ai's surface) — mounted into a cloud binary with the money, ingest and telemetry callbacks… |
Hanzo AI
Scope: Hanzo AI — the model API on /v1 (/v1/chat/completions, /v1/messages, /v1/models and the rest of hanzoai/ai's surface) —…
Surface: 302 operations on /v1/ai, /v1/audio, /v1/chat, /v1/completions, /v1/dev-bridge, /v1/docs, /v1/documents, /v1/embeddings and 17 more
Lines: ~511
Last Updated: 2026-08-20
Source: https://api.hanzo.ai/v1/openapi.json (x-app: ai) — generated, do not hand-edit
When to Use This Skill
Activate this skill when:
- Calling a model — chat, messages, embeddings, images, audio, video, rerank
- You want one credential and one base URL across every provider
- Porting code written against the OpenAI or Anthropic SDK: point base_url here
- Choosing a model: /v1/models carries context window, modalities and price
- Calling
/v1/ai(208 operations) - Calling
/v1/router(30 operations) - Calling
/v1/org(10 operations) - Calling
/v1/finetune(9 operations) - Calling
/v1/memory(7 operations) - Calling
/v1/audio(5 operations) - Calling any of this product's 19 smaller families (see Surface below)
Authentication
Every operation takes a Hanzo IAM bearer token. hanzo auth token prints the
active short-lived access token for the identity you are signed in as; the org
is carried in the token's claim, never in a path or a query parameter.
TOKEN=$(hanzo auth token)
curl -sS https://api.hanzo.ai/v1/... -H "Authorization: Bearer $TOKEN"
The document declares one scheme, bearer, at the top level: Authorization: Bearer <token>. X-Authorization and HTTP Basic carrying the token as the
password are accepted spellings of the same header; a browser presents the
session cookie instead. There is no product-specific key scheme.
Surface
| Family | Operations | Addresses under it |
|---|---|---|
/v1/ai |
208 | account, activities, answer, articles, assets, chats, connections, dashboards, +30 |
/v1/audio |
5 | foley, music, speech, transcriptions, voice |
/v1/chat |
3 | completions, public |
/v1/completions |
1 | the family root |
/v1/dev-bridge |
1 | the family root |
/v1/docs |
1 | ingest |
/v1/documents |
2 | the family root |
/v1/embeddings |
1 | the family root |
/v1/feedback |
1 | the family root |
/v1/finetune |
9 | cancel, deploy, hf, job, jobs, presets |
/v1/images |
1 | generations |
/v1/install-patch |
1 | the family root |
/v1/memory |
7 | delete, facts, list, recall, remember, search, update |
/v1/messages |
2 | count_tokens |
/v1/models |
4 | providers |
/v1/org |
10 | settings |
/v1/query |
1 | the family root |
/v1/query_multiple |
1 | the family root |
/v1/rag |
5 | context, delete, embed, query, query-multiple |
/v1/rerank |
1 | the family root |
/v1/responses |
1 | the family root |
/v1/router |
30 | artifact-meta, data, defaults, history, judge-panel, ledger, policy, rewards, +1 |
/v1/traffic |
1 | globe |
/v1/videos |
3 | generations |
/v1/wecom-bot |
2 | callback |
Operations
302 operations — listed by address. Read any one's prose from the document:
curl -sS https://api.hanzo.ai/v1/openapi.json \
| jq '.paths | to_entries[] | select(.value[]."x-app" == "ai") | {path: .key, ops: (.value | map_values(.summary))}'
/v1/ai
GET /v1/ai/accountGET /v1/ai/activitiesGET /v1/ai/answerGET /v1/ai/articlesPOST /v1/ai/articlesGET /v1/ai/articles/globalDELETE /v1/ai/articles/{owner}/{name}GET /v1/ai/articles/{owner}/{name}PATCH /v1/ai/articles/{owner}/{name}PUT /v1/ai/articles/{owner}/{name}GET /v1/ai/assetsPOST /v1/ai/assetsPOST /v1/ai/assets/scanDELETE /v1/ai/assets/{owner}/{name}GET /v1/ai/assets/{owner}/{name}PATCH /v1/ai/assets/{owner}/{name}PUT /v1/ai/assets/{owner}/{name}POST /v1/ai/assets/{owner}/{name}/scanGET /v1/ai/chatsPOST /v1/ai/chatsGET /v1/ai/chats/globalDELETE /v1/ai/chats/{owner}/{name}GET /v1/ai/chats/{owner}/{name}PATCH /v1/ai/chats/{owner}/{name}PUT /v1/ai/chats/{owner}/{name}GET /v1/ai/connectionsPOST /v1/ai/connectionsDELETE /v1/ai/connections/{provider}POST /v1/ai/connections/{provider}GET /v1/ai/connections/{provider}/authorizeGET /v1/ai/connections/{provider}/callbackGET /v1/ai/connections/{provider}/usageGET /v1/ai/dashboards/agentsGET /v1/ai/dashboards/vmGET /v1/ai/deploymentsPOST /v1/ai/deploymentsDELETE /v1/ai/deployments/{owner}/{name}GET /v1/ai/deployments/{owner}/{name}PATCH /v1/ai/deployments/{owner}/{name}PUT /v1/ai/deployments/{owner}/{name}POST /v1/ai/deployments/{owner}/{name}/deployPOST /v1/ai/deployments/{owner}/{name}/undeployGET /v1/ai/filesPOST /v1/ai/filesPOST /v1/ai/files/activateGET /v1/ai/files/activeGET /v1/ai/files/globalPOST /v1/ai/files/uploadDELETE /v1/ai/files/{owner}/{name}GET /v1/ai/files/{owner}/{name}PATCH /v1/ai/files/{owner}/{name}PUT /v1/ai/files/{owner}/{name}POST /v1/ai/files/{owner}/{name}/vectorsGET /v1/ai/formsPOST /v1/ai/formsGET /v1/ai/forms/dataGET /v1/ai/forms/globalDELETE /v1/ai/forms/{owner}/{name}GET /v1/ai/forms/{owner}/{name}PATCH /v1/ai/forms/{owner}/{name}PUT /v1/ai/forms/{owner}/{name}GET /v1/ai/graphsPOST /v1/ai/graphsGET /v1/ai/graphs/globalDELETE /v1/ai/graphs/{owner}/{name}GET /v1/ai/graphs/{owner}/{name}PATCH /v1/ai/graphs/{owner}/{name}PUT /v1/ai/graphs/{owner}/{name}GET /v1/ai/k8s-statusGET /v1/ai/mcp/toolsGET /v1/ai/messagesPOST /v1/ai/messagesGET /v1/ai/messages/globalDELETE /v1/ai/messages/welcomeDELETE /v1/ai/messages/{owner}/{name}GET /v1/ai/messages/{owner}/{name}PATCH /v1/ai/messages/{owner}/{name}PUT /v1/ai/messages/{owner}/{name}GET /v1/ai/messages/{owner}/{name}/answerGET /v1/ai/nodesPOST /v1/ai/nodesDELETE /v1/ai/nodes/{owner}/{name}GET /v1/ai/nodes/{owner}/{name}PATCH /v1/ai/nodes/{owner}/{name}PUT /v1/ai/nodes/{owner}/{name}GET /v1/ai/nodes/{owner}/{name}/tunnelPOST /v1/ai/nodes/{owner}/{name}/tunnelPATCH /v1/ai/preferencesPUT /v1/ai/preferencesGET /v1/ai/prometheusGET /v1/ai/providersPOST /v1/ai/providersGET /v1/ai/providers/globalPOST /v1/ai/providers/mcp-toolsDELETE /v1/ai/providers/{owner}/{name}GET /v1/ai/providers/{owner}/{name}PATCH /v1/ai/providers/{owner}/{name}PUT /v1/ai/providers/{owner}/{name}GET /v1/ai/recordsPOST /v1/ai/recordsPOST /v1/ai/records/batchPOST /v1/ai/records/commitPOST /v1/ai/records/commit-secondGET /v1/ai/records/queryGET /v1/ai/records/query-secondDELETE /v1/ai/records/{owner}/{name}GET /v1/ai/records/{owner}/{name}PATCH /v1/ai/records/{owner}/{name}PUT /v1/ai/records/{owner}/{name}GET /v1/ai/remote-connectionsPOST /v1/ai/remote-connectionsDELETE /v1/ai/remote-connections/{owner}/{name}GET /v1/ai/remote-connections/{owner}/{name}PATCH /v1/ai/remote-connections/{owner}/{name}PUT /v1/ai/remote-connections/{owner}/{name}POST /v1/ai/remote-connections/{owner}/{name}/startPOST /v1/ai/remote-connections/{owner}/{name}/stopGET /v1/ai/routesPOST /v1/ai/routesDELETE /v1/ai/routes/{owner}/{name}GET /v1/ai/routes/{owner}/{name}PATCH /v1/ai/routes/{owner}/{name}PUT /v1/ai/routes/{owner}/{name}GET /v1/ai/scalesPOST /v1/ai/scalesGET /v1/ai/scales/globalGET /v1/ai/scales/publicDELETE /v1/ai/scales/{owner}/{name}GET /v1/ai/scales/{owner}/{name}PATCH /v1/ai/scales/{owner}/{name}PUT /v1/ai/scales/{owner}/{name}GET /v1/ai/scansPOST /v1/ai/scansDELETE /v1/ai/scans/{owner}/{name}GET /v1/ai/scans/{owner}/{name}PATCH /v1/ai/scans/{owner}/{name}PUT /v1/ai/scans/{owner}/{name}POST /v1/ai/signinGET /v1/ai/signin-sessionsPOST /v1/ai/signin-sessionsGET /v1/ai/signin-sessions/duplicatedDELETE /v1/ai/signin-sessions/{owner}/{name}GET /v1/ai/signin-sessions/{owner}/{name}PATCH /v1/ai/signin-sessions/{owner}/{name}PUT /v1/ai/signin-sessions/{owner}/{name}POST /v1/ai/signoutGET /v1/ai/storesPOST /v1/ai/storesGET /v1/ai/stores/globalGET /v1/ai/stores/namesGET /v1/ai/stores/providersDELETE /v1/ai/stores/{owner}/{name}GET /v1/ai/stores/{owner}/{name}PATCH /v1/ai/stores/{owner}/{name}PUT /v1/ai/stores/{owner}/{name}POST /v1/ai/stores/{owner}/{name}/vectorsGET /v1/ai/systemGET /v1/ai/tasksPOST /v1/ai/tasksGET /v1/ai/tasks/globalDELETE /v1/ai/tasks/{owner}/{name}GET /v1/ai/tasks/{owner}/{name}PATCH /v1/ai/tasks/{owner}/{name}PUT /v1/ai/tasks/{owner}/{name}POST /v1/ai/tasks/{owner}/{name}/analyzePOST /v1/ai/tasks/{owner}/{name}/documentGET /v1/ai/templatesPOST /v1/ai/templatesDELETE /v1/ai/templates/{owner}/{name}GET /v1/ai/templates/{owner}/{name}PATCH /v1/ai/templates/{owner}/{name}PUT /v1/ai/templates/{owner}/{name}GET /v1/ai/training-contributionPATCH /v1/ai/training-contributionPUT /v1/ai/training-contributionPOST /v1/ai/tree-filesDELETE /v1/ai/tree-files/{owner}/{name}PATCH /v1/ai/tree-files/{owner}/{name}PUT /v1/ai/tree-files/{owner}/{name}GET /v1/ai/usagesGET /v1/ai/usages/by-userGET /v1/ai/usages/cloudGET /v1/ai/usages/rangeGET /v1/ai/usages/user-namesGET /v1/ai/vectorsPOST /v1/ai/vectorsDELETE /v1/ai/vectors/allGET /v1/ai/vectors/globalDELETE /v1/ai/vectors/{owner}/{name}GET /v1/ai/vectors/{owner}/{name}PATCH /v1/ai/vectors/{owner}/{name}PUT /v1/ai/vectors/{owner}/{name}GET /v1/ai/versionGET /v1/ai/videosPOST /v1/ai/videosGET /v1/ai/videos/globalPOST /v1/ai/videos/uploadDELETE /v1/ai/videos/{owner}/{name}GET /v1/ai/videos/{owner}/{name}PATCH /v1/ai/videos/{owner}/{name}PUT /v1/ai/videos/{owner}/{name}GET /v1/ai/workflowsPOST /v1/ai/workflowsGET /v1/ai/workflows/globalDELETE /v1/ai/workflows/{owner}/{name}GET /v1/ai/workflows/{owner}/{name}PATCH /v1/ai/workflows/{owner}/{name}PUT /v1/ai/workflows/{owner}/{name}
/v1/audio
POST /v1/audio/foleyPOST /v1/audio/musicPOST /v1/audio/speechPOST /v1/audio/transcriptionsPOST /v1/audio/voice
/v1/chat
POST /v1/chatPOST /v1/chat/completionsPOST /v1/chat/public
/v1/completions
POST /v1/completions
/v1/dev-bridge
GET /v1/dev-bridge
/v1/docs
POST /v1/docs/ingest
/v1/documents
DELETE /v1/documentsGET /v1/documents/{file_id}/context
/v1/embeddings
POST /v1/embeddings
/v1/feedback
POST /v1/feedback
/v1/finetune
POST /v1/finetune/cancelPOST /v1/finetune/deployGET /v1/finetune/hf/datasetsGET /v1/finetune/hf/modelsGET /v1/finetune/hf/repoGET /v1/finetune/jobGET /v1/finetune/jobsPOST /v1/finetune/jobsGET /v1/finetune/presets
/v1/images
POST /v1/images/generations
/v1/install-patch
POST /v1/install-patch
/v1/memory
POST /v1/memory/deleteGET /v1/memory/factsGET /v1/memory/listGET /v1/memory/recallPOST /v1/memory/rememberGET /v1/memory/searchPOST /v1/memory/update
/v1/messages
POST /v1/messagesPOST /v1/messages/count_tokens
/v1/models
GET /v1/modelsGET /v1/models/providersGET /v1/models/{model}/accessPOST /v1/models/{model}/access
/v1/org
DELETE /v1/org/settingsGET /v1/org/settingsPATCH /v1/org/settingsPOST /v1/org/settingsPUT /v1/org/settingsDELETE /v1/org/settings/listGET /v1/org/settings/listPATCH /v1/org/settings/listPOST /v1/org/settings/listPUT /v1/org/settings/list
/v1/query
POST /v1/query
/v1/query_multiple
POST /v1/query_multiple
/v1/rag
GET /v1/rag/contextPOST /v1/rag/deletePOST /v1/rag/embedPOST /v1/rag/queryPOST /v1/rag/query-multiple
/v1/rerank
POST /v1/rerank
/v1/responses
POST /v1/responses
/v1/router
DELETE /v1/router/artifact-metaGET /v1/router/artifact-metaPATCH /v1/router/artifact-metaPOST /v1/router/artifact-metaPUT /v1/router/artifact-metaDELETE /v1/router/dataGET /v1/router/dataDELETE /v1/router/defaultsGET /v1/router/defaultsPATCH /v1/router/defaultsPOST /v1/router/defaultsPUT /v1/router/defaultsGET /v1/router/historyGET /v1/router/judge-panelDELETE /v1/router/ledgerGET /v1/router/ledgerPATCH /v1/router/ledgerPOST /v1/router/ledgerPUT /v1/router/ledgerDELETE /v1/router/policyGET /v1/router/policyPATCH /v1/router/policyPOST /v1/router/policyPUT /v1/router/policyDELETE /v1/router/rewardsGET /v1/router/rewardsPATCH /v1/router/rewardsPOST /v1/router/rewardsPUT /v1/router/rewardsGET /v1/router/stats
/v1/traffic
GET /v1/traffic/globe
/v1/videos
POST /v1/videos/generationsGET /v1/videos/{id}GET /v1/videos/{id}/content
/v1/wecom-bot
GET /v1/wecom-bot/callback/{botId}POST /v1/wecom-bot/callback/{botId}
Example Calls
TOKEN=$(hanzo auth token)
Returns the list of available models from the routing table.
curl -sS "https://api.hanzo.ai/v1/models"
Implements the OpenAI-compatible chat completions API
curl -sS -X POST "https://api.hanzo.ai/v1/chat/completions"
Implements the Anthropic Messages API.
curl -sS -X POST "https://api.hanzo.ai/v1/messages"
Answers
Documented status codes across this product: 200 (1).
18 of these operations are marked public in the document — they are reachable without a bearer token. The rest are not.
Composition
pricingprices a model before you call it;usageandbillingreport what the call costrouterpaths inside this product pick a model per request;plandecides which are allowedsandboxruns code the model writes;toollists what the model may callo11yreceives the traces — a model call is the span most worth keeping
Related Skills
hanzo-api/eval.md— Scoring a model on your own data, with a judge you choose.hanzo-api/benchmark.md— One honest score for any model, on the tests everyone quotes.hanzo-api/research.md— Every experiment you have ever run, kept and comparable.hanzo-api/experiment.md— A/B testing anything: a flag, an ad, a subject line, a model.hanzo-cloud-architecture/SKILL.md— how one binary serves all of thishanzo-api/INDEX.md— every Hanzo product, by domain
Last Updated: 2026-08-20 Generated from: https://api.hanzo.ai/v1/openapi.json