طرح رایگان

هر حساب واردشده می‌تواند تا سقف سهمیهٔ روزانهٔ توکن (در حال حاضر ۱۰۰٬۰۰۰ توکن در روز، تقریباً چند صد نوبت گفت‌وگوی کوتاه) رایگان از هایلون استفاده کند. این سهمیه:

• به مجموع توکن‌های ورودی و خروجی اعمال می‌شود.
• هر روز نیمه‌شب به وقت UTC بازنشانی می‌شود.
• به هیچ اشتراک و کارت اعتباری نیاز ندارد.

این سهمیه از سوی گردانندگان قابل تنظیم است، پس عددی که در پاسخ GET /api/v1/hylon/me می‌بینید (free_daily_tokens) را مرجع بدانید.

طرح‌های پولی

طرح‌های پولی سهمیهٔ ماهانهٔ توکن، سقف تلاش بالاتر و نشست‌های همزمان بیشتری می‌افزایند. فهرست کنونی:

از app.hylon.ai (تنظیمات ← صورت‌حساب) مشترک شوید که یک تسویهٔ Stripe اجرا می‌کند، یا با POST /api/v1/hylon/checkout به‌صورت برنامه‌نویسی آغازش کنید (plan_id از نقطهٔ پایانی طرح‌ها، به‌همراه success_url، cancel_url و email اختیاری). اگر Stripe روی یک استقرار پیکربندی نشده باشد، تسویه به‌جای تظاهر به کار کردن، پاسخ ۵۰۳ می‌دهد.

اعتبار و قیمت‌گذاری به‌ازای هر توکن

فراتر از سهمیهٔ رایگان و هر سهمیهٔ گنجانده‌شده، مصرف از موجودی اعتبار هایلون که پیش‌پرداخت است کسر می‌شود. اعتبارها استخری جداگانه‌اند که تنها هوش مصنوعی هایلون به کار می‌برد: هرگز با موجودی کیف‌پول VPN، توکن‌های ORB یا اعتبار پویش درنمی‌آمیزند.

نرخ‌ها برای هر مدل و بر حسب اعتبار به‌ازای هر میلیون توکن‌اند. قیمت‌گذاری کنونی:

نرخ‌های زنده به‌صورت عمومی در GET https://api.orbai.world/api/v1/hylon/pricing در دسترس‌اند. مدلی که قیمت‌گذاری فعالی ندارد هرگز بی‌صدا رایگان ارائه نمی‌شود؛ چنین درخواست‌هایی رد می‌شوند.

اندازه‌گیری مصرف چگونه کار می‌کند

هر تکمیل گفت‌وگو از سوی دروازهٔ ارائه اندازه‌گیری و به ترتیبی ثابت در حساب شما تسویه می‌شود:

هر درخواست دقیقاً یک بار ثبت می‌شود (تسویه به‌ازای هر شناسهٔ درخواست خنثی‌پذیر است). هر زمان می‌توانید تاریخچهٔ خود را مرور کنید:

• در برنامه: app.hylon.ai ← تنظیمات ← صورت‌حساب، طرح، موجودی اعتبار و نوار مصرف ماهانهٔ شما را نشان می‌دهد.
• از راه API: GET /api/v1/hylon/usage موجودی و رویدادهای مصرف اخیر شما (مدل، توکن، هزینه بر حسب اعتبار، منبع هزینه) را برمی‌گرداند، و GET /api/v1/hylon/me استحقاق نهایی‌شدهٔ شما را.

کلیدهای API

کلیدهای API به اسکریپت‌ها و یکپارچه‌سازی‌ها امکان می‌دهند با استحقاق شما به هایلون دسترسی پیدا کنند، بدون آنکه ورود شما را در اختیارشان بگذارید.

• قالب: hyl_sk_ و پس از آن یک شناسهٔ کلید ۸ نویسه‌ای و بدنهٔ محرمانه، برای نمونه hyl_sk_1a2b3c4d_....
• محرمانهٔ کامل دقیقاً یک بار و هنگام ساخت نمایش داده می‌شود. تنها یک درهم‌ریخته ذخیره می‌شود؛ اگر کلید را گم کردید، باطلش کنید و کلید تازه‌ای بسازید.
• فهرست کردن کلیدهای شما تنها پیشوند غیرمحرمانه را نشان می‌دهد.
• کلیدها می‌توانند نام داشته باشند، انقضای اختیاری بگیرند (expires_in_days) و هر زمان باطل شوند.
• یک کلید نمی‌تواند کلید API دیگری بسازد و نمی‌تواند کد راه‌اندازی گره تولید کند؛ هر دو به نشست واردشده نیاز دارند.

کلیدها را در app.hylon.ai (تنظیمات ← کلیدهای API) یا از راه API مدیریت کنید:

# ساخت (احراز هویت با نشست؛ محرمانه یک بار در پاسخ ظاهر می‌شود)
curl -X POST https://api.orbai.world/api/v1/hylon/api-keys \
  -H "Authorization: Bearer <YOUR_SESSION_JWT>" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-script", "expires_in_days": 90}'

# فهرست (تنها پیشوندها)
curl https://api.orbai.world/api/v1/hylon/api-keys \
  -H "Authorization: Bearer <YOUR_SESSION_JWT>"

# ابطال
curl -X DELETE https://api.orbai.world/api/v1/hylon/api-keys/123 \
  -H "Authorization: Bearer <YOUR_SESSION_JWT>"

فراخوانی دروازهٔ هوش مصنوعی

گفت‌وگوی برنامه‌نویسی از دروازهٔ ارائهٔ هایلون می‌گذرد که با OpenAI سازگار است:

• نشانی پایه: https://hylon-gateway.ambitiousmushroom-c83407ea.eastus.azurecontainerapps.io
• POST /v1/chat/completions (جریانی و غیرجریانی)
• GET /v1/models مدل ارائه‌شده را فهرست می‌کند

با JWT نشست خود یا یک کلید API هایلون در سرآیند Authorization احراز هویت کنید:

curl https://hylon-gateway.ambitiousmushroom-c83407ea.eastus.azurecontainerapps.io/v1/chat/completions \
  -H "Authorization: Bearer hyl_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
        "model": "Qwen/Qwen2.5-3B-Instruct",
        "messages": [{"role": "user", "content": "Hello, Hylon"}]
      }'

دروازه پیش از ارائه، استحقاق شما را بررسی می‌کند (۴۰۱ بدون اعتبارنامهٔ معتبر، ۴۰۲ وقتی هیچ‌چیز نتواند درخواست را پوشش دهد) و پس از تکمیل پاسخ، شمار دقیق توکن‌ها را برای تسویه گزارش می‌دهد. پاسخ‌های جریانی هم اندازه‌گیری می‌شوند.