Ia decizii structurate
Utilizează endpoint-ul stabil ShareAI /api/v1/decisions.
Pe această pagină
https://api.shareai.now/api/v1/decisionsIa decizii structurate
- URL de bază
https://api.shareai.now- Autentificare
- Cheie API Bearer sau token de acces OAuth aprobat
- Scop necesar
inferenceormonetization_gateway
Utilizează endpoint-ul stabil ShareAI /api/v1/decisions. Furnizează un array de stări nevid și întrebări denumite cu noul, choice sau score tipuri și criterii de potrivire. Sunt acceptate până la 100 întrebări și 256 intrări de stare, în limita cererii de 2 MiB.
Înainte de a începe#
Setează SHAREAI_API_KEY pe serverul tău și înlocuiește placeholder-ul modelului cu un model activat în prezent. Nu expune niciodată cheia API în codul browserului. Modelul, contul, acreditivul și providerul trebuie să permită această operațiune. Setările opționale de mai jos necesită suportul modelului; limitele de siguranță ale API-ului nu garantează că fiecare model suportă fiecare valoare.
Trimite o cerere#
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);Câmpuri cerere#
| Câmp | Tip | Semnificație și limite |
|---|---|---|
model necesar | șir | Identificatorul exact al modelului public activat. Trebuie să declare această operațiune și să fie permis de acreditivul tău. |
state necesar | array | 1–256 intrări de stare text sau media tipizată suportată de model. Limita combinată a cererii este de 2 MiB. |
questions necesar | obiect | 1–100 întrebări denumite. Fiecare are tipul noul, alegere sau scor, instrucțiuni și criterii de potrivire. alegere folosește o mapare cheie-descriere; scor folosește o listă ordonată; noul folosește criterii adevărat/fals. |
provider | obiect | Preferințe opționale de rutare ale providerului. Utilizează provider.only pentru tag-uri de provider acceptate, nu un prefix în ID-ul modelului. Restricțiile contului și acreditivului se aplică în continuare. |
Citește rezultatul#
Succesul returnează HTTP 200 cu JSON. Utilizează endpoint-ul stabil ShareAI /api/v1/decisions. Furnizează un array de stări nevid și întrebări denumite cu noul, choice sau score tipuri și criterii de potrivire. Sunt acceptate până la 100 întrebări și 256 intrări de stare, în limita cererii de 2 MiB.
Unități de facturare#
Modelele de decizie utilizează token de intrare sau alte unități de intrare/cerere publicate explicit. Valorile structurate ale deciziilor nu sunt cantități de token de ieșire. Sunt facturate doar măsurătorile raportate și validate în tariful activ.
Alege identificatorul exact al modelului activat din Console. Operațiunea declarată și capacitățile de intrare/ieșire trebuie să se potrivească cu acest endpoint; un model de chat text nu poate fi substituit pentru o altă operațiune. Restricțiile acreditivului, providerului și contului tău se aplică în continuare.
Prețuri și utilizare#
Tarifele sunt publicate în credite AI EUR pentru modelul, providerul, unitățile și variantele selectate. Sunt taxate doar dimensiunile din tariful său activ. O estimare rezervă credite înainte de execuție; taxele finale utilizează utilizarea măsurată. Prețurile pot depinde de rezoluție, formatul de ieșire sau un interval de utilizare. Verifică Console Usage pentru debitul final ShareAI. Câmpurile de cost upstream și byte-urile media nu sunt convertite în număr de token inventat.
Acces și erori#
Utilizează inference pentru inferență aprobată cu costuri de rețea sau monetization_gateway pentru un adaos aprobat de Builder și termeni de facturare acceptați. Accesul doar pe bază de identitate nu autorizează cheltuieli. Validarea, autorizarea modelului, creditele insuficiente, limitele de rată și eșecurile de execuție returnează un error. După un timeout sau o trimitere incertă, inspectează Usage sau job-ul video înainte de a crea o altă cerere potențial plătită.
Ultima actualizare noiembrie 3, 2026