پرسش‌های پرتکرار

سوالات متداول

آیا هرمز با OpenAI سازگار است؟

بله. POST /v1/chat/completions، GET /v1/models، POST /v1/embeddings و POST /v1/audio/* از قالب سیمی OpenAI پیروی می‌کنند. SDKهای رسمی OpenAI فقط با تغییر base_url و کلید کار می‌کنند. خطاها فیلد type به سبک OpenAI دارند.

آدرس پایه چیست؟

https://api.hormouz.net/v1. احراز هویت یک هدر ساده است: Authorization: Bearer ng-YOUR_KEY.

کلید API را از کجا بگیرم؟

مدیر حساب آن را می‌سازد و فقط یک بار نمایش داده می‌شود. اگر گم شد، مدیر می‌تواند از داشبورد ریست کند. با آن مثل رمز عبور رفتار کنید. هر کسی که کلید را دارد می‌تواند از موجودی شما خرج کند.

چه مدل‌هایی در دسترس‌اند؟

بیش از ۳۵۰ مدل چت (GPT، Claude، Gemini، GLM، Kimi، DeepSeek، Llama و بیشتر) به‌علاوهٔ مدل‌های منتخب تصویر، ویدیو و صدا. GET /v1/models مدل‌های چت را با قیمت فهرست می‌کند؛ کاتالوگ کامل هم صفحه‌به‌صفحه قابل مرور است.

صورتحساب چطور کار می‌کند؟

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

اگر موجودی تمام شود چه می‌شود؟

درخواست‌ها سریع با HTTP 402 و \"type\":\"insufficient_quota\" رد می‌شوند. چیزی در صف نمی‌ماند و بی‌صدا حذف نمی‌شود. بعد از شارژ، همان کلید بلافاصله کار می‌کند.

محدودیت نرخ دارید؟

بله. بودجهٔ درخواست‌بر‌دقیقه برای هر حساب به‌علاوهٔ سقف استریم‌های همزمان. در صورت برخورد، 429 با \"type\":\"rate_limit_error\" برمی‌گردد؛ SDKهای OpenAI خودکار با backoff تکرار می‌کنند.

می‌توانم هرمز را داخل ویرایشگر کدم استفاده کنم؟

بله. VS Code (کلید خودتان در Copilot)، ZCode، Cline/Continue و پنل چت Cursor همگی با کلید شما کار می‌کنند. راهنمای گام‌به‌گام: هرمز در ویرایشگر شما.

استریم کار می‌کند؟

بله. روی chat completions مقدار \"stream\": true بگذارید تا SSE استاندارد بگیرید, دلتاهای توکن، چانک پایانی usage و خاتمهٔ data: [DONE]. ببینید: استریم.

با معرفی هرمز به دیگران چیزی به دست می‌آورم؟

بله. تا پایان مهر ۱۴۰۵، از هر شارژ حسابی که با کد معرفی شما ساخته شود ۲٫۵٪ به موجودی شما اضافه می‌شود و ۲٫۵٪ هم به موجودی خود آن حساب. تعداد و مبلغ شارژها سقفی ندارد. کد و لینک معرفی‌تان در صفحهٔ معرفی دوستان داشبورد است.