Skip to main content
POST
Tomar decisiones estructuradas
Usa POST /v1/decisions cuando tu aplicación necesite respuestas estructuradas que el código pueda consumir directamente. Los modelos compatibles incluyen TypeSafe Jev 1.13 (typesafe/jev-1.13.0), Together Tev1 4B Experimental (together/tev1-4b-experimental) y Respan Span-01 (respan/span-01:free y respan/span-01). La solicitud contiene:
  • state: una cadena, objeto o matriz que contiene la información que se va a evaluar.
  • questions: un mapa de preguntas con nombre. Cada pregunta establece type en noul, choice o score e incluye instructions; los tipos compatibles dependen del modelo seleccionado.
  • model: el identificador del modelo de Phaseo. Usa typesafe/jev-1.13.0 para Jev 1.13 o typesafe/jev-latest para seguir la última versión de Jev.
Liquid D1 (liquid-ai/d1:free, también disponible como liquid-ai/d1) y Perplexity Decider 27B (perplexity/decider-27b) admiten los tres tipos de preguntas. D1 es gratuito durante el acceso anticipado experimental. Decider cuesta 0,04 USD por millón de tokens de entrada, incluidos los de imagen; los tokens de salida son gratuitos. Añade una credencial del proveedor Perplexity en Phaseo para usar Decider. Su estado con imágenes usa URL de datos base64 PNG, JPEG o WebP; no admite URL de imágenes remotas. Cada pregunta de elección acepta hasta 255 opciones y cada pregunta de puntuación hasta 10 niveles. Comprueba la disponibilidad antes de invocar cualquiera de los modelos. Para Respan Span-01, state debe ser un segmento de conversación con una matriz input de mensajes previos y un mensaje output del asistente. Span-01 solo admite preguntas noul. La respuesta noul es la probabilidad de que el comportamiento esté presente; probabilities también incluye las probabilidades de ausencia y de no poder observarlo.
respan/span-01:free es el modelo Lite gratuito con un límite diario; Phaseo lo asigna al identificador de modelo API span-01-free de Respan. respan/span-01 se asigna al identificador span-01-pro de Respan y Respan lo factura a 0,02 USD por millón de tokens de entrada; los tokens de salida son gratuitos. Span-01 está en acceso anticipado, así que Respan debe habilitar el acceso para tu organización. Añade tu clave API de Respan como credencial del proveedor Respan en Phaseo antes de invocar estos modelos. Las respuestas usan las mismas claves que questions. Las respuestas choice incluyen la opción seleccionada, probabilidades y confianza; las respuestas noul incluyen una probabilidad de 0 a 1; y las respuestas score incluyen una puntuación ponderada por probabilidad, leyenda, probabilidades y confianza. Para el ejemplo de Respan, una respuesta tiene este aspecto:
Jev permite combinar los tres tipos de preguntas en una solicitud; Span-01 solo admite preguntas noul. Consulta el inicio rápido para ver ejemplos de cURL, JavaScript, SDK de TypeScript y SDK de Python listos para copiar y pegar. Jev 1.13 se factura a 0,042 USD por millón de tokens de entrada; los tokens de salida son gratuitos. Para conocer la semántica de las preguntas del proveedor, consulta la referencia API de TypeSafe.

Decisiones sobre imágenes con Clef

cloudflare/clef y cloudflare/clef-flash admiten los tres tipos de preguntas e imágenes integradas mediante Cloudflare Workers AI. Cada uno tiene una ventana de contexto de 65.536 tokens. La entrada cuesta 0,24 USD por millón de tokens en Clef y 0,09 USD en Clef Flash.
También puedes proporcionar una cadena data:image/png;base64,... en images. Clef admite hasta cuatro imágenes PNG, JPEG o WebP, cada una de un máximo de 4 MiB y 16 megapíxeles, con un total máximo de 8 MiB de datos de imagen decodificados y un cuerpo de solicitud de 13 MiB. No se admiten URL remotas. Cloudflare valida los formatos y las dimensiones de las imágenes. Los modelos sin soporte para imágenes rechazan las solicitudes con imágenes. Clef admite un máximo de 64 preguntas, con identificadores de hasta 100 letras, dígitos, guiones bajos, puntos o guiones. Las preguntas de elección requieren entre 2 y 255 opciones; las de puntuación, entre 2 y 10 niveles. Consulta la documentación de Clef de Cloudflare.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

application/json
model
string
predeterminado:typesafe/jev-1.13.0
requerido

Identificador canónico del modelo de Phaseo o alias del modelo del proveedor.

state
requerido

Estado estructurado evaluado por el modelo.

questions
object
requerido
images
(string | object)[]

Imágenes integradas para modelos de decisión con capacidad visual. Clef acepta PNG, JPEG o WebP; no se admiten URL remotas. Máximo de 4 MiB y 16 megapíxeles por imagen, 8 MiB de datos decodificados en total y 13 MiB por cuerpo de solicitud.

Maximum array length: 4
Pattern: ^[Dd][Aa][Tt][Aa]:image/(png|jpeg|webp);base64,[A-Za-z0-9+/]+={0,2}$
meta
boolean
predeterminado:false
echo_upstream_request
boolean
debug
object

Controles de depuración de la pasarela. Estas opciones nunca se reenvían al proveedor.

provider
object

Preferencias de enrutamiento de proveedores para la selección de la pasarela.

routing
object

Preferencias de enrutamiento de proveedores para la selección de la pasarela.

metadata
object

Respuesta

200 - application/json

Respuesta de decisiones estructuradas

model
string
answers
object
usage
object
request_id
string | null
meta
object
Última modificación el 2 de octubre de 2026