مستندات AiFO احراز هویت
API Key و headerهای لازم
Bearer Token
تمام درخواستهای gateway باید header Authorization با scheme Bearer داشته باشند. کلیدهای live با پیشوند aifo_sk_live_ شروع میشوند.
Authorization: Bearer aifo_sk_live_YOUR_API_KEYBase URL یکپارچه
Chat، image و audio همگی از یک gateway استفاده میکنند. OpenAI SDK را با baseURL و apiKey تنظیم کنید — نیازی به endpoint جدا per provider نیست.
Base URL: https://api.haftominhonar.ir/v1- POST /v1/chat/completions — چت، vision، reasoning
- POST /v1/images/generations — تولید تصویر
- POST /v1/audio/speech — TTS
- POST /v1/audio/transcriptions — STT
فرمت model
در body هر درخواست، فیلد model باید provider و modelId را با slash جدا کند. این slug دقیقاً همان مقداری است که در URL صفحه مدل میبینید.
"model": "openai/gpt-5-mini"کدهای خطای HTTP
| کد | معنی |
|---|---|
| 401 Unauthorized | توکن نامعتبر، حذف شده یا فرمت header اشتباه |
| 403 Forbidden | دسترسی به مدل یا capability محدود شده |
| 402 Payment Required | موجودی کیف پول کافی نیست |
| 422 Unprocessable | body نامعتبر — model، messages یا پارامترها |
| 502 / 503 | خطای upstream provider — retry با backoff |
Best practices
- کلید per environment (dev/staging/prod) جدا بسازید
- از rotate دورهای و revoke فوری در incident استفاده کنید
- Content-Type: application/json برای JSON body
- برای multipart (STT) از form-data استفاده کنید