اتصال ابزارهای برنامه‌نویسی به هوشواره: API سازگار با استاندارد OpenAI

بیشتر ابزارهای اکوسیستم هوش مصنوعی — از کتابخانه‌های Python و JavaScript تا ادیتورها و ایجنت‌های کدنویسی — با یک قرارداد مشترک حرف می‌زنند. هوشواره همان قرارداد را ارائه می‌دهد؛ یعنی کدِ فعلی‌تان بدون بازنویسی، فقط با یک آدرس و یک کلیدِ جدید، به ده‌ها مدل وصل می‌شود — با پرداخت تومانی.

گام ۱: ساخت کلید

از پنل ← کلید API یک کلید بسازید. برای هر پروژه کلیدِ جداگانه بسازید تا مصرفِ هرکدام را تفکیک ببینید. برای هر کلید می‌توانید:

• مدل را سنجاق کنید — کلید فقط با همان مدل کار کند؛
• سقف مصرف بگذارید — کل یا ماهانه؛ خیال‌تان از هزینه راحت باشد؛
• منبع اعتبار را انتخاب کنید — کیف پول یا بسته‌ی API جداگانه.

گام ۲: دو خط تغییر در کد

نمونه‌ی Python (کتابخانه‌ی استاندارد سازگار با OpenAI):

from openai import OpenAI

client = OpenAI(
    base_url="https://chat.blzn.ai/v1",
    api_key="کلیدِ شما",
)
resp = client.chat.completions.create(
    model="شناسه‌ی مدل",
    messages=[{"role": "user", "content": "سلام!"}],
)
print(resp.choices[0].message.content)

در JavaScript هم دقیقاً همین دو پارامتر کافی است. فهرست شناسه‌ی مدل‌ها را از کاتالوگ مدل‌ها یا endpoint استانداردِ /v1/models بگیرید. جزئیات و نمونه‌های بیشتر در صفحه‌ی توسعه‌دهندگان آمده است.

الگوی حرفه‌ای: برای هر محیط (توسعه، تست، تولید) و هر محصول، یک کلیدِ جدا با سقفِ جدا. اگر کلیدی لو رفت یا مصرفش عجیب شد، همان یکی را باطل می‌کنید و بقیه سالم می‌مانند.

گام ۳: اتصال ابزارها — نمونه: OpenCode

ابزارهای ایجنتِ کدنویسی مثل OpenCode هم با همین قرارداد کار می‌کنند: در تنظیماتِ ارائه‌دهنده، آدرس پایه را به هوشواره بدهید و کلیدتان را وارد کنید — راهنمای کامل و پیکربندیِ آماده‌ی OpenCode را در صفحه‌ی کلید API گذاشته‌ایم که با یک کلیک کپی می‌شود.

مصرف و هزینه، شفاف

گزارشِ هر کلید — تعداد درخواست، توکن مصرفی و هزینه — در پنل قابل مشاهده است. هزینه‌ی API از همان منطقِ شفافِ محصول پیروی می‌کند: بر اساس توکنِ واقعیِ مصرف‌شده، بدون هزینه‌ی پنهان. اگر مصرف بالایی دارید، بسته‌های API صرفه‌ی بهتری دارند.

اتصالِ خوب، اتصالی است که فراموشش می‌کنید: یک‌بار درست پیکربندی کنید، سقف بگذارید، و بگذارید گزارش‌ها به‌جای شما نگرانِ هزینه باشند.

— تیم هوشواره

عیب‌یابی سریع

• 401: کلید اشتباه یا باطل‌شده — کلید را از پنل چک کنید.
• 404 مدل: شناسه‌ی مدل را از /v1/models بردارید؛ حروف کوچک/بزرگ مهم است.
• 429: نرخِ درخواست یا سقفِ کلید پر شده — سقف را در پنل بالا ببرید یا کمی صبر کنید.

وضعیت لحظه‌ای سرویس هم همیشه در صفحه‌ی وضعیت در دسترس است. برای آشنایی عمیق‌تر با خودِ مفهوم مدل‌های زبانی، این مدخل ویکی‌پدیا شروع خوبی است.