شروع سریع
اولین درخواست API در چند دقیقه
پیشنیازها
برای شروع با gateway AiFO به یک حساب کاربری در پلتفرم و یک API Key فعال نیاز دارید. تمام endpointها از یک base URL مشترک استفاده میکنند و با OpenAI SDK سازگار هستند.
- حساب کاربری در platform.haftominhonar.ir
- API Key با پیشوند aifo_sk_live_…
- اعتبار کافی در کیف پول (برای درخواستهای billable)
- انتخاب مدل مناسب از فهرست مدلها
ساخت API Key
از پنل AiFO وارد بخش API Keys شوید، یک کلید جدید بسازید و بلافاصله آن را در محیط امن (secret manager یا env سرور) ذخیره کنید. کلید فقط یکبار نمایش داده میشود.
Authorization: Bearer aifo_sk_live_YOUR_API_KEYانتخاب مدل
شناسه model در body باید با فرمت provider/modelId باشد — مثلاً openai/gpt-5-mini یا anthropic/claude-sonnet-4. مدلهای با badge «مستندات کامل» شامل نمونه کد، پارامترها و FAQ هستند.
اولین درخواست Chat
درخواست POST به https://api.aifoapp.ir/v1/chat/completions ارسال کنید. پاسخ JSON سازگار با OpenAI است و هزینه بر اساس token مصرفی از کیف پول کسر میشود.
curl https://api.aifoapp.ir/v1/chat/completions \
-H "Authorization: Bearer aifo_sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-5-mini",
"messages": [{"role": "user", "content": "سلام! یک جمله درباره AiFO بنویس."}]
}' خطاهای رایج
| کد | علت | راهحل |
|---|---|---|
| 401 | API Key نامعتبر یا منقضی | کلید جدید بسازید و header Authorization را بررسی کنید |
| 402 | اعتبار کیف پول کافی نیست | از پنل کیف پول را شارژ کنید |
| 404 | مدل یا endpoint اشتباه | slug مدل را از /models/ کپی کنید |
| 429 | محدودیت نرخ | Retry با backoff یا کاهش concurrency |