<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.github.hinow-ai</groupId>
    <artifactId>sdk-java</artifactId>
    <version>1.0.1</version>
</dependency>

repositories {
    maven { url 'https://jitpack.io' }
}

implementation 'com.github.hinow-ai:sdk-java:1.0.1'

import ai.hinow.Hinow;

Hinow client = Hinow.builder()
    .apiKey("your-api-key")
    .build();

export HINOW_API_KEY=your-api-key

// API key loaded automatically from environment
Hinow client = Hinow.builder().build();

Hinow client = Hinow.builder()
    .apiKey("your-api-key")
    .baseUrl("https://api.hinow.ai")
    .timeout(Duration.ofSeconds(120))
    .maxRetries(3)
    .build();

import ai.hinow.Hinow;
import ai.hinow.models.*;

public class Main {
    public static void main(String[] args) {
        Hinow client = Hinow.builder().build();

        ChatCompletionResponse response = client.chat().completions().create(
            ChatCompletionRequest.builder()
                .model("gpt-4o")
                .messages(List.of(
                    Message.system("You are a helpful assistant."),
                    Message.user("What is the capital of France?")
                ))
                .temperature(0.7)
                .maxTokens(1024)
                .build()
        );

        System.out.println(response.getChoices().get(0).getMessage().getContent());
    }
}

// OpenAI GPT-4o
ChatCompletionResponse response = client.chat().completions().create(
    ChatCompletionRequest.builder()
        .model("gpt-4o")
        .messages(List.of(Message.user("Explain machine learning")))
        .build()
);

// Anthropic Claude
ChatCompletionResponse response = client.chat().completions().create(
    ChatCompletionRequest.builder()
        .model("claude-sonnet-4-20250514")
        .messages(List.of(Message.user("Explain machine learning")))
        .build()
);

// DeepSeek
ChatCompletionResponse response = client.chat().completions().create(
    ChatCompletionRequest.builder()
        .model("deepseek-ai/deepseek-v3.2")
        .messages(List.of(Message.user("Explain machine learning")))
        .build()
);

client.chat().completions().createStream(
    ChatCompletionRequest.builder()
        .model("gpt-4o")
        .messages(List.of(Message.user("Write a story about a robot")))
        .build()
).forEach(chunk -> {
    String content = chunk.getChoices().get(0).getDelta().getContent();
    if (content != null) {
        System.out.print(content);
    }
});

CompletableFuture<ChatCompletionResponse> future = client.chat().completions().createAsync(
    ChatCompletionRequest.builder()
        .model("gpt-4o")
        .messages(List.of(Message.user("Hello!")))
        .build()
);

future.thenAccept(response -> {
    System.out.println(response.getChoices().get(0).getMessage().getContent());
});

ChatCompletionResponse response = client.chat().completions().create(
    ChatCompletionRequest.builder()
        .model("gpt-4o")
        .messages(List.of(
            Message.user("What is the weather in New York?")
        ))
        .tools(List.of(
            Tool.builder()
                .type("function")
                .function(FunctionDefinition.builder()
                    .name("get_weather")
                    .description("Get the current weather for a location")
                    .parameters(Map.of(
                        "type", "object",
                        "properties", Map.of(
                            "location", Map.of(
                                "type", "string",
                                "description", "City and state, e.g., New York, NY"
                            ),
                            "unit", Map.of(
                                "type", "string",
                                "enum", List.of("celsius", "fahrenheit")
                            )
                        ),
                        "required", List.of("location")
                    ))
                    .build())
                .build()
        ))
        .toolChoice("auto")
        .build()
);

List<ToolCall> toolCalls = response.getChoices().get(0).getMessage().getToolCalls();
if (toolCalls != null) {
    for (ToolCall toolCall : toolCalls) {
        System.out.println("Function: " + toolCall.getFunction().getName());
        System.out.println("Arguments: " + toolCall.getFunction().getArguments());
    }
}

ImageResponse response = client.images().generate(
    ImageGenerateRequest.builder()
        .model("black-forest-labs/flux-1-schnell")
        .prompt("A programmer cat wearing glasses, cartoon style")
        .size("1024x1024")
        .quality("hd")
        .build()
);

for (ImageData image : response.getData()) {
    System.out.println("URL: " + image.getUrl());
}

EmbeddingResponse response = client.embeddings().create(
    EmbeddingRequest.builder()
        .model("BAAI/bge-base-en-v1.5")
        .input("Machine learning is fascinating")
        .build()
);

List<Float> embedding = response.getData().get(0).getEmbedding();
System.out.println("Dimensions: " + embedding.size());

import ai.hinow.exceptions.*;

try {
    ChatCompletionResponse response = client.chat().completions().create(
        ChatCompletionRequest.builder()
            .model("nonexistent-model")
            .messages(List.of(Message.user("Hello")))
            .build()
    );
} catch (AuthenticationException e) {
    System.out.println("Invalid API key");
} catch (InsufficientBalanceException e) {
    System.out.println("Insufficient balance");
} catch (RateLimitException e) {
    System.out.println("Rate limit reached. Retry after: " + e.getRetryAfter());
} catch (BadRequestException e) {
    System.out.println("Invalid request: " + e.getMessage());
} catch (HinowException e) {
    System.out.println("API Error [" + e.getStatusCode() + "]: " + e.getMessage());
}