Coroutine-native client covering the full Hanzo /v1 cloud surface, for JVM and Android. Generated with openapi-generator kotlin (library=jvm-okhttp4, useCoroutines=true). Coordinate: ai.hanzo:sdk. Base URL: https://api.hanzo.ai. Co-authored-by: Hanzo Dev <[email protected]>
18 KiB
CloudApi
All URIs are relative to https://api.hanzo.ai
| Method | HTTP request | Description |
|---|---|---|
| pricingGetCloud | GET /v1/pricing/cloud | Cloud VM plans, regions, and storage |
| pricingGetFullPricing | GET /v1/pricing | Full pricing data |
| pricingGetStoragePricing | GET /v1/pricing/cloud/storage | Block storage pricing |
| pricingListCloudPlans | GET /v1/pricing/cloud/plans | Cloud VM plans |
| pricingListCloudRegions | GET /v1/pricing/cloud/regions | Available cloud regions |
| worldWorldCloudAnalytics | GET /v1/world/cloud/analytics | ADMIN. Web analytics aggregate — top pages/referrers/countries, live visitors (analytics.hanzo.ai). Requires an admin-org IAM bearer. |
| worldWorldCloudByoGpu | GET /v1/world/cloud/byo-gpu | Public BYO-GPU map data — connected GPU workers by region (real counts when a service token is wired server-side, else demo-flagged). No auth. |
| worldWorldCloudChainNodes | GET /v1/world/cloud/chain-nodes | Public blockchain-network map data — per-network block height, peer count, live flag, and modeled node positions (positionsModeled:true; counts are real, geo is illustrative). No auth. |
| worldWorldCloudFleet | GET /v1/world/cloud/fleet | ADMIN. Machines + GPUs grouped by provider/region (visor). Requires an admin-org IAM bearer; 401 without a token, 403 for non-admin. |
| worldWorldCloudLlm | GET /v1/world/cloud/llm | ADMIN. Platform LLM observability — per-model/per-org usage, tokens, cost, errors, trace latency (cloud /v1/admin/o11y). Requires an admin-org IAM bearer. |
| worldWorldCloudModels | GET /v1/world/cloud/models | Public served-model catalog + scale (from the gateway /v1/models). No auth. |
| worldWorldCloudPulse | GET /v1/world/cloud-pulse | Public platform aggregate (SaaS variant). Anonymized counts; demo-flagged unless a service token is wired server-side. |
| worldWorldCloudServices | GET /v1/world/cloud/services | ADMIN. Per-subsystem health + RED metrics (o11y). Requires an admin-org IAM bearer. |
| worldWorldCloudTraffic | GET /v1/world/cloud/traffic | Public request-traffic arcs — country-level origin → nearest region, weight-normalized (real analytics when a service token is wired server-side, else demo-flagged). No auth. |
pricingGetCloud
PricingCloudResponse pricingGetCloud()
Cloud VM plans, regions, and storage
Returns all cloud infrastructure pricing: VM plans, available deployment regions, and block storage rates.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : PricingCloudResponse = apiInstance.pricingGetCloud()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#pricingGetCloud")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#pricingGetCloud")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
pricingGetFullPricing
PricingFullPricingResponse pricingGetFullPricing()
Full pricing data
Returns the complete pricing dataset including all AI models, tools, infrastructure, and cloud plans. Large response (~500KB).
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : PricingFullPricingResponse = apiInstance.pricingGetFullPricing()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#pricingGetFullPricing")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#pricingGetFullPricing")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
pricingGetStoragePricing
PricingBlockStoragePricing pricingGetStoragePricing()
Block storage pricing
Returns per-GB/month pricing for block storage volumes.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : PricingBlockStoragePricing = apiInstance.pricingGetStoragePricing()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#pricingGetStoragePricing")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#pricingGetStoragePricing")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
pricingListCloudPlans
PricingCloudPlansResponse pricingListCloudPlans()
Cloud VM plans
Returns available cloud VM plans with specs and pricing. Plans range from $5/mo (Starter) to $3,999/mo (Ultra). All prices include zero egress fees.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : PricingCloudPlansResponse = apiInstance.pricingListCloudPlans()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#pricingListCloudPlans")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#pricingListCloudPlans")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
pricingListCloudRegions
PricingCloudRegionsResponse pricingListCloudRegions()
Available cloud regions
Returns deployment regions with availability status.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : PricingCloudRegionsResponse = apiInstance.pricingListCloudRegions()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#pricingListCloudRegions")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#pricingListCloudRegions")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
worldWorldCloudAnalytics
kotlin.Any worldWorldCloudAnalytics()
ADMIN. Web analytics aggregate — top pages/referrers/countries, live visitors (analytics.hanzo.ai). Requires an admin-org IAM bearer.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : kotlin.Any = apiInstance.worldWorldCloudAnalytics()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#worldWorldCloudAnalytics")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#worldWorldCloudAnalytics")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
worldWorldCloudByoGpu
kotlin.Any worldWorldCloudByoGpu()
Public BYO-GPU map data — connected GPU workers by region (real counts when a service token is wired server-side, else demo-flagged). No auth.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : kotlin.Any = apiInstance.worldWorldCloudByoGpu()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#worldWorldCloudByoGpu")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#worldWorldCloudByoGpu")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
worldWorldCloudChainNodes
kotlin.Any worldWorldCloudChainNodes()
Public blockchain-network map data — per-network block height, peer count, live flag, and modeled node positions (positionsModeled:true; counts are real, geo is illustrative). No auth.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : kotlin.Any = apiInstance.worldWorldCloudChainNodes()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#worldWorldCloudChainNodes")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#worldWorldCloudChainNodes")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
worldWorldCloudFleet
kotlin.Any worldWorldCloudFleet()
ADMIN. Machines + GPUs grouped by provider/region (visor). Requires an admin-org IAM bearer; 401 without a token, 403 for non-admin.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : kotlin.Any = apiInstance.worldWorldCloudFleet()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#worldWorldCloudFleet")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#worldWorldCloudFleet")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
worldWorldCloudLlm
kotlin.Any worldWorldCloudLlm(range)
ADMIN. Platform LLM observability — per-model/per-org usage, tokens, cost, errors, trace latency (cloud /v1/admin/o11y). Requires an admin-org IAM bearer.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
val range : kotlin.String = range_example // kotlin.String |
try {
val result : kotlin.Any = apiInstance.worldWorldCloudLlm(range)
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#worldWorldCloudLlm")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#worldWorldCloudLlm")
e.printStackTrace()
}
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| range | kotlin.String | [optional] [default to Range._24h] [enum: 24h, 7d, 30d] |
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
worldWorldCloudModels
kotlin.Any worldWorldCloudModels()
Public served-model catalog + scale (from the gateway /v1/models). No auth.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : kotlin.Any = apiInstance.worldWorldCloudModels()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#worldWorldCloudModels")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#worldWorldCloudModels")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
worldWorldCloudPulse
kotlin.Any worldWorldCloudPulse()
Public platform aggregate (SaaS variant). Anonymized counts; demo-flagged unless a service token is wired server-side.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : kotlin.Any = apiInstance.worldWorldCloudPulse()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#worldWorldCloudPulse")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#worldWorldCloudPulse")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
worldWorldCloudServices
kotlin.Any worldWorldCloudServices()
ADMIN. Per-subsystem health + RED metrics (o11y). Requires an admin-org IAM bearer.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : kotlin.Any = apiInstance.worldWorldCloudServices()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#worldWorldCloudServices")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#worldWorldCloudServices")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
worldWorldCloudTraffic
kotlin.Any worldWorldCloudTraffic()
Public request-traffic arcs — country-level origin → nearest region, weight-normalized (real analytics when a service token is wired server-side, else demo-flagged). No auth.
Example
// Import classes:
//import ai.hanzo.sdk.infrastructure.*
//import ai.hanzo.sdk.models.*
val apiInstance = CloudApi()
try {
val result : kotlin.Any = apiInstance.worldWorldCloudTraffic()
println(result)
} catch (e: ClientException) {
println("4xx response calling CloudApi#worldWorldCloudTraffic")
e.printStackTrace()
} catch (e: ServerException) {
println("5xx response calling CloudApi#worldWorldCloudTraffic")
e.printStackTrace()
}
Parameters
This endpoint does not need any parameter.
Return type
Authorization
Configure bearerAuth statically:
ApiClient.accessToken = ""
Configure bearerAuth dynamically:
apiInstance.accessTokenProvider = { "" }
HTTP request headers
- Content-Type: Not defined
- Accept: application/json