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 API endpoints and 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, 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

Service	Access	Description	Reference
Collections	client.Collections()	Collection management	docs/collections.md
Competitions	client.Competitions()	Competitions & submissions	docs/competitions.md
Core	client.Core()	Core endpoints	docs/core.md
Datasets	client.Datasets()	Dataset management	docs/datasets.md
Discussions	client.Discussions()	Discussions & comments	docs/discussions.md
Models	client.Models()	Model management	docs/models.md
Organizations	client.Organizations()	Organization management	docs/organizations.md
Public	client.Public()	Public endpoints (no auth)	docs/public.md
Repositories	client.Repositories()	Repository operations	docs/repositories.md
Storage	client.Storage()	Storage & uploads	docs/storage.md
Tasks	client.Tasks()	Task management	docs/tasks.md
Users	client.Users()	User management	docs/users.md

License

Apache-2.0

---

SDK Usage Guide

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)

Field	Type	Description
message	string	Human-readable error message
status	string	fail

ErrorResponse (500 Internal Server Error)

Field	Type	Description
message	string	Internal error message
status	string	error