Hermes Agent

Hermes Agent را از طریق گزینهٔ endpoint سفارشی سازگار با OpenAI آن اجرا کنید.

Hermes Agent از Nous Research

چه چیزی کار می‌کند

Hermes از OneProvider از طریق یک ارائه‌دهندهٔ سفارشی با حالت Chat Completions و شناسهٔ مدل سازگاری که از کاتالوگ انتخاب می‌کنید استفاده می‌کند.

محدودیت کلاینت

حالت API را روی Chat Completions نگه دارید؛ سایر حالت‌های ارائه‌دهندهٔ Hermes از این اتصال سازگار با OpenAI استفاده نمی‌کنند.

راه‌اندازی

1. باز کردن تنظیم مدل Hermes

   ویزارد مدل را اجرا کنید و Custom endpoint (self-hosted / VLLM / etc.) را انتخاب کنید.

   hermes model

2. وارد کردن اتصال OneProvider

   https://api.oneprovider.dev/v1، کلید اختصاصی OneProvider، شناسهٔ مدل سازگاری که از کاتالوگ انتخاب می‌کنید و Chat Completions را به‌عنوان حالت API وارد کنید.

   Endpoint: https://api.oneprovider.dev/v1
   API key: sk-your-key-here
   Model: gpt-6.1-terra
   Mode: Chat Completions

3. یا Hermes را دستی پیکربندی کنید

   ONEPROVIDER_API_KEY=… را در ~/.hermes/.env ذخیره کنید، سپس بلوک model را در ~/.hermes/config.yaml تنظیم کنید.

   # ~/.hermes/.env
   ONEPROVIDER_API_KEY=sk-your-key-here
   # ~/.hermes/config.yaml
   model:
   default: gpt-6.1-terra
   provider: custom
   base_url: https://api.oneprovider.dev/v1
   key_env: ONEPROVIDER_API_KEY

بررسی اتصال

شروع یک نشست جدید Hermes

یک پرسش کوتاه بپرسید، سپس شناسهٔ مدل پیکربندی‌شده، مصرف توکن و مبلغ کسرشده را در داشبورد OneProvider تأیید کنید.

مشخصات اتصال

پروتکل

openai-chat

Endpoint

https://api.oneprovider.dev/v1

امنیت کلید

از یک کلید استنتاج اختصاصی محدود به مدل موردنیاز، با کنترل‌های نرخ، مصرف و انقضا استفاده کنید. کلید را در ~/.hermes/.env نگه دارید، نه در config.yaml.

کدام مدل را انتخاب کنیم

default را در بلوک model فایل config.yaml تنظیم کنید. gpt-6.1-terra پیش‌فرض روزمرهٔ خوبی است، gpt-6.1-sol ردهٔ پیشرو برای کارهای دشوار است و gpt-5.6-luna برای کار سریع یا پرحجم ارزان است. حالت API را Chat Completions بگذارید و شناسه‌ها را از صفحهٔ مدل‌ها کپی کنید.

خطاهای رایج و راه‌حل‌ها

401

کلید خوانده نمی‌شود: بررسی کنید ONEPROVIDER_API_KEY=… در ~/.hermes/.env باشد و key_env در config.yaml همان متغیر را نام ببرد.

404

base_url باید https://api.oneprovider.dev/v1 همراه با /v1 باشد.

«Model not found»

شناسه در کاتالوگ نیست یا غلط املایی دارد. آن را از صفحهٔ مدل‌ها کپی کنید.

429 «Insufficient balance»

موجودی یا سقف کلید تمام شده است. حساب کاربری را شارژ کنید.

ویزارد OneProvider را فهرست نمی‌کند

در hermes model گزینهٔ Custom endpoint را انتخاب کنید: OneProvider به‌عنوان endpoint سفارشی سازگار با OpenAI اضافه می‌شود.

پرسش‌های متداول

کلید را کجا نگه دارم؟

در ~/.hermes/.env، نه در config.yaml.

می‌توانم از مدل‌های Claude استفاده کنم؟

بله، شناسهٔ Claude مثل claude-sonnet-5-5 را در همان endpoint سفارشی وارد کنید؛ قابلیت‌ها به مدل بستگی دارد.

چطور بفهمم کار می‌کند؟

نشست جدیدی شروع کنید، پرسش کوتاهی بپرسید و درخواست را در «مصرف» داشبورد ببینید.

پاسخ‌های سریع

از کدام base URL استفاده کنم؟

Claude Code و SDKهای Anthropic از https://api.oneprovider.dev استفاده می‌کنند. SDKهای OpenAI و کلاینت‌های سازگار با OpenAI از https://api.oneprovider.dev/v1 استفاده می‌کنند. یک کلید پشت هر دو آدرس کار می‌کند؛ فهرست مدل‌ها در صفحهٔ مدل‌ها و نرخ‌ها در صفحهٔ قیمت‌ها است.

چگونه احراز هویت کنم؟

کلید خام sk-… را در x-api-key یا Authorization: Bearer بفرستید: یکی از این دو، نه هر دو. کلید را در یک متغیر محیطی نگه دارید، نه در فایلی که commit می‌شود. اطلاعات بیشتر دربارهٔ احراز هویت .

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

حساب کاربری خود را در ربات Telegram به نام @oneprovider_robot یا در app.oneprovider.dev باز کنید، موجودی را شارژ کنید و «صدور کلید» را بزنید. هر کلید می‌تواند سقف مصرف مخصوص خودش را داشته باشد. حساب کاربری و کلیدهای API .

کدهای 401، 404 و 429 یعنی چه؟

401: کلید ارسال نشده، اشتباه تایپ شده یا در هدر نادرست فرستاده شده است؛ کلید را کامل و بدون گیومه و فاصله جای‌گذاری کنید. 404: معمولاً base URL نادرست است، مثلاً /v1 جا افتاده یا دوبار آمده است. 429 با پیام «Insufficient balance»: موجودی حساب کاربری یا سقف مصرف کلید تمام شده است؛ به‌جای تلاش دوباره، شارژ کنید. هر 429 دیگری محدودیت نرخ است؛ تا پایان زمان Retry-After صبر کنید. جزئیات: کدهای خطا و رفع اشکال .

چرا استریم‌ها قطع یا ریست می‌شوند؟

VPN و پروکسی‌های VLESS اغلب SSE را بافر می‌کنند یا مذاکرهٔ HTTP/2 را مختل می‌کنند. OneProvider هیچ محدودیت منطقه‌ای ندارد و استریم‌ها را بافر نمی‌کند؛ پروکسی را خاموش کنید و دوباره امتحان کنید.

اگر این‌ها کافی نبود از کجا بپرسم؟

در Telegram به @Oneproviderhelpbot پیام بدهید یا در حساب کاربری وب «پشتیبانی» را باز کنید و کد وضعیت HTTP و متن دقیق خطا را بفرستید. پشتیبانی چگونه کار می‌کند .