Toma decisiones estructuradas
Usa el endpoint estable de ShareAI /api/v1/decisions.
En esta página
https://api.shareai.now/api/v1/decisionsToma decisiones estructuradas
- URL base
https://api.shareai.now- Autenticación
- Clave API Bearer o token de acceso OAuth aprobado
- Alcance requerido
inferenceormonetization_gateway
Usa el endpoint estable de ShareAI /api/v1/decisions. Proporciona un array de estado no vacío y preguntas nombradas con noul, choice o score tipos y criterios de coincidencia. Se aceptan hasta 100 preguntas y 256 entradas de estado, dentro del límite de solicitud de 2 MiB.
Antes de comenzar#
Configure SHAREAI_API_KEY en su servidor y reemplace el marcador de posición del modelo con un modelo actualmente habilitado. Nunca exponga la clave API en el código del navegador. El modelo, la cuenta, las credenciales y el proveedor deben permitir esta operación. Las configuraciones opcionales a continuación requieren soporte del modelo; los límites de seguridad de la API no garantizan que todos los modelos admitan todos los valores.
Envía una solicitud#
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);Campos de solicitud#
| Campo | Tipo | Significado y límites |
|---|---|---|
model requerido | cadena | Identificador exacto de modelo público habilitado. Debe declarar esta operación y estar permitido por sus credenciales. |
state requerido | matriz | 1–256 entradas de estado de texto o medios tipados compatibles con el modelo. El límite combinado de solicitud es de 2 MiB. |
questions requerido | objeto | 1–100 preguntas nombradas. Cada una tiene tipo noul, choice o score, instrucciones y criterios de coincidencia. choice utiliza un mapa de clave a descripción; score utiliza una lista ordenada; noul utiliza criterios de verdadero/falso. |
provider | objeto | Preferencias opcionales de enrutamiento del proveedor. Use provider.only para etiquetas de proveedor aceptadas, no como prefijo en el ID del modelo. Las restricciones de cuenta y credenciales aún se aplican. |
Leer el resultado#
El éxito devuelve HTTP 200 con JSON. Usa el endpoint estable de ShareAI /api/v1/decisions. Proporciona un array de estado no vacío y preguntas nombradas con noul, choice o score tipos y criterios de coincidencia. Se aceptan hasta 100 preguntas y 256 entradas de estado, dentro del límite de solicitud de 2 MiB.
Unidades de facturación#
Los modelos de decisión utilizan unidades de entrada-token u otras unidades de entrada/solicitud explícitamente publicadas. Los valores de decisión estructurados no son cantidades de salida-token. Solo se facturan las mediciones reportadas y validadas en la tarifa activa.
Elija el identificador exacto del modelo habilitado desde la Consola. Su operación declarada y capacidades de entrada/salida deben coincidir con este endpoint; un modelo de chat de texto no puede sustituirse por otra operación. Sus restricciones de credenciales, proveedor y cuenta aún se aplican.
Precios y uso#
Las tarifas se publican en créditos de IA en EUR para el modelo, proveedor, unidades y variantes seleccionados. Solo se cobran las dimensiones en su tarifa activa. Una estimación reserva créditos antes de la ejecución; los cargos finales usan el uso medido. Los precios pueden depender de la resolución, el formato de salida o una banda de uso. Consulte Uso en la Consola para el débito final de ShareAI. Los campos de costos ascendentes y bytes de medios no se convierten en recuentos de tokens inventados.
Acceso y errores#
Usar inference para inferencia aprobada con costo de red o monetization_gateway para un margen aprobado del Builder y términos de facturación aceptados. El acceso solo con identidad no autoriza gastos. La validación, autorización del modelo, créditos insuficientes, límites de tarifa y fallos de ejecución devuelven una error. estructura. Después de un tiempo de espera o envío incierto, inspeccione Uso o el trabajo de video antes de crear otra solicitud potencialmente pagada.
Última actualización noviembre 3, 2026.