C# SDK

export HINOW_API_KEY="hi_sua_chave_aqui"

using Hinow;

// With no arguments, the client reads the key from HINOW_API_KEY.
using var client = new HinowClient();

var answer = await client.Chat.Completions.CreateAsync(new ChatCompletionRequest
{
    Model = "hinow/himax",
    Messages =
    {
        new Message("system", "You answer in English."),
        new Message("user", "What is an API? Answer in one paragraph."),
    },
});

// Message.Text gives you the text. Message.Content holds the raw value.
Console.WriteLine(answer.Choices[0].Message.Text);

var uso = answer.Usage!;
Console.WriteLine($"\ninput: {uso.PromptTokens} · output: {uso.CompletionTokens}");

builder.Services.AddHttpClient<HinowClient>((http, _) =>
    new HinowClient(apiKey: null, baseUrl: null, timeout: null, httpClient: http));

using Hinow;

using var client = new HinowClient();

var stream = client.Chat.Completions.CreateStreamAsync(new ChatCompletionRequest
{
    Model = "hinow/hinova",
    Messages = { new Message("user", "Write three lines about the sea at dawn.") },
});

await foreach (var chunk in stream)
{
    // Note the Delta: each chunk carries the new fragment, not the whole answer.
    Console.Write(chunk.Choices.Count > 0 ? chunk.Choices[0].Delta.Content : "");
}

Console.WriteLine();

using Hinow;

using var client = new HinowClient();

// Answers on the spot: there is no job to follow.
var search = await client.Tools.SearchAsync(
    "best beaches in northeast Brazil",
    SearchType.Search,
    country: "br",
    lang: "pt-br");

foreach (var item in search.Results)
{
    Console.WriteLine($"{item.Position}. {item.Title}");
    Console.WriteLine($"   {item.Url}");
}

Console.WriteLine($"\n{search.Results.Count} results · US$ {search.Cost}");

using Hinow;

using var client = new HinowClient();

// The crawl takes a while, so it runs as a job. This method waits for you.
var job = await client.Tools.WebsiteContactsAndWaitAsync(
    new[] { "https://www.teclia.com" },
    maxDepth: 2,
    maxLinksPerPage: 10);

Console.WriteLine($"status: {job.Status} · US$ {job.Cost}"
    + (job.Cached == true ? " (from cache)" : ""));
Console.WriteLine();

// Each item carries the type, the value and the exact page it was found on.
foreach (var item in job.Result!.Items)
{
    if (item.Type == "social")
    {
        Console.WriteLine($"{item.Platform,-10}{item.Url}");
    }
    else
    {
        Console.WriteLine($"{item.Type,-10}{item.Value}");
        Console.WriteLine($"{"",-10}em {item.SourceUrl}");
    }
}

using System.Text.Json;
using Hinow;

using var client = new HinowClient();

// Your real function: a dictionary here, just for the example.
var orders = new Dictionary<string, object>
{
    ["A-1001"] = new { status = "delivered", delivered = "2026-08-02" },
    ["A-1002"] = new { status = "in transit", estimated = "2026-08-12" },
};

// 1. The assistant: model, instructions and the functions it may call.
var assistant = await client.Beta.Assistants.CreateAsync(new AssistantRequest
{
    Model = "hinow/himax",
    Name = "Support",
    Instructions = "You answer questions about orders. Check the tool before stating any status.",
    Tools = new List<Tool>
    {
        Tool.CreateFunction(
            "get_order",
            "Look up an order by its code.",
            new Dictionary<string, object>
            {
                ["type"] = "object",
                ["properties"] = new Dictionary<string, object>
                {
                    ["code"] = new Dictionary<string, object>
                    {
                        ["type"] = "string",
                        ["description"] = "Order code, e.g. A-1001",
                    },
                },
                ["required"] = new[] { "code" },
            }),
    },
});

// 2. The conversation and the question.
var thread = await client.Beta.Threads.CreateAsync();
await client.Beta.Threads.Messages.CreateAsync(thread.Id, "Has order A-1002 arrived?");

// 3. Run it and wait.
var run = await client.Beta.Threads.Runs.CreateAndPollAsync(thread.Id, assistant.Id);

// 4. While the model asks for functions, run them and hand the result back.
while (run.Status == "requires_action")
{
    var outputs = new List<ToolOutput>();

    foreach (var call in run.RequiredAction!.SubmitToolOutputs!.ToolCalls)
    {
        var callArgs = JsonSerializer.Deserialize<Dictionary<string, string>>(call.Function.Arguments)!;
        var code = callArgs["code"];
        Console.WriteLine($"-> the model called {call.Function.Name}({code})");

        var order = orders.TryGetValue(code, out var achado)
            ? achado
            : new { error = "order not found" };

        outputs.Add(new ToolOutput(call.Id, JsonSerializer.Serialize(order)));
    }

    await client.Beta.Threads.Runs.SubmitToolOutputsAsync(thread.Id, run.Id, outputs);
    run = await client.Beta.Threads.Runs.PollAsync(thread.Id, run.Id);
}

// 5. The final answer is the last message on the thread.
var messages = await client.Beta.Threads.Messages.ListAsync(thread.Id, limit: 1, order: "desc");
Console.WriteLine($"\n{messages.Data[0].Text}");

await client.Beta.Assistants.DeleteAsync(assistant.Id);

using Hinow;

using var client = new HinowClient();

// 1. Upload the document.
var file = await client.Files.CreateAsync("returns-policy.txt");
Console.WriteLine($"file: {file.Id} ({file.Bytes} bytes)");

// 2. Create the store and attach the file to it.
var base_ = await client.VectorStores.CreateAsync(name: "Support base");
await client.VectorStores.Files.CreateAsync(base_.Id, file.Id);
Console.WriteLine($"store: {base_.Id}");

// 3. Indexing is asynchronous. Searching before it finishes returns nothing
//    at all, with no error, so PollAsync waits for it.
var indexado = await client.VectorStores.Files.PollAsync(base_.Id, file.Id);
Console.WriteLine($"indexing: {indexado.Status}");

// 4. Search by meaning, not by exact word.
var hits = await client.Rag.SearchAsync(
    "How many days do I have to return an item?",
    ragId: base_.Id,
    topK: 3);

Console.WriteLine();
foreach (var achado in hits.Results)
{
    Console.WriteLine($"{achado.Score:F2}  {achado.Source}");
    var excerpt = achado.Text.Replace("\n", " ");
    Console.WriteLine($"      {excerpt[..Math.Min(110, excerpt.Length)]}…");
}

using Hinow;

using var client = new HinowClient();

try
{
    await client.Chat.Completions.CreateAsync(new ChatCompletionRequest
    {
        Model = "himax",  // the hinow/ prefix is missing
        Messages = { new Message("user", "Olá") },
    });
}
catch (HinowAuthenticationException)
{
    Console.WriteLine("Invalid or expired key. Check HINOW_API_KEY.");
}
catch (HinowNotFoundException e)
{
    Console.WriteLine($"Not found: {e.Message}");
}
catch (HinowInvalidRequestException e)
{
    Console.WriteLine($"Invalid request: {e.Message}");
}
catch (HinowRateLimitException)
{
    Console.WriteLine("Rate limited. The SDK already retried; wait a moment.");
}
catch (HinowConnectionException e)
{
    // Nothing reached the API, so nothing was charged.
    Console.WriteLine($"Sem answer da API: {e.Message}");
}
catch (HinowException e)
{
    // Safety net: any other error the API reported.
    Console.WriteLine($"Error {e.StatusCode}: {e.Message}");
}

using Hinow;

using var client = new HinowClient();

// Account credit, in US dollars.
var balance = await client.GetBalanceAsync();
Console.WriteLine($"balance: US$ {balance.Amount:F2}\n");

// One specific model. The id is namespaced: hinow/himax, not himax.
var model = await client.Models.RetrieveAsync("hinow/himax");
Console.WriteLine($"{model.Name} ({model.Id})");
Console.WriteLine($"categories: {string.Join(", ", model.Category)}");

using var client = new HinowClient(
    apiKey: Environment.GetEnvironmentVariable("HINOW_API_KEY"),  // ou use a variável
    baseUrl: "https://api.hinow.ai",                              // ou HINOW_BASE_URL
    timeout: TimeSpan.FromSeconds(120),
    httpClient: null,
    maxRetries: 2);                                               // repete 429 e 5xx