Saltar al contenido principal
POST
Tomar decisiones estructuradas
Este endpoint está en fase Beta. Envía input y un array ordenado de questions a POST /v1/decisions y recibe una respuesta tipada por pregunta, con probabilidades, en el mismo orden.

Toma una decisión

Esta solicitud hace una pregunta de cada tipo. Necesita una clave de API de Phaseo y una ruta disponible de openai/gpt-6-luna.
La respuesta (valores ilustrativos):

Escribe las preguntas

input es una cadena, o un array de mensajes user cuyo content es una cadena o una lista de partes input_text, input_image, input_audio e input_video. name es opcional; las respuestas mantienen el orden de la solicitud, incluidas las preguntas sin nombre y los nombres repetidos. Una solicitud lleva como máximo 128 preguntas, salvo en google/gemini-decision-1, que acepta hasta 1000, en parallel/decisions-fast, que acepta hasta 100, y en Clef, que acepta hasta 64. Una solicitud que supera el límite del modelo devuelve 400. Los valores de opción booleanos se devuelven como booleanos. Un modelo que se niega a responder una pregunta devuelve type: "refusal" para ella. Los tipos que admite cada modelo aparecen en Elige un modelo. Las imágenes van en partes input_image como data URLs. Las URLs HTTPS de imágenes alojadas solo funcionan en los modelos de Base Labs (baselabs/elephant-1, baselabs/mammoth-1 y baselabs/joey-1) y deben estar en Amazon S3, Google Cloud Storage o Azure Blob Storage. Una solicitud admite como máximo 128 imágenes, que Luna acepta; otros proveedores fijan límites más bajos. Un detail de imagen explícito y safety_identifier requieren una ruta de OpenAI.

Usa el formato de estado antiguo

Las solicitudes con state y un mapa de preguntas con nombre siguen funcionando y devuelven respuestas indexadas por esos mismos nombres. Together Tev (together/tev1-4b-experimental) requiere este formato, porque devuelve una etiqueta sin probabilidades, y solo responde preguntas choice. Respan Span-01 también usa este formato. No mezcles los formatos: input con state o images devuelve 400.
  • state: una cadena, un objeto o un array con la información que se evalúa.
  • questions: hasta 128 preguntas con nombre, o más en los modelos con un límite superior. Cada una configura type como noul (sí/no), choice o score, además de instructions. Las preguntas de opción aceptan criteria como un mapa de opción a descripción; las de puntuación aceptan criteria como un array de al menos dos descripciones de nivel.
  • Las preguntas locate solo usan instructions y necesitan un state de tipo cadena sin images; consulta Perplexity Decider.
  • images: hasta cuatro imágenes PNG, JPEG o WebP, como URLs data: u objetos { "content_type", "base64" }.
  • model: si se omite, es typesafe/jev-1.13.0 de forma predeterminada.
Las respuestas usan las mismas claves que questions. Las respuestas choice incluyen la opción seleccionada, las probabilidades y la confianza; las respuestas noul incluyen una probabilidad de 0 a 1; las respuestas score incluyen una puntuación ponderada por probabilidad, una leyenda, las probabilidades y la confianza.

Elige un modelo

Comprueba la disponibilidad del modelo antes de llamar a cualquiera de estos modelos. Los tokens de salida son gratuitos en todos los modelos de la lista con precio.

TypeSafe Jev

Usa typesafe/jev-1.13.0 para Jev 1.13, o typesafe/jev-latest para seguir la última versión de Jev. Para la semántica de las preguntas en el proveedor, consulta la referencia de la API de TypeSafe. En las rutas de TypeSafe compatibles, Jev 1.13 y 1.14 aceptan imágenes PNG o JPEG en línea mediante input_image o el campo antiguo images. Phaseo crea los recursos de imagen de TypeSafe y activa la compatibilidad con imágenes automáticamente. Las imágenes deben cumplir los límites de imagen de TypeSafe: como máximo 16 MiB cada una, de 256 a 1568 píxeles por lado y al menos 78.400 píxeles en total. TypeSafe valida las dimensiones y la codificación y no redimensiona las imágenes rechazadas. El cuerpo JSON asignado que se envía al proveedor está limitado a 32 MiB. Los tokens de imagen usan el precio de entrada normal. box (en rutas compatibles como Jev 1.14) requiere una imagen, no acepta criterios y devuelve un cuadro delimitador más la confianza. Sus bordes van de 0 a 1, medidos desde la esquina superior izquierda. Box siempre devuelve un rectángulo, así que combínalo con una pregunta predicate de presencia cuando el objetivo pueda no estar. Con el campo antiguo images, haz referencia a images[0]; con la entrada ordenada, haz referencia a la primera imagen o a [Image 0]. Consulta el contrato de Box. Configura provider_options.typesafe.long_context como true para elevar los límites de contexto por solicitud y por pregunta a 262k tokens, desde los valores predeterminados de 64k por solicitud y 32k por pregunta. El contexto largo cuesta lo mismo por token. Las imágenes, Box y el contexto largo son capacidades experimentales del proveedor.

Cloudflare Clef y Clef Flash

cloudflare/clef y cloudflare/clef-flash se ejecutan en Cloudflare Workers AI. Clef tiene una ventana de contexto de 65.536 tokens y Clef Flash, de 24.576 tokens.
images también acepta una cadena data:image/png;base64,.... Clef acepta hasta cuatro imágenes PNG, JPEG o WebP, de 4 MiB y 16 megapíxeles como máximo cada una, con un máximo de 8 MiB de datos de imagen decodificados y un cuerpo de solicitud de 13 MiB. No se admiten URLs remotas, y Cloudflare valida los formatos y las dimensiones de las imágenes. Los modelos sin compatibilidad con imágenes rechazan las solicitudes con imágenes. Clef acepta como máximo 64 preguntas, con IDs de hasta 100 letras, dígitos, guiones bajos, puntos o guiones. Las preguntas de opción necesitan de 2 a 255 opciones y las de puntuación, de 2 a 10 niveles. Consulta la documentación de Clef de Cloudflare.

Cloudflare Clef Omni

cloudflare/clef-omni acepta texto, imágenes, audio y vídeo. Las partes de audio y vídeo son extensiones de Phaseo al formato de entrada; las rutas de OpenAI solo aceptan texto e imágenes. Sustituye los bytes de audio y la URL de vídeo de ejemplo por tus propios archivos multimedia antes de enviar este ejemplo.
Envía el audio como input_audio.data con format: "wav" o "mp3", o como input_audio.url con una URL HTTPS pública o una data URL de audio en línea. input_video.video_url acepta una cadena o { "url": "..." } con una URL HTTPS pública o una data URL MP4/WebM en línea. Los servidores remotos deben devolver el Content-Type correspondiente. Phaseo descarga las URLs con límites de tamaño y comprobaciones de direcciones privadas y redirecciones, y después incrusta el contenido multimedia para Cloudflare; las credenciales del proveedor nunca se envían al servidor multimedia. Cloudflare valida la codificación multimedia, las dimensiones de las imágenes y la duración de los clips, y muestrea el vídeo a dos fotogramas por segundo. La pista de audio de un vídeo se usa cuando todos los vídeos de la solicitud tienen una. Los tokens multimedia cuentan para el contexto y la facturación; Phaseo liquida según el uso de entrada que informa Cloudflare y no añade ningún cargo aparte por audio o vídeo. Consulta el contrato de Omni de Cloudflare.

Liquid D1.2 y D1.2 Ultra

liquid-ai/d1.2 y liquid-ai/d1.2-ultra usan el formato de estado antiguo, con hasta cuatro imágenes y hasta ocho clips de audio. Envía audio como URLs data: en base64 (WAV, MP3, FLAC, M4A u OGG, cada URL de hasta 24 MiB, unos 18 MiB de audio); las URLs de audio remotas no son compatibles. Además de noul, choice y score, responden estos tipos de pregunta: Pon multiple: true en una pregunta choice para obtener todas las opciones que correspondan, en choices, con probabilities por opción. Los demás modelos devuelven 400 para estos tipos de pregunta y responden las preguntas multiple con una sola opción; los modelos sin entrada de audio ignoran audio. liquid-ai/d1, liquid-ai/d1.1 y liquid-ai/d1-ultra aceptan texto e imágenes y responden noul, choice y score.

Liquid D1 y Perplexity Decider

Liquid D1 (liquid-ai/d1:free) es gratuito durante el acceso anticipado experimental. Perplexity Decider V1.3 (perplexity/pplx-decider-v1.3, o perplexity/pplx-decider-latest) y Decider Flash V1.3 (perplexity/pplx-decider-flash-v1.3, o perplexity/pplx-decider-flash-latest) necesitan una credencial del proveedor Perplexity en Phaseo. Su estado de imagen usa data URLs en base64 PNG, JPEG o WebP; no se admiten URLs de imagen remotas. También responden preguntas locate, que devuelven las partes de un input o state de tipo cadena que coinciden con las instructions, como "email address". Cada fragmento tiene text copiado literalmente, posiciones start y end contadas en puntos de código Unicode (end es exclusiva) y un score en el que un valor más alto indica más certeza; spans está vacío cuando nada coincide. Locate no usa criteria ni admite imágenes, audio o vídeo, y solo funciona en los modelos que lo indican; los demás devuelven 400. Perplexity lo entrenó con entradas de hasta 8K tokens. En ambos, una pregunta de opción acepta hasta 255 opciones y una pregunta de puntuación hasta 10 niveles.

Inception Mercury Decide

inception/mercury-decide acepta evidencia en texto o JSON. Las preguntas de opción aceptan hasta 255 opciones y las de puntuación hasta 10 niveles. No se admiten imágenes, streaming ni llamadas a herramientas. El precio de entrada de $0.02 es la promoción del 50% de Inception, que no tiene fecha de fin publicada; consulta los precios actuales del proveedor antes de usarlo.

Microsoft Decision

microsoft/microsoft-decision-1 se ejecuta en un despliegue de Azure Foundry y acepta evidencia en texto o JSON de hasta 32.768 tokens. No se admiten contenido multimedia, streaming, herramientas, safety_identifier ni service_tier. Consulta la guía de Microsoft.

Respan Span-01

Span-01 usa el formato antiguo. state debe ser un tramo de conversación: un array input con los mensajes anteriores y un mensaje del asistente en output. Solo responde preguntas noul: el valor noul es la probabilidad de que el comportamiento esté presente, y probabilities también da las probabilidades de ausente y no observable.
Una respuesta tiene este aspecto:
respan/span-01:free es el modelo Lite gratuito con un límite diario y corresponde al modelo span-01-free de Respan. respan/span-01 corresponde a span-01-pro y lo factura Respan. Span-01 está en acceso anticipado: Respan debe habilitarlo para tu organización, y debes añadir tu clave de API de Respan como credencial del proveedor Respan en Phaseo antes de llamar a cualquiera de los dos modelos.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

application/json

Se recomienda el formato OpenAI. El formato anterior sigue admitido. La respuesta sigue la solicitud; no mezcles formatos.

model
string
requerido

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

Minimum string length: 1
input
requerido

Texto o mensajes con imágenes integradas. Audio y vídeo son extensiones de Phaseo para modelos compatibles; las rutas de decisiones OpenAI no las admiten.

Maximum string length: 10485760
questions
object[]
requerido
Required array length: 1 - 1000 elements
models
string[]

Modelos de respaldo opcionales y ordenados que se prueban después de model. model es obligatorio y siempre es el modelo principal. Cuando un intento falla con 429, 500, 502, 503 o 504, se prueba la siguiente entrada; los demás errores se devuelven sin cambios. Acepta hasta 25 IDs de modelo o presets; se ignoran los duplicados y las entradas iguales a model. Cada intento se valida, registra y factura como una solicitud independiente, y el campo model de la respuesta y la traza de enrutamiento muestran el modelo que atendió la solicitud. Las solicitudes en streaming solo recurren a un respaldo antes del primer byte, y los trabajos de video y música solo al enviarse. Las solicitudes de batch, realtime y council rechazan models. Los respaldos definidos en una ruta dinámica tienen prioridad, y phaseo/auto no se puede combinar con models.

Required array length: 1 - 25 elements
Minimum string length: 1
Ejemplo:
provider_options
object
safety_identifier
string | null

Identificador opaco del usuario. Solo rutas OpenAI.

Maximum string length: 128
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

Respuestas ordenadas para input/lista; mapa nombrado para state/mapa anterior.

model
string
requerido
answers
object[]
requerido

Una respuesta por pregunta en orden, incluso sin nombre o con nombres repetidos.

usage
object
requerido
request_id
string | null
meta
object
Última modificación el 16 de noviembre de 2026