AiFO مستندات AiFO

پیش‌نیازها

برای شروع با 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.haftominhonar.ir/v1/chat/completions ارسال کنید. پاسخ JSON سازگار با OpenAI است و هزینه بر اساس token مصرفی از کیف پول کسر می‌شود.

curl https://api.haftominhonar.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 بنویس."}]
  }'
import requests

response = requests.post(
    "https://api.haftominhonar.ir/v1/chat/completions",
    headers={"Authorization": "Bearer aifo_sk_live_YOUR_API_KEY"},
    json={
        "model": "openai/gpt-5-mini",
        "messages": [{"role": "user", "content": "سلام! یک جمله درباره AiFO بنویس."}],
    },
)
print(response.json()["choices"][0]["message"]["content"])
const response = await fetch("https://api.haftominhonar.ir/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: "Bearer aifo_sk_live_YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "openai/gpt-5-mini",
    messages: [{ role: "user", content: "سلام! یک جمله درباره AiFO بنویس." }],
  }),
});
const data = await response.json();
console.log(data.choices[0].message.content);
const OpenAI = require("openai");

const client = new OpenAI({
  baseURL: "https://api.haftominhonar.ir/v1",
  apiKey: "aifo_sk_live_YOUR_API_KEY",
});

async function main() {
  const completion = await client.chat.completions.create({
    model: "openai/gpt-5-mini",
    messages: [{ role: "user", content: "سلام! یک جمله درباره AiFO بنویس." }],
  });
  console.log(completion.choices[0].message.content);
}

main();

خطاهای رایج

کدعلتراه‌حل
401API Key نامعتبر یا منقضیکلید جدید بسازید و header Authorization را بررسی کنید
402اعتبار کیف پول کافی نیستاز پنل کیف پول را شارژ کنید
404مدل یا endpoint اشتباهslug مدل را از /models/ کپی کنید
429محدودیت نرخRetry با backoff یا کاهش concurrency

گام بعدی