ShareAI Platform Docs

Toma decisiones estructuradas

Usa el endpoint estable de ShareAI /api/v1/decisions.

Ver como Markdown
En esta página
POST https://api.shareai.now/api/v1/decisions

Toma decisiones estructuradas

URL base
https://api.shareai.now
Autenticación
Clave API Bearer o token de acceso OAuth aprobado
Alcance requerido
inference or monetization_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"
      }
    }
  }
}'

Campos de solicitud#

CampoTipoSignificado y límites
model requeridocadenaIdentificador exacto de modelo público habilitado. Debe declarar esta operación y estar permitido por sus credenciales.
state requeridomatriz1–256 entradas de estado de texto o medios tipados compatibles con el modelo. El límite combinado de solicitud es de 2 MiB.
questions requeridoobjeto1–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.
providerobjetoPreferencias 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.

Documentación de la plataforma ShareAI
Toda la documentación

Buscar por título o contenido.

Preguntar sobre esta página

Elige un asistente para explorar esta página. También puedes copiar la página y pegarla en tu conversación.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI