aiozai

AIOZ AI Go Client

Go client SDK for the AIOZ AI API. Auto-generated from the OpenAPI specification with full type safety.

Features

• Full type safety for all 218+ API endpoints and 578+ models
• API Key configured once at client creation
• Automatic retry with exponential backoff for transient failures
• Configurable timeouts for standard and upload operations
• Domain-grouped service access (Models, Datasets, Competitions, etc.)
• Zero external HTTP dependencies beyond the Go standard library

Installation

go get github.com/AIOZNetwork/aioz-ai-go-client@latest

Requires Go 1.22 or later.

Quick Start

package main

import (
    "context"
    "fmt"
    "log"
    "os"

    aiozai "github.com/AIOZNetwork/aioz-ai-go-client"
)

func main() {
    client, err := aiozai.NewClient(
        aiozai.WithAPIKey(os.Getenv("AIOZ_AI_API_KEY")),
    )
    if err != nil {
        log.Fatal(err)
    }

    ctx := context.Background()
    models := client.Models()
    _ = models // use models.Model, models.Training, etc.
    fmt.Println("client ready", ctx)
}

Error Handling

import "errors"

var apiErr *aiozai.AiozAPIError
if errors.As(err, &apiErr) {
    fmt.Printf("[%d] %s — %s %s\n", apiErr.StatusCode, apiErr.Message, apiErr.Method, apiErr.Endpoint)
}

Configuration

import "time"

client, err := aiozai.NewClient(
    aiozai.WithAPIKey(os.Getenv("AIOZ_AI_API_KEY")),
    aiozai.WithBaseURL("https://api.aiozai.network/api/v1"),
    aiozai.WithTimeout(60 * time.Second),
    aiozai.WithRetryConfig(&aiozai.RetryConfig{
        MaxRetries: 5,
        BaseDelay:  2 * time.Second,
        MaxDelay:   60 * time.Second,
    }),
)

Service Groups

License

Apache-2.0

SDK Usage Guide

Auto-generated from swagger/sdk.json — do not edit this section manually. Re-generate with make guide from the repo root.

Authentication Setup

Initialize the client once with your API key and reuse it across all calls:

import (
    "os"
    aiozai "github.com/AIOZNetwork/aioz-ai-go-client"
)

client, err := aiozai.NewClient(
    aiozai.WithAPIKey(os.Getenv("AIOZ_AI_API_KEY")),
)
if err != nil {
    log.Fatal(err)
}

// Use client.Models(), client.Datasets(), etc.

Obtain your API key from the AIOZ AI dashboard.

Common Response Types

These types appear in error responses across all endpoints.

FailResponse (400 Bad Request)

ErrorResponse (500 Internal Server Error)