یک کلید و همان SDK
مدل را شما انتخاب کنید.
هویدای یک API سازگار با OpenAI است. نشانی پایه و کلید را عوض می‌کنید، نام مدل را هر بار با یک رشته انتخاب می‌کنید و هزینهٔ هر کلید جدا دیده می‌شود.
- نشانی پایه و کلیداین دو مقدار و شناسهٔ مدل را تنظیم کنید؛ سازگاری مسیرها و پارامترها را در مستندات ببینید.
- مدلبا یک رشته در هر درخواست؛ کتابخانه همان می‌ماند.
- هزینهبرای هر کلید جدا حساب می‌شود، از یک کیف پول ریالی.
from openai import OpenAI -client = OpenAI(api_key="sk-...")+client = OpenAI(+ base_url="https://<HOVEYDAI_BASE_URL>/v1",+ api_key="hvd_...",+) resp = client.chat.completions.create( model="gpt-5.5", # any model id from the list messages=[{"role": "user", "content": "..."}],)
از کلید تا اولین پاسخ، سه قدم.
کلید بسازید
در پنل برای هر برنامه یک کلید جدا بسازید تا هزینهٔ آن جدا دیده شود.
نشانی پایه را عوض کنید
در تنظیمات SDK نشانی پایه و کلید را بگذارید، شناسهٔ مدل را از فهرست بردارید و پارامترهای پشتیبانی‌شده را بررسی کنید.
درخواست بفرستید
نام مدل را بنویسید و بفرستید. پاسخ در قالب OpenAI برمی‌گردد و هزینه در مصرف همان کلید ثبت می‌شود.
هر کتابخانه‌ای که OpenAI را می‌شناسد.
با SDK رسمی OpenAI در پایتون و جاوااسکریپت، با استریم و بدون آن. سازگاری به مسیرها و پارامترهای مستندشده محدود است؛ قابلیت‌های اختصاصی SDK ممکن است متفاوت باشند.
from openai import OpenAI client = OpenAI( base_url="https://<HOVEYDAI_BASE_URL>/v1",تغییر api_key="hvd_...",) resp = client.chat.completions.create( model="gpt-5.5", messages=[{"role": "user", "content": "hello"}],)print(resp.choices[0].message.content)
مدل عوض می‌شود؛ مسیر اتصال یکی است.
نام مدل را در درخواست تغییر دهید. کلید، گزارش مصرف و اعتبار حساب در همین پلتفرم مدیریت می‌شوند.
- یک کلید برای همهنام مدل را در درخواست عوض می‌کنید، نه کتابخانه را.
- یک کیف پول به ریالشارژ ریالی؛ بدون کارت بین‌المللی.
- یک جدول قیمتورودی و خروجی هر مدل پیش از استفاده دیده می‌شود.
base_url="https://<HOVEYDAI_BASE_URL>/v1"مدل و هزینه را با هم بررسی کنید.
مدل را انتخاب کنید؛ محاسبه‌گر پایین با همان انتخاب هماهنگ می‌شود. قیمت‌های نمونه با برچسب مشخص شده‌اند.
برآورد هزینهٔ ماهانه با مدل انتخابی
فرض نمونه: هر پیام حدود ۸۰۰ توکن ورودی و ۶۰۰ توکن خروجی. ماه ۳۰ روز. قیمت‌ها نمونه‌اند.
وقتی به سقف می‌رسید، پاسخ روشن است.
خطاها در قالب خطای OpenAI می‌آیند و هر کدام می‌گوید چه شده و چه باید کرد. فهرست نهایی کدها در مستندات است.
| کد | یعنی | کار شما |
|---|---|---|
| 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 | ۳۱۰٬۰۰۰ | ۱۵۰٬۰۰۰ | بایگانی‌شده |