ShareAI Platform Docs

تصمیم‌گیری‌های ساختاریافته

از نقطه پایانی پایدار ShareAI /api/v1/decisions استفاده کنید.

مشاهده به‌صورت Markdown
در این صفحه
POST https://api.shareai.now/api/v1/decisions

تصمیم‌گیری‌های ساختاریافته

URL پایه
https://api.shareai.now
احراز هویت
کلید API Bearer یا توکن دسترسی OAuth تأیید‌شده
دامنه مورد نیاز
inference or monetization_gateway

از نقطه پایانی پایدار ShareAI استفاده کنید /api/v1/decisions. یک آرایه حالت غیرخالی و سوالات نام‌گذاری‌شده ارائه دهید noul, choice یا score انواع و معیارهای تطبیق. تا 100 سوال و 256 ورودی حالت پذیرفته می‌شوند، در محدودیت درخواست 2 MiB.

قبل از شروع#

SHAREAI_API_KEY را روی سرور خود تنظیم کنید و جایگزین مدل را با یک مدل فعال فعلی انجام دهید. هرگز کلید API را در کد مرورگر افشا نکنید. مدل، حساب، اعتبار و ارائه‌دهنده باید این عملیات را مجاز کنند. تنظیمات اختیاری زیر به پشتیبانی مدل نیاز دارند؛ محدودیت‌های ایمنی API تضمین نمی‌کنند که هر مدل از هر مقدار پشتیبانی کند.

ارسال یک درخواست#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/decisions" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_DECISIONS_MODEL",
  "state": [
    "A bicycle with light wear."
  ],
  "questions": {
    "category": {
      "type": "choice",
      "instructions": "Classify this item.",
      "criteria": {
        "bicycle": "A complete bicycle",
        "other": "Anything else"
      }
    }
  }
}'

فیلدهای درخواست#

فیلدنوعمعنا و محدودیت‌ها
model مورد نیازرشتهشناسه دقیق مدل عمومی فعال. باید این عملیات را اعلام کند و توسط اعتبار شما مجاز باشد.
state مورد نیازآرایه1–256 ورودی حالت متنی یا رسانه‌ای با نوع پشتیبانی‌شده توسط مدل. محدودیت ترکیبی درخواست 2 MiB است.
questions مورد نیازشیء1–100 سوال نام‌گذاری‌شده. هر کدام دارای نوع noul، انتخاب یا امتیاز، دستورالعمل‌ها و معیارهای تطبیق هستند. انتخاب از یک نقشه کلید به توضیحات استفاده می‌کند؛ امتیاز از یک لیست مرتب استفاده می‌کند؛ noul از معیارهای درست/غلط استفاده می‌کند.
providerشیءتنظیمات اختیاری ترجیحات مسیریابی ارائه‌دهنده. از provider.only برای برچسب‌های ارائه‌دهنده پذیرفته‌شده استفاده کنید، نه یک پیشوند در شناسه مدل. محدودیت‌های حساب و اعتبار همچنان اعمال می‌شوند.

خواندن نتیجه#

موفقیت با HTTP 200 و JSON بازمی‌گردد. از نقطه پایانی پایدار ShareAI استفاده کنید /api/v1/decisions. یک آرایه حالت غیرخالی و سوالات نام‌گذاری‌شده ارائه دهید noul, choice یا score انواع و معیارهای تطبیق. تا 100 سوال و 256 ورودی حالت پذیرفته می‌شوند، در محدودیت درخواست 2 MiB.

واحدهای صورتحساب#

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

مدل فعال مورد نظر را از Console انتخاب کنید. عملیات اعلام‌شده و قابلیت‌های ورودی/خروجی آن باید با این نقطه پایانی مطابقت داشته باشد؛ یک مدل چت متنی نمی‌تواند جایگزین عملیات دیگری شود. محدودیت‌های اعتبارنامه، ارائه‌دهنده و حساب شما همچنان اعمال می‌شوند.

قیمت‌گذاری و استفاده#

نرخ‌ها به صورت اعتبارهای AI به یورو برای مدل انتخاب‌شده، ارائه‌دهنده، واحدها و انواع منتشر می‌شوند. فقط ابعاد موجود در تعرفه فعال آن شارژ می‌شوند. یک تخمین اعتبارها را قبل از اجرا رزرو می‌کند؛ هزینه‌های نهایی بر اساس استفاده اندازه‌گیری‌شده محاسبه می‌شوند. قیمت‌ها ممکن است به وضوح، فرمت خروجی یا یک باند استفاده بستگی داشته باشند. برای بدهی نهایی ShareAI، Console Usage را بررسی کنید. فیلدهای هزینه بالادستی و بایت‌های رسانه به شمارش توکن‌های اختراعی تبدیل نمی‌شوند.

دسترسی و خطاها#

استفاده کنید inference برای استنتاج هزینه شبکه تأیید‌شده یا monetization_gateway برای افزایش قیمت تأیید‌شده Builder و شرایط صورتحساب پذیرفته‌شده. دسترسی فقط به هویت، مجوز هزینه کردن را نمی‌دهد. اعتبارسنجی، مجوز مدل، اعتبار ناکافی، محدودیت نرخ و شکست‌های اجرا یک ساختار بازگشتی را برمی‌گردانند. error. پس از یک زمان انتظار یا ارسال نامشخص، Usage یا کار ویدیویی را بررسی کنید قبل از ایجاد درخواست دیگری که ممکن است هزینه‌بر باشد.

لینک به واحدهای صورتحساب

مستندات پلتفرم ShareAI
تمام مستندات

جستجو بر اساس عنوان یا محتوا.

درباره این صفحه بپرسید

یک دستیار برای کاوش این صفحه انتخاب کنید. همچنین می‌توانید صفحه را کپی کرده و در مکالمه خود جای‌گذاری کنید.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI