استفاده از API هوش مصنوعی در C# و .NET با کتابخانهٔ رسمی OpenAI

dotnet add package OpenAI

export HIBANA_API_KEY=YOUR_API_KEY

$env:HIBANA_API_KEY = "YOUR_API_KEY"

#:package OpenAI@2.14.0 using System.ClientModel;using System.Text.Json;using OpenAI;using OpenAI.Chat; var client = new ChatClient(    model: "gpt-5-nano",    credential: new ApiKeyCredential(Environment.GetEnvironmentVariable("HIBANA_API_KEY")!),    options: new OpenAIClientOptions    {        Endpoint = new Uri("https://api-ai.hibanacloud.ir/v1")    }); List<ChatMessage> messages =[    new SystemChatMessage("پاسخ را کوتاه و به فارسی بده."),    new UserChatMessage("زبان C# در یک جمله چیست؟")]; #pragma warning disable OPENAI001 // ReasoningEffortLevel هنوز در SDK آزمایشی استvar options = new ChatCompletionOptions{    ReasoningEffortLevel = ChatReasoningEffortLevel.Low};#pragma warning restore OPENAI001 ClientResult<ChatCompletion> result = await client.CompleteChatAsync(messages, options);ChatCompletion completion = result.Value; Console.WriteLine(completion.Content[0].Text);Console.WriteLine($"input: {completion.Usage.InputTokenCount}, output: {completion.Usage.OutputTokenCount}"); // cost_rial فیلد اضافهٔ هیبانا است و در کلاس‌های SDK نیست؛ از JSON خام پاسخ خوانده می‌شودusing var json = JsonDocument.Parse(result.GetRawResponse().Content);Console.WriteLine($"cost_rial: {json.RootElement.GetProperty("usage").GetProperty("cost_rial")}");

C# یک زبان برنامه‌نویسی شیءگرا و سطح‌بالا است که برای توسعه نرم‌افزار با پلتفرم .NET طراحی شده و امکاناتی مانند مدیریت حافظه، همزمانی و کتابخانه‌های گسترده را ارائه می‌دهد.input: 30, output: 130cost_rial: 249

#:package OpenAI@2.14.0 using System.ClientModel;using OpenAI;using OpenAI.Chat; var client = new ChatClient(    model: "gpt-5-nano",    credential: new ApiKeyCredential(Environment.GetEnvironmentVariable("HIBANA_API_KEY")!),    options: new OpenAIClientOptions { Endpoint = new Uri("https://api-ai.hibanacloud.ir/v1") }); #pragma warning disable OPENAI001var options = new ChatCompletionOptions { ReasoningEffortLevel = ChatReasoningEffortLevel.Low };#pragma warning restore OPENAI001 List<ChatMessage> history = [new SystemChatMessage("کوتاه و به فارسی پاسخ بده.")]; foreach (string question in new[] { "فقط یک نام کوتاه برای یک کتاب‌فروشی پیشنهاد بده.", "چرا این نام را انتخاب کردی؟ در یک جمله." }){    history.Add(new UserChatMessage(question));    ChatCompletion completion = await client.CompleteChatAsync(history, options);    history.Add(new AssistantChatMessage(completion)); // پاسخ مدل به تاریخچه اضافه می‌شود    Console.WriteLine($"> {question}\n{completion.Content[0].Text}\n");}

#:package OpenAI@2.14.0 using System.ClientModel;using OpenAI;using OpenAI.Chat; var client = new ChatClient(    model: "gpt-5-nano",    credential: new ApiKeyCredential(Environment.GetEnvironmentVariable("HIBANA_API_KEY")!),    options: new OpenAIClientOptions    {        Endpoint = new Uri("https://api-ai.hibanacloud.ir/v1")    }); #pragma warning disable OPENAI001var options = new ChatCompletionOptions { ReasoningEffortLevel = ChatReasoningEffortLevel.Low };#pragma warning restore OPENAI001 AsyncCollectionResult<StreamingChatCompletionUpdate> updates = client.CompleteChatStreamingAsync(    [new UserChatMessage("در دو جملهٔ کوتاه بگو async/await در C# چه کمکی می‌کند.")],    options); await foreach (StreamingChatCompletionUpdate update in updates){    foreach (ChatMessageContentPart part in update.ContentUpdate)    {        Console.Write(part.Text);    }     if (update.Usage is not null)    {        Console.WriteLine($"\n\ninput: {update.Usage.InputTokenCount}, output: {update.Usage.OutputTokenCount}");    }}

async/await کار با عملیات غیرهمزمان را به صورت کد همزمان اما غیر بلاک‌کننده ساده می‌کند و از مسدود شدن thread اصلی جلوگیری می‌کند. با استفاده از Taskها مدیریت ادامه‌ی اجرا به‌سادگی انجام می‌شود و کد روشن‌تر و قابل نگهداری‌تر می‌شود. input: 26, output: 204

#:package OpenAI@2.14.0 using System.ClientModel;using System.ClientModel.Primitives;using System.Text.Json;using OpenAI;using OpenAI.Chat; string model = args.Length > 0 ? args[0] : "gpt-5-nano"; var client = new ChatClient(    model: model,    credential: new ApiKeyCredential(Environment.GetEnvironmentVariable("HIBANA_API_KEY")!),    options: new OpenAIClientOptions    {        Endpoint = new Uri("https://api-ai.hibanacloud.ir/v1"),        RetryPolicy = new ClientRetryPolicy(maxRetries: 2), // پیش‌فرض ۳ تلاش اضافه است        NetworkTimeout = TimeSpan.FromSeconds(60)    }); try{    ChatCompletion completion = await client.CompleteChatAsync("فقط بنویس: سلام");    Console.WriteLine($"پاسخ: {completion.Content[0].Text}");}catch (ClientResultException ex){    // بدنهٔ خطای هیبانا: {"error": {"message": "...", "code": "..."}}    string? code = null, message = null;    string? body = ex.GetRawResponse()?.Content.ToString();    if (!string.IsNullOrEmpty(body))    {        using var json = JsonDocument.Parse(body);        if (json.RootElement.TryGetProperty("error", out var error))        {            code = error.TryGetProperty("code", out var c) ? c.ToString() : null;            message = error.TryGetProperty("message", out var m) ? m.GetString() : null;        }    }     string hint = ex.Status switch    {        400 => "درخواست یا نام مدل را بررسی کنید",        401 => "کلید یا هدر Authorization را بررسی کنید",        402 => "موجودی کیف پول یا سقف بودجهٔ کلید",        429 => "کمی صبر کنید و دوباره بفرستید",        _ => "خطای سرور؛ بعداً دوباره امتحان کنید"    };    Console.WriteLine($"{ex.Status}: {code} → {hint}");    if (message is not null) Console.WriteLine($"   {message}");}

dotnet new web -n HibanaApicd HibanaApidotnet add package OpenAI

 using System.ClientModel;using OpenAI;using OpenAI.Chat; var builder = WebApplication.CreateBuilder(args); // ChatClient را یک بار بسازید و همه‌جا از همان استفاده کنیدbuilder.Services.AddSingleton(new ChatClient(    model: "gpt-5-nano",    credential: new ApiKeyCredential(builder.Configuration["HIBANA_API_KEY"]!),    options: new OpenAIClientOptions { Endpoint = new Uri("https://api-ai.hibanacloud.ir/v1") })); var app = builder.Build(); app.MapPost("/ask", async (AskRequest request, ChatClient chat) =>{    ChatCompletion completion = await chat.CompleteChatAsync(        new SystemChatMessage("کوتاه و به فارسی پاسخ بده."),        new UserChatMessage(request.Question));    return Results.Ok(new { answer = completion.Content[0].Text });}); app.Run(); record AskRequest(string Question);

curl -X POST http://localhost:5081/ask \  -H "Content-Type: application/json" \  -d '{"question":"ASP.NET Core در یک جمله چیست؟"}'

{"answer":"ASP.NET Core یک فریمورک متن‌باز و کراس‌پلتفرم با کارایی بالا است که برای ساخت برنامه‌های وب، وب API و میکروسرویس‌ها با استفاده از پلتفرم .NET طراحی شده است."}