شروع سریع

از ثبت‌نام تا اولین پاسخ مدل در چند دقیقه.

۱. ورود یا ثبت‌نام

حساب هوشگر بسازید یا وارد شوید.

۲. شارژ کیف پول

هزینهٔ درخواست‌ها از کیف پول ریالی کسر می‌شود. از صفحهٔ کیف پول موجودی را افزایش دهید.

۳. ساخت کلید API

از صفحهٔ کلیدهای API کلید بسازید. کلید فقط یک بار نمایش داده می‌شود.

کلید را در کد فرانت‌اند یا مخزن گیت قرار ندهید؛ در متغیر محیطی HOOSHGAR_API_KEY نگه دارید.

۴. انتخاب مدل

شناسهٔ مدل را از کاتالوگ مدل‌ها کپی کنید. در نمونه‌های زیر از openai/gpt-4o به‌عنوان مثال استفاده شده است.

۵. اولین درخواست با cURL

curl https://api.hooshgar.ir/v1/chat/completions \
  -H "Authorization: Bearer $HOOSHGAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "سلام! خودت را معرفی کن."}]
  }'

۶. Python

pip install openai
import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["HOOSHGAR_API_KEY"], base_url="https://api.hooshgar.ir/v1")
r = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "سلام!"}],
)
print(r.choices[0].message.content)

۷. JavaScript

npm install openai
import OpenAI from "openai";

const client = new OpenAI({ apiKey: process.env.HOOSHGAR_API_KEY, baseURL: "https://api.hooshgar.ir/v1" });
const r = await client.chat.completions.create({
  model: "openai/gpt-4o",
  messages: [{ role: "user", content: "سلام!" }],
});
console.log(r.choices[0].message.content);

۸. قدم بعدی