Files
zeekayandHanzo Dev b55332704a feat: Hanzo Cloud SDK for Kotlin (generated from OpenAPI v8.0.0)
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]>
2026-07-25 07:10:32 -07:00

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

PricingCloudResponse

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

PricingFullPricingResponse

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

PricingBlockStoragePricing

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

PricingCloudPlansResponse

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

PricingCloudRegionsResponse

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

kotlin.Any

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

kotlin.Any

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

kotlin.Any

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

kotlin.Any

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

kotlin.Any

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

kotlin.Any

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

kotlin.Any

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

kotlin.Any

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

kotlin.Any

Authorization

Configure bearerAuth statically:

ApiClient.accessToken = ""

Configure bearerAuth dynamically:

apiInstance.accessTokenProvider = { "" }

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json