curl --request POST \
--url https://direct.evolink.ai/v1beta/decisions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-decision-1",
"input": "The blue mug I ordered on Monday arrived cracked on Wednesday.",
"questions": {
"is_damaged": {
"type": "noul",
"instructions": "Did the item arrive damaged?"
}
}
}
'{
"answers": {
"is_defect": {
"type": "noul",
"noul": 0.94,
"confidence": 0.94
},
"next_action": {
"type": "choice",
"choice": "human_escalation",
"probabilities": {
"human_escalation": 0.76,
"replacement_shipment": 0.18,
"troubleshooting_flow": 0.04,
"instant_refund": 0.02
},
"confidence": 0.76
},
"churn_risk": {
"type": "score",
"score": 2.99,
"legend": {
"0": "No churn signal",
"1": "Mild frustration",
"2": "Mentions alternatives",
"3": "Threatens to cancel"
},
"probabilities": {
"0": 0,
"1": 0,
"2": 0.01,
"3": 0.99
},
"confidence": 0.99
}
},
"usage": {
"total_input_tokens": 324,
"input_tokens_by_modality": [
{
"modality": "text",
"tokens": 324
}
],
"total_output_tokens": 0,
"total_tokens": 324
}
}Gemini Decisions - Referencia completa de parámetros
- Usa
gemini-decision-1para evaluar texto, imágenes, audio, vídeo y PDF con probabilidades de sí/no, elección única y puntuaciones - Devuelve todas las respuestas de forma síncrona; no admite streaming, Batch API ni caché de contexto
- Solo se facturan los tokens de entrada; la salida es gratuita. Cada solicitud tiene un cargo mínimo. Consulta los Precios de los modelos
- Para conversaciones o generación de texto, usa la API nativa de Gemini
curl --request POST \
--url https://direct.evolink.ai/v1beta/decisions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-decision-1",
"input": "The blue mug I ordered on Monday arrived cracked on Wednesday.",
"questions": {
"is_damaged": {
"type": "noul",
"instructions": "Did the item arrive damaged?"
}
}
}
'{
"answers": {
"is_defect": {
"type": "noul",
"noul": 0.94,
"confidence": 0.94
},
"next_action": {
"type": "choice",
"choice": "human_escalation",
"probabilities": {
"human_escalation": 0.76,
"replacement_shipment": 0.18,
"troubleshooting_flow": 0.04,
"instant_refund": 0.02
},
"confidence": 0.76
},
"churn_risk": {
"type": "score",
"score": 2.99,
"legend": {
"0": "No churn signal",
"1": "Mild frustration",
"2": "Mentions alternatives",
"3": "Threatens to cancel"
},
"probabilities": {
"0": 0,
"1": 0,
"2": 0.01,
"3": 0.99
},
"confidence": 0.99
}
},
"usage": {
"total_input_tokens": 324,
"input_tokens_by_modality": [
{
"modality": "text",
"tokens": 324
}
],
"total_output_tokens": 0,
"total_tokens": 324
}
}https://direct.evolink.ai de forma predeterminada; https://api.evolink.ai es la dirección de respaldo.Autorizaciones
Autentícate con tu API Key de EvoLink como token Bearer.
Obtener una API Key:
Visita la página de gestión de API Keys.
Cabecera de la solicitud:
Authorization: Bearer YOUR_API_KEY
Cuerpo
El cuerpo de la solicitud solo acepta model, input y questions. Cualquier otro campo (como stream) devuelve 400 invalid_request.
ID del modelo. Usa gemini-decision-1.
Este modelo no es un modelo de conversación y solo funciona en este endpoint. Por ejemplo, enviarlo al endpoint GPT Decisions /v1/decisions devuelve 400 model_endpoint_mismatch.
gemini-decision-1 "gemini-decision-1"
Entrada compartida por todas las preguntas: una cadena de texto, un solo bloque de contenido o un array de bloques de contenido (texto, imagen, audio, vídeo o documento PDF). La entrada no puede estar vacía. Los bloques de texto contiguos se concatenan en orden sin separador; añade tú mismo espacios o saltos de línea. Para enviar datos JSON, serialízalos como cadena y envíalos como texto.
1"I was charged twice for my order."
Preguntas que evaluar, como un mapa de clave de pregunta a pregunta: de 1 a 1.000 preguntas. Tú eliges las claves (de 1 a 64 caracteres que cumplan [A-Za-z0-9_-]+) y cada respuesta se devuelve con la misma clave. El modelo nunca ve las claves, así que escribe la pregunta completa en instructions.
| Tipo | Para qué sirve | Resultado principal |
|---|---|---|
noul | Comprobar si una afirmación se cumple | noul: probabilidad de «sí» (0,01 a 0,99) |
choice | Elegir una opción de una lista fija | choice: el ID de opción más probable |
score | Puntuar la entrada en niveles ordenados | score: puntuación de nivel ponderada por probabilidades |
Cada pregunta se evalúa de forma independiente sobre la misma entrada y no ve las demás; se pueden combinar tipos de pregunta. Si las preguntas dependen unas de otras, divídelas en solicitudes separadas. La entrada y todas las preguntas comparten una ventana de contexto de 262.144 tokens.
Show child attributes
Show child attributes
{
"is_damaged": {
"type": "noul",
"instructions": "Did the item arrive damaged?"
}
}
Respuesta
Una respuesta por pregunta, con las mismas claves que las preguntas de la solicitud
Una respuesta por pregunta, con las mismas claves que las preguntas de la solicitud; el type de cada respuesta coincide con su pregunta. Vacío cuando prompt_feedback.block_reason está definido
Show child attributes
Show child attributes
Uso de tokens. Solo se facturan los tokens de entrada (total_input_tokens): los tokens de texto, imagen, audio, vídeo y PDF tienen el mismo precio, y la salida siempre es 0. Cada solicitud tiene un cargo mínimo. Consulta los Precios de los modelos para conocer las tarifas actuales. No se admite la caché de contexto; la entrada repetida se factura por separado en cada solicitud. Si una respuesta HTTP 200 contiene prompt_feedback.block_reason, el uso de entrada se sigue facturando. Si no se devuelven datos de uso válidos, la facturación se basa en una estimación.
Show child attributes
Show child attributes
Resultado de los filtros de contenido aplicados a la entrada. Cuando block_reason está definido, la entrada se bloqueó, no se evaluó ninguna pregunta y answers está vacío. Si se devuelve con HTTP 200, la solicitud se sigue facturando; consulta usage.
Show child attributes
Show child attributes