Guías de integración · 2026-10-10
API de Perplexity Decider: decisiones con probabilidades en /v1/systemone a 0,02 $ por 1M de tokens
Llama a Perplexity Decider como perplexity/pplx-decider-v1.1-27b en el endpoint /v1/systemone de LLMTR: sí/no, opción y puntuación a 0,02 $ por 1M de tokens.
Respuesta corta: un modelo de decisión que devuelve probabilidades, no texto
LLMTR (llmtr.com) es una pasarela que da acceso a modelos de lenguaje alojados en Turquía y en proveedores globales a través de una única API compatible con OpenAI. Allí llamas a Perplexity Decider con el id de modelo perplexity/pplx-decider-v1.1-27b en el endpoint https://llmtr.com/v1/systemone; la dirección base es https://llmtr.com/v1, como en el resto de modelos. Cuesta 0,02 $ por 1M de tokens de entrada; la salida no tiene precio y no hay tarifa por solicitud.
Decider no es un modelo de chat. Le envías un estado (state) y tus preguntas (questions), y devuelve una respuesta estructurada por pregunta: la probabilidad de sí, una de tus opciones o una posición en tu propia escala. No hay texto libre que analizar y cada respuesta trae probabilidades; con un umbral decides qué se aplica de forma automática.
Cómo llamar a la API de Perplexity Decider
Envía la solicitud a https://llmtr.com/v1/systemone con POST y tu clave API de LLMTR en el encabezado Authorization: Bearer. El cuerpo tiene tres campos: model, state y questions. state puede ser texto plano, un objeto JSON o un array; questions es un mapa cuyas claves eliges tú. La solicitud de abajo hace tres preguntas sobre un mensaje de cliente.
Las claves no se envían al modelo y solo emparejan cada respuesta con su pregunta; escribe la pregunta completa en instructions. Las preguntas se evalúan por separado y una respuesta nunca es contexto de otra. El cuerpo se valida de forma estricta: un campo mal escrito recibe 400 invalid_request con su nombre en el mensaje. Si migras un cliente de la API propia de Perplexity, cambia la dirección y el campo model; en LLMTR cada pregunta debe llevar el campo instructions.
Solicitud curl que hace una pregunta noul, una choice y una score sobre un mensaje de soporte.
curl https://llmtr.com/v1/systemone \
-H "Authorization: Bearer $LLMTR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "perplexity/pplx-decider-v1.1-27b",
"state": "Order 4417 arrived with a cracked screen. I want my money back, this is the second time.",
"questions": {
"refund_requested": {
"type": "noul",
"instructions": "Does the customer ask for a refund?"
},
"team": {
"type": "choice",
"instructions": "Which team should handle this message?",
"criteria": {
"billing": "Payments, invoices, refunds",
"technical": "Bugs, outages, integrations",
"other": null
}
},
"frustration": {
"type": "score",
"instructions": "How frustrated does the customer appear?",
"criteria": ["Calm", "Frustrated but civil", "Very angry"]
}
}
}'
Los tres tipos de pregunta: noul, choice y score
noul es una pregunta de sí/no y devuelve la probabilidad de sí, entre 0 y 1; criteria es opcional y solo explica los extremos true y false. choice elige una de las opciones que defines en criteria y devuelve la distribución de probabilidad entre todas. Si una entrada puede no encajar, añade una opción como other; si no, el modelo devuelve siempre la opción más cercana.
score devuelve una posición a lo largo de niveles ordenados. Según la documentación de Perplexity, el valor es la media de los índices de nivel ponderada por probabilidad, así que puede caer entre dos niveles. No confundas una pregunta de sí/no con un nivel: un noul de 0,5 no significa un nivel intermedio, significa que el modelo da la misma probabilidad al sí y al no.
| Tipo | criteria | Campos de la respuesta | Límite |
|---|---|---|---|
| noul | opcional: descripción de true y false | noul (probabilidad de sí, 0-1) | ninguno |
| choice | nombre de opción con descripción o null | choice, probabilities, confidence | 1-255 opciones |
| score | lista ordenada de niveles | score, legend, probabilities, confidence | 2-10 niveles |
Cómo leer la respuesta y dónde poner un umbral
La respuesta vuelve bajo answers con tus claves y cada respuesta lleva su propio campo type. model devuelve el id del catálogo de LLMTR y usage, los tokens de entrada y de salida. En score, legend relaciona cada índice con el nombre de tu nivel. Abajo va el formato para la solicitud anterior; los valores son de ejemplo.
confidence solo aparece en choice y score y resume cuánto de la distribución se concentra en una opción. Si solo necesitas la opción más probable, basta con leer choice. Un umbral sirve donde separas aplicar una decisión automáticamente y pasarla a una persona. Guarda umbrales y preguntas juntos, en un solo archivo.
Respuesta de ejemplo: los campos tienen el formato que devuelve Decider, los números son ilustrativos.
{
"model": "perplexity/pplx-decider-v1.1-27b",
"answers": {
"refund_requested": { "type": "noul", "noul": 0.97 },
"team": {
"type": "choice",
"choice": "billing",
"confidence": 0.9,
"probabilities": { "billing": 0.93, "technical": 0.05, "other": 0.02 }
},
"frustration": {
"type": "score",
"score": 1.62,
"confidence": 0.62,
"legend": { "0": "Calm", "1": "Frustrated but civil", "2": "Very angry" },
"probabilities": { "0": 0.02, "1": 0.34, "2": 0.64 }
}
},
"usage": { "input_tokens": 389, "output_tokens": 3 }
}
Precio: se factura por token de entrada y el estado se cuenta en cada pregunta
perplexity/pplx-decider-v1.1-27b cuesta 0,02 $ por 1M de tokens de entrada y la salida no tiene precio. Aun así, output_tokens en usage puede ser mayor que cero: lo gratuito es el precio de la salida, no su recuento. A este modelo no se le añade margen; la comisión de plataforma del 8 % de LLMTR solo se cobra al recargar crédito.
El estado se cuenta de nuevo en cada pregunta. Cinco preguntas sobre un estado de 2.000 tokens facturan unos 10.000 tokens de entrada (sin el texto de las preguntas), unos 0,0002 $; envía solo las preguntas que vas a usar. El campo opcional max_budget_usd rechaza la solicitud si el coste estimado supera ese valor; para un tope estricto, usa el límite de gasto por clave API.
Límites, códigos de error y la versión v1
Una solicitud lleva como máximo 128 preguntas; más devuelven 400 provider_error. Cada pregunta junto con el estado debe quedar por debajo de 262.144 tokens; si lo supera, la solicitud devuelve 502 tras cerca de un minuto. Pon el timeout de tu cliente en 90 segundos como mínimo. No hay streaming, y se devuelve 429 cuando se supera el límite de solicitudes de la clave.
perplexity/pplx-decider-v1-27b es la primera versión del mismo modelo, con el mismo precio, contexto y formato. Una integración fijada a ella sigue funcionando sin cambiar el id; un trabajo nuevo empieza con perplexity/pplx-decider-v1.1-27b. Los modelos Decider no aparecen en el Playground ni en los endpoints de chat; solo responden en /v1/systemone.
Llamar a Perplexity Decider a través de LLMTR
Crea una cuenta, genera una clave API y envía tu primera solicitud de decisión a https://llmtr.com/v1/systemone con perplexity/pplx-decider-v1.1-27b.
- Cuenta. Crea una cuenta en llmtr.com y recarga crédito. Las solicitudes se descuentan del crédito prepago al precio del catálogo.
- Clave API. Crea una clave en Dashboard > API Keys. La clave sin procesar se muestra una sola vez; guárdala en la variable de entorno LLMTR_API_KEY. La misma clave sirve para todos los modelos del catálogo.
- Primera decisión. Envía un cuerpo JSON con model, state y questions a https://llmtr.com/v1/systemone y lee las probabilidades bajo answers.
Frequently asked questions
¿Cuánto cuesta la API de Perplexity Decider?
En LLMTR, perplexity/pplx-decider-v1.1-27b cuesta 0,02 $ por 1M de tokens de entrada; la salida no tiene precio y no hay tarifa por solicitud. El estado se cuenta en cada pregunta, así que los tokens crecen con el número de preguntas.
¿Perplexity Decider genera texto?
No. Devuelve una respuesta estructurada por pregunta: la probabilidad de sí en noul, la opción elegida y sus probabilidades en choice, y una posición en tu propia escala en score. No admite streaming.
¿Se puede llamar a Perplexity Decider con el SDK de OpenAI?
No con un cliente de Chat Completions; Decider solo responde en https://llmtr.com/v1/systemone. Sirve cualquier cliente HTTP: envía un cuerpo JSON con model, state y questions y el encabezado Authorization: Bearer.