با یک کلید، SDK
هر مدل را خودتان انتخاب کنید.
درخواست‌ها و پاسخ‌های API هویدای مانند رایج‌ترین APIهای گفتگو است. نشانی پایه (Base URL) و کلید را تنظیم می‌کنید، در هر درخواست شناسهٔ مدل را می‌نویسید و هزینهٔ هر کلید را جدا می‌بینید.
- نشانی پایه و کلیداین دو مقدار و شناسهٔ مدل را تنظیم کنید؛ سازگاری مسیرها و پارامترها را در مستندات ببینید.
- مدلفقط با نوشتن شناسهٔ مدل در هر درخواست؛ بقیهٔ کد شما تغییر نمی‌کند.
- هزینههزینهٔ هر کلید جدا ثبت می‌شود و از کیف پول ریالی کم می‌شود.
import requests -BASE = "https://api.example.com/v1"-API_KEY = "sk-..."+BASE = "https://hoveydai.ir/v1"+API_KEY = "hvd_..." reply = requests.post( f"{BASE}/chat/completions", headers={"Authorization": f"Bearer {API_KEY}"}, json={"model": "nvidia-nemotron-3-nano-omni-30b-a3b-reasoning-free", "messages": [...]}, # any model id from the list)
از کلید تا اولین پاسخ، سه قدم.
کلید بسازید
در پنل برای هر برنامه یک کلید جدا بسازید تا هزینهٔ آن جدا دیده شود.
نشانی پایه را عوض کنید
در تنظیمات کلاینت (SDK) نشانی پایه و کلید را بگذارید، شناسهٔ مدل را از فهرست بردارید و پارامترهای پشتیبانی‌شده را بررسی کنید. SDK یا کتابخانهٔ توسعه، اتصال برنامهٔ شما به API را ساده‌تر می‌کند.
درخواست بفرستید
شناسهٔ مدل را بنویسید و بفرستید. پاسخ در قالب رایج chat completions برمی‌گردد و هزینه در مصرف همان کلید ثبت می‌شود.
هر کلاینت HTTP، در هر زبانی.
با یک درخواست HTTP ساده، مثلاً با requests در پایتون و fetch در جاوااسکریپت، با استریم و بدون آن. پشتیبانی به مسیرهای chat/completions و models و پارامترهای مستندشده محدود است؛ قابلیت‌های دیگر، مثل embeddings یا ابزارها (tools)، پشتیبانی نمی‌شوند.
import requests BASE = "https://hoveydai.ir/v1"تغییرAPI_KEY = "hvd_..." reply = requests.post( f"{BASE}/chat/completions", headers={"Authorization": f"Bearer {API_KEY}"}, json={"model": "nvidia-nemotron-3-nano-omni-30b-a3b-reasoning-free", "messages": [{"role": "user", "content": "hello"}]},)print(reply.json()["choices"][0]["message"]["content"])
مدل عوض می‌شود؛ مسیر اتصال یکی است.
نام مدل را در درخواست تغییر دهید. کلید، گزارش مصرف و اعتبار حساب در همین پلتفرم مدیریت می‌شوند.
- یک کلید برای همهٔ مدل‌هابرای رفتن به مدل دیگر فقط نام مدل را در درخواست عوض می‌کنید، نه کتابخانه را.
- یک کیف پول ریالیکیف پول را با ریال شارژ می‌کنید و به کارت بین‌المللی نیازی ندارید.
- یک جدول قیمتقیمت ورودی و خروجی هر مدل را پیش از استفاده می‌بینید.
base_url="https://hoveydai.ir/v1"مدل و هزینه را با هم بررسی کنید.
مدل را انتخاب کنید؛ محاسبه‌گر پایین با همان انتخاب هماهنگ می‌شود.
برآورد هزینهٔ ماهانه با مدل انتخابی
فرض: هر پیام حدود ۸۰۰ توکن ورودی و ۶۰۰ توکن خروجی. ماه ۳۰ روز. قیمت‌ها از فهرست زنده‌اند.
اگر به محدودیتی برسید، دلیلش را می‌بینید.
خطاها در قالب JSON استاندارد برمی‌گردند؛ هر خطا شامل message، type، param، code و request_id است و دلیل خطا و کار بعدی را مشخص می‌کند. فهرست نهایی کدها در مستندات است.
| کد | یعنی | کار شما |
|---|---|---|
| 400 | درخواست نامعتبر | بدنه و پارامترها را با مستندات بسنجید. |
| 401 | کلید نامعتبر یا ارسال‌نشده | سرآیند Authorization و کلید را بررسی کنید. |
| 402 | اعتبار کافی نیست | اعتبار و سقف طرح را بررسی کنید؛ جزئیات خطای HTTP 402 در مستندات آمده است. |
| 404 | مدل پیدا نشد | شناسهٔ مدل را از فهرست مدل‌ها بردارید. |
| 429 | تعداد درخواست‌ها از سقف گذشته | کمی صبر کنید و دوباره بفرستید؛ سقف طرح‌تان را ببینید. |
| 5xx | خطا از سمت ما یا ارائه‌دهنده | چند ثانیه بعد دوباره امتحان کنید. |
- طرح فعالسقف روزانه و ماهانه در پنل و مستندات
- هر درخواستحداکثر طول حافظهٔ گفتگو در پنل و مستندات
- APIسقف نرخ و درخواست هم‌زمان در پنل و مستندات
{ "error": { "message": "Invalid API key", "type": "invalid_request_error" }}
هر برنامه یک کلید؛ گزارش مصرف جدا.
ببینید هر کلید چقدر مصرف کرده و چه هزینه‌ای داشته؛ مثلاً مصرف ربات پشتیبانی را با یک اسکریپت آزمایشی مقایسه کنید.
- مصرف و هزینهتوکن و ریالی که هر کلید مصرف کرده است جداگانه نمایش داده می‌شود.
- حذف یعنی بایگانیکلید بایگانی‌شده دیگر کار نمی‌کند، اما سابقهٔ مصرفش می‌ماند.
| نام | کلید | توکن این ماه | هزینه (ریال) | وضعیت |
|---|---|---|---|---|
| ربات پشتیبانیساخته‌شده ۲۹ مرداد ۱۴۰۵ | hvd_…a41f | ۴۸٬۲۰۰٬۰۰۰ | ۲۳٬۱۰۰٬۰۰۰ | فعال |
| اپ موبایلساخته‌شده ۱۱ شهریور ۱۴۰۵ | hvd_…9c02 | ۱۲٬۶۰۰٬۰۰۰ | ۷٬۴۰۰٬۰۰۰ | فعال |
| اسکریپت آزمایشیساخته‌شده ۴ مهر ۱۴۰۵ | hvd_…5b77 | ۳۱۰٬۰۰۰ | ۱۵۰٬۰۰۰ | بایگانی‌شده |