Yapılandırılmış kararlar al
Kararlı ShareAI uç noktası /api/v1/decisions kullanın.
Bu sayfada
https://api.shareai.now/api/v1/decisionsYapılandırılmış kararlar al
- Temel URL
https://api.shareai.now- Kimlik doğrulama
- Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
- Gerekli kapsam
inferenceormonetization_gateway
Kararlı ShareAI uç noktasını kullanın /api/v1/decisions. Boş olmayan bir durum dizisi ve adlandırılmış sorular sağlayın noul, choice veya score türler ve eşleşme kriterleri ile. 100 soruya ve 256 durum girişine kadar, 2 MiB istek sınırı içinde kabul edilir.
Başlamadan önce#
SHAREAI_API_KEY'i sunucunuzda ayarlayın ve model yer tutucusunu şu anda etkin olan bir modelle değiştirin. API anahtarını tarayıcı kodunda asla ifşa etmeyin. Model, hesap, kimlik bilgisi ve sağlayıcı bu işlemi izin vermelidir. Aşağıdaki isteğe bağlı ayarlar model desteği gerektirir; API güvenlik sınırları, her modelin her değeri desteklediği anlamına gelmez.
Bir istek gönder#
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);İstek alanları#
| Alan | Tür | Anlam ve sınırlar |
|---|---|---|
model gerekli | metin dizisi | Tam etkinleştirilmiş genel model tanımlayıcısı. Bu işlemi bildirmeli ve kimlik bilgileriniz tarafından izin verilmiş olmalıdır. |
state gerekli | dizi | 1–256 metin veya model destekli türlendirilmiş medya durum girdisi. Birleşik istek sınırı 2 MiB'dir. |
questions gerekli | nesne | 1–100 adlandırılmış soru. Her biri noul, choice veya score türüne, talimatlara ve eşleşme kriterlerine sahiptir. choice, bir anahtar-açıklama haritası kullanır; score, sıralı bir liste kullanır; noul, doğru/yanlış kriterlerini kullanır. |
provider | nesne | İsteğe bağlı sağlayıcı yönlendirme tercihleri. Kabul edilen sağlayıcı etiketleri için provider.only kullanın, model kimliğinde bir ön ek olarak değil. Hesap ve kimlik bilgisi kısıtlamaları yine de geçerlidir. |
Sonucu okuyun#
Başarı, JSON ile HTTP 200 döndürür. Kararlı ShareAI uç noktasını kullanın /api/v1/decisions. Boş olmayan bir durum dizisi ve adlandırılmış sorular sağlayın noul, choice veya score türler ve eşleşme kriterleri ile. 100 soruya ve 256 durum girişine kadar, 2 MiB istek sınırı içinde kabul edilir.
Faturalandırma birimleri#
Karar modelleri, giriş-token veya açıkça yayımlanmış diğer giriş/istek birimlerini kullanır. Yapılandırılmış karar değerleri, çıktı-token miktarları değildir. Yalnızca aktif tarifede bildirilen, doğrulanmış ölçümler faturalandırılır.
Konsol'dan tam etkin model tanımlayıcısını seçin. Beyan edilen işlem ve giriş/çıkış yetenekleri bu uç noktayla eşleşmelidir; bir metin sohbet modeli başka bir işlem için değiştirilemez. Kimlik bilgileriniz, sağlayıcı ve hesap kısıtlamaları hala geçerlidir.
Fiyatlandırma ve kullanım#
Oranlar, seçilen model, sağlayıcı, birimler ve varyantlar için EUR AI kredisi olarak yayımlanır. Yalnızca aktif tarifesindeki boyutlar ücretlendirilir. Bir tahmin, yürütmeden önce kredileri ayırır; nihai ücretler ölçülen kullanıma göre hesaplanır. Fiyatlar çözünürlüğe, çıktı formatına veya bir kullanım bandına bağlı olabilir. Nihai ShareAI borçlandırmasını görmek için Konsol Kullanımı'nı kontrol edin. Yukarı akış maliyet alanları ve medya baytları, uydurulmuş token sayısına dönüştürülmez.
Erişim ve hatalar#
Kullan inference onaylanmış ağ maliyeti çıkarımı için veya monetization_gateway onaylanmış bir Builder kar marjı ve kabul edilen faturalandırma şartları için. Yalnızca kimlik doğrulama erişimi harcama yetkisi vermez. Doğrulama, model yetkilendirmesi, yetersiz kredi, oran sınırları ve yürütme hataları yapılandırılmış bir şekilde döner. error. Bir zaman aşımı veya belirsiz gönderimden sonra, başka bir potansiyel ücretli istek oluşturmadan önce Kullanımı veya video işini inceleyin.
Son güncelleme Kasım 3, 2026