تصمیمگیریهای ساختاریافته
از نقطه پایانی پایدار ShareAI /api/v1/decisions استفاده کنید.
در این صفحه
https://api.shareai.now/api/v1/decisionsتصمیمگیریهای ساختاریافته
- URL پایه
https://api.shareai.now- احراز هویت
- کلید API Bearer یا توکن دسترسی OAuth تأییدشده
- دامنه مورد نیاز
inferenceormonetization_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"
}
}
}
}'Python
import json
import os
import urllib.request
payload = {'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'}}}}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/decisions', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/decisions", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"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"
}
}
}
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);فیلدهای درخواست#
| فیلد | نوع | معنا و محدودیتها |
|---|---|---|
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 یا کار ویدیویی را بررسی کنید قبل از ایجاد درخواست دیگری که ممکن است هزینهبر باشد.
لینک به واحدهای صورتحساب