Go

go get github.com/hanzoai/go-sdk/v8

import hanzoai "github.com/hanzoai/go-sdk/v8"

The package name is hanzoai and it sits at the module root, beside go.mod — which is why the import path and the package identifier differ. The module path carries its major, /v8, as Go requires of any release past v1: without it, go get github.com/hanzoai/go-sdk resolves v1.0.5, an older client whose methods are spelled differently. The source lives at hanzo-go/sdk.

Set the key:

export HANZO_API_KEY="sk-..."   # from platform.hanzo.ai

The shape

One configuration, one client, one service field per capability:

package main

import (
    "context"
    "fmt"
    "os"

    hanzoai "github.com/hanzoai/go-sdk/v8"
)

func main() {
    cfg := hanzoai.NewConfiguration()
    cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
    client := hanzoai.NewAPIClient(cfg)

    models, _, err := client.AiAPI.GetModels(context.Background()).Execute()
    if err != nil {
        panic(err)
    }
    fmt.Println(models)
}

Every operation is a request builder: the method takes a context.Context and returns a request you finish with .Execute(), which answers the decoded value, the *http.Response and an error. Optional parameters are setters on the request in between.

The service field is the capability — client.AiAPI, client.BillingAPI, client.KmsAPI — and the method is the operation. The reference prints the pair for each one.

Resources

• github.com/hanzoai/go-sdk/v8 on pkg.go.dev
• Source — hanzo-go/sdk
• Every /v1 operation →