ShareAI Platform Docs

Strukturierte Entscheidungen treffen

Verwenden Sie den stabilen ShareAI-Endpunkt /api/v1/decisions.

Als Markdown anzeigen
Auf dieser Seite
POST https://api.shareai.now/api/v1/decisions

Strukturierte Entscheidungen treffen

Basis-URL
https://api.shareai.now
Authentifizierung
Bearer-API-Schlüssel oder genehmigtes OAuth-Zugriffstoken
Erforderlicher Scope
inference or monetization_gateway

Verwenden Sie den stabilen ShareAI-Endpunkt /api/v1/decisions. Stellen Sie ein nicht leeres Zustandsarray und benannte Fragen mit noul, choice oder score Typen und passenden Kriterien bereit. Bis zu 100 Fragen und 256 Zustandswerte werden akzeptiert, innerhalb des 2-MiB-Anfragelimits.

Bevor Sie beginnen#

Setzen Sie SHAREAI_API_KEY auf Ihrem Server und ersetzen Sie den Modell-Platzhalter durch ein derzeit aktiviertes Modell. Geben Sie den API-Schlüssel niemals im Browsercode preis. Das Modell, das Konto, die Berechtigung und der Anbieter müssen diese Operation erlauben. Die unten aufgeführten optionalen Einstellungen erfordern Modellunterstützung; die Sicherheitsgrenzen der API garantieren nicht, dass jedes Modell jeden Wert unterstützt.

Eine Anfrage senden#

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"
      }
    }
  }
}'

Anforderungsfelder#

FeldTypBedeutung und Grenzen
model erforderlichZeichenketteExakte aktivierte öffentliche Modellkennung. Muss diese Operation deklarieren und von Ihrer Berechtigung erlaubt sein.
state erforderlichArray1–256 Text- oder modellunterstützte typisierte Medienzustandswerte. Kombiniertes Anfragelimit beträgt 2 MiB.
questions erforderlichObjekt1–100 benannte Fragen. Jede hat den Typ noul, choice oder score, Anweisungen und passende Kriterien. choice verwendet eine Schlüssel-zu-Beschreibung-Karte; score verwendet eine geordnete Liste; noul verwendet Wahr/Falsch-Kriterien.
providerObjektOptionale Routing-Präferenzen für Anbieter. Verwenden Sie provider.only für akzeptierte Anbieter-Tags, nicht als Präfix in der Modell-ID. Konto- und Berechtigungsbeschränkungen gelten weiterhin.

Das Ergebnis lesen#

Erfolg gibt HTTP 200 mit JSON zurück. Verwenden Sie den stabilen ShareAI-Endpunkt /api/v1/decisions. Stellen Sie ein nicht leeres Zustandsarray und benannte Fragen mit noul, choice oder score Typen und passenden Kriterien bereit. Bis zu 100 Fragen und 256 Zustandswerte werden akzeptiert, innerhalb des 2-MiB-Anfragelimits.

Abrechnungseinheiten#

Entscheidungsmodelle verwenden Eingabe-Token oder andere explizit veröffentlichte Eingabe-/Anfrageeinheiten. Strukturierte Entscheidungswerte sind keine Ausgabemengen von Token. Es werden nur gemeldete, validierte Messungen im aktiven Tarif abgerechnet.

Wählen Sie die exakte aktivierte Modellkennung aus der Konsole. Die deklarierte Operation und die Eingabe-/Ausgabefunktionen müssen mit diesem Endpunkt übereinstimmen; ein Text-Chat-Modell kann nicht für eine andere Operation ersetzt werden. Ihre Berechtigungen, Anbieter- und Kontobeschränkungen gelten weiterhin.

Preise und Nutzung#

Die Tarife werden in EUR AI-Credits für das ausgewählte Modell, den Anbieter, die Einheiten und Varianten veröffentlicht. Es werden nur die Dimensionen im aktiven Tarif berechnet. Eine Schätzung reserviert Credits vor der Ausführung; die endgültigen Kosten basieren auf gemessener Nutzung. Preise können von der Auflösung, dem Ausgabeformat oder einem Nutzungsband abhängen. Überprüfen Sie die Konsolennutzung für die endgültige ShareAI-Belastung. Upstream-Kostenfelder und Medienbytes werden nicht in erfundene Token-Mengen umgerechnet.

Zugriff und Fehler#

Verwenden Sie inference für genehmigte netzwerkkostenbasierte Inferenz oder monetization_gateway für einen genehmigten Builder-Aufschlag und akzeptierte Abrechnungsbedingungen. Zugriff nur mit Identitätsnachweis autorisiert keine Ausgaben. Validierung, Modellautorisierung, unzureichende Credits, Ratenlimits und Ausführungsfehler geben eine strukturierte error. Nach einem Timeout oder einer unsicheren Übermittlung überprüfen Sie die Nutzung oder den Videoauftrag, bevor Sie eine weitere potenziell kostenpflichtige Anfrage erstellen.

Zuletzt aktualisiert am 3. November 2026

ShareAI Plattform-Dokumentation
Alle Dokumentationen

Nach Titel oder Inhalt suchen.

Fragen zu dieser Seite

Wählen Sie einen Assistenten, um diese Seite zu erkunden. Sie können die Seite auch kopieren und in Ihr Gespräch einfügen.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI