OpenAI API چیست؟
رابط برنامهنویسی REST برای فراخوانی مدلهای OpenAI (مثل GPT) — چت، تولید Embedding و فراخوانی توابع (Function Calling).
چرا مهم است؟
تقریباً همه ابزارهای بالادستی (Semantic Kernel، LangChain، Microsoft.Extensions.AI) در نهایت روی همین API یا معادل سازگار با آن (OpenAI-compatible) پیادهسازی میشوند؛ فهم مستقیم آن یعنی فهم چیزی که زیر همه چیز دیگر است.
تعریف
OpenAI API مجموعهای از Endpointهای REST است که با ارسال یک درخواست HTTP همراه کلید API، دسترسی به مدلهای زبانی OpenAI را میدهد. مهمترین Endpoint، chat/completions است.
فراخوانی ساده با C#
var client = new OpenAIClient(apiKey);
ChatClient chat = client.GetChatClient("gpt-4o-mini");
ChatCompletion completion = await chat.CompleteChatAsync(
"یک جمله کوتاه درباره داتنت بنویس.");
Console.WriteLine(completion.Content[0].Text);
Function Calling
مدل میتواند بهجای پاسخ متنی، تشخیص دهد باید یک تابع مشخصشده توسط شما را با چه آرگومانهایی صدا بزند — پایه ساخت Agent و اتصال LLM به داده/عملیات واقعی.
پارامترهای کلیدی
| پارامتر | نقش |
|---|---|
model |
نام مدل (gpt-4o, gpt-4o-mini, ...) |
temperature |
میزان تصادفیبودن پاسخ (۰ = قطعیتر، ۱ = خلاقانهتر) |
max_tokens |
سقف طول پاسخ |
stream |
دریافت پاسخ بهصورت تکهتکه (Streaming) برای تجربه چت زنده |
اشتباه رایج
❌ ارسال مستقیم API Key از سمت Frontend/مرورگر — کلید در Network Tab قابل مشاهده و سرقت است؛ فراخوانی همیشه باید از Backend انجام شود.
منبع و مطالعه بیشتر
خلاصه
OpenAI API مجموعه Endpointهای REST برای فراخوانی مدلهای GPT است؛ chat/completions پرکاربردترین آنهاست و Function Calling پایه ساخت Agent روی آن است. کلید API هرگز نباید از Frontend فراخوانی شود، فقط از Backend. مرجع کامل: مستندات رسمی OpenAI.