Nggawe keputusan terstruktur
Gunakake endpoint ShareAI sing stabil /api/v1/decisions.
Ing kaca iki
https://api.shareai.now/api/v1/decisionsNggawe keputusan terstruktur
- URL Dasar
https://api.shareai.now- Otentikasi
- Bearer API key utawa token akses OAuth sing disetujui
- Lingkup sing dibutuhake
inferenceormonetization_gateway
Gunakake endpoint ShareAI sing stabil /api/v1/decisions. Sediakan array state sing ora kosong lan pitakonan sing dijenengi kanthi noul, choice utawa score jinis lan kriteria sing cocog. Maksimal 100 pitakonan lan 256 entri state ditampa, ing watesan permintaan 2 MiB.
Sadurunge sampeyan miwiti#
Set SHAREAI_API_KEY ing server sampeyan lan ganti placeholder model karo model sing saiki diaktifake. Aja tau mbukak API key ing kode browser. Model, akun, kredensial lan panyedhiya kudu kabeh ngidini operasi iki. Setelan opsional ing ngisor iki mbutuhake dhukungan model; watesan safety API ora janji yen saben model ndhukung saben nilai.
Kirim panjalukan#
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);Lapangan panjalukan#
| Lapangan | Tipe | Makna lan watesan |
|---|---|---|
model dibutuhake | string | Identifikasi model publik sing diaktifake kanthi tepat. Kudu nyatakake operasi iki lan diidini dening kredensial sampeyan. |
state dibutuhake | array | 1–256 entri state media teks utawa jinis sing didhukung model. Watesan gabungan permintaan yaiku 2 MiB. |
questions dibutuhake | obyek | 1–100 pitakonan sing dijenengi. Saben duwe jinis noul, pilihan utawa skor, instruksi lan kriteria sing cocog. pilihan nggunakake peta kunci-kanggo-deskripsi; skor nggunakake dhaptar sing diurutake; noul nggunakake kriteria bener/salah. |
provider | obyek | Preferensi routing panyedhiya opsional. Gunakake provider.only kanggo tag panyedhiya sing ditampa, dudu prefiks ing ID model. Watesan akun lan kredensial isih ditrapake. |
Maca asil#
Sukses bali HTTP 200 kanthi JSON. Gunakake endpoint ShareAI sing stabil /api/v1/decisions. Sediakan array state sing ora kosong lan pitakonan sing dijenengi kanthi noul, choice utawa score jinis lan kriteria sing cocog. Maksimal 100 pitakonan lan 256 entri state ditampa, ing watesan permintaan 2 MiB.
Unit tagihan#
Model keputusan nggunakake token-input utawa unit input/permintaan sing diterbitake kanthi eksplisit. Nilai keputusan sing terstruktur ora jumlah token-output. Mung pangukuran sing dilaporake lan divalidasi ing tarif aktif sing dikenani biaya.
Pilih identifier model sing diaktifake kanthi tepat saka Console. Operasi sing diumumake lan kemampuan input/output kudu cocog karo endpoint iki; model obrolan teks ora bisa diganti kanggo operasi liyane. Watesan kredensial, panyedhiya lan akun sampeyan isih ditrapake.
Harga lan panggunaan#
Tarif diterbitake ing kredit AI EUR kanggo model sing dipilih, panyedhiya, unit lan varian. Mung dimensi ing tarif aktif sing dikenani biaya. Perkiraan nyimpen kredit sadurunge eksekusi; biaya pungkasan nggunakake panggunaan sing diukur. Harga bisa gumantung saka resolusi, format output utawa pita panggunaan. Priksa Console Usage kanggo debit ShareAI pungkasan. Lapangan biaya hulu lan byte media ora dikonversi dadi jumlah token sing diada-adakan.
Akses lan kesalahan#
Gunakake inference kanggo inferensi biaya jaringan sing disetujui utawa monetization_gateway kanggo markup Builder sing disetujui lan syarat tagihan sing ditampa. Akses identitas mung ora ngidini pengeluaran. Validasi, otorisasi model, kredit sing ora cukup, watesan tarif lan kegagalan eksekusi ngasilake error. Sawise timeout utawa kiriman sing ora pasti, priksa Usage utawa tugas video sadurunge nggawe panjalukan liyane sing bisa dikenani biaya.
Pungkasan dianyari 3 Novèmber 2026