شروع سریع
از ثبتنام تا اولین پاسخ مدل در چند دقیقه.
۱. ورود یا ثبتنام
حساب هوشگر بسازید یا وارد شوید.
۲. شارژ کیف پول
هزینهٔ درخواستها از کیف پول ریالی کسر میشود. از صفحهٔ کیف پول موجودی را افزایش دهید.
۳. ساخت کلید 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 openaiimport 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 openaiimport 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);