संरचित निर्णय लें
स्थिर ShareAI एंडपॉइंट /api/v1/decisions का उपयोग करें।.
इस पेज पर
https://api.shareai.now/api/v1/decisionsसंरचित निर्णय लें
- बेस URL
https://api.shareai.now- प्रमाणीकरण
- Bearer API कुंजी या स्वीकृत 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, choice या score, निर्देश और मिलान मानदंड होता है। choice एक कुंजी-से-विवरण मैप का उपयोग करता है; score एक क्रमबद्ध सूची का उपयोग करता है; noul true/false मानदंड का उपयोग करता है।. |
provider | ऑब्जेक्ट | वैकल्पिक प्रोवाइडर रूटिंग प्राथमिकताएँ। स्वीकृत प्रोवाइडर टैग के लिए provider.only का उपयोग करें, मॉडल ID में प्रीफिक्स के रूप में नहीं। खाता और क्रेडेंशियल प्रतिबंध अभी भी लागू होते हैं।. |
परिणाम पढ़ें#
सफलता HTTP 200 के साथ JSON लौटाती है। स्थिर ShareAI एंडपॉइंट का उपयोग करें। /api/v1/decisions. एक गैर-खाली स्टेट एरे और नामित प्रश्न प्रदान करें noul, choice या score प्रकार और मिलान मानदंड के साथ। 100 प्रश्नों और 256 स्टेट एंट्रीज़ तक स्वीकार किए जाते हैं, 2 MiB अनुरोध सीमा के भीतर।.
बिलिंग इकाइयाँ#
निर्णय मॉडल इनपुट-टोकन या अन्य स्पष्ट रूप से प्रकाशित इनपुट/अनुरोध इकाइयों का उपयोग करते हैं। संरचित निर्णय मान आउटपुट-टोकन मात्राएं नहीं हैं। केवल रिपोर्ट किए गए, मान्य माप सक्रिय टैरिफ में बिल किए जाते हैं।.
Console से सटीक सक्षम मॉडल पहचानकर्ता चुनें। इसका घोषित ऑपरेशन और इनपुट/आउटपुट क्षमताएँ इस एंडपॉइंट से मेल खानी चाहिए; एक टेक्स्ट चैट मॉडल को किसी अन्य ऑपरेशन के लिए प्रतिस्थापित नहीं किया जा सकता। आपके क्रेडेंशियल, प्रोवाइडर और खाता प्रतिबंध अभी भी लागू होते हैं।.
मूल्य निर्धारण और उपयोग#
दरें चयनित मॉडल, प्रोवाइडर, इकाइयों और वेरिएंट के लिए EUR AI क्रेडिट में प्रकाशित की जाती हैं। केवल इसकी सक्रिय टैरिफ में शामिल आयामों का शुल्क लिया जाता है। एक अनुमान निष्पादन से पहले क्रेडिट आरक्षित करता है; अंतिम शुल्क मापे गए उपयोग का उपयोग करते हैं। कीमतें रिज़ॉल्यूशन, आउटपुट फॉर्मेट या उपयोग बैंड पर निर्भर हो सकती हैं। अंतिम ShareAI डेबिट के लिए Console Usage की जाँच करें। अपस्ट्रीम लागत फ़ील्ड और मीडिया बाइट्स को आविष्कृत टोकन गिनती में परिवर्तित नहीं किया जाता।.
एक्सेस और त्रुटियाँ#
उपयोग करें inference अनुमोदित नेटवर्क-लागत इन्फरेंस के लिए monetization_gateway अनुमोदित Builder मार्कअप और स्वीकृत बिलिंग शर्तों के लिए। केवल पहचान-आधारित एक्सेस खर्च को अधिकृत नहीं करता। सत्यापन, मॉडल प्राधिकरण, अपर्याप्त क्रेडिट, दर सीमाएँ और निष्पादन विफलताएँ एक संरचित error. लौटाती हैं। टाइमआउट या अनिश्चित सबमिशन के बाद, Usage या वीडियो जॉब का निरीक्षण करें इससे पहले कि आप एक और संभावित भुगतान अनुरोध बनाएँ।.
अंतिम अपडेट नवम्बर 3, 2026