cicora.ai
Especificación de la APIPolítica de entrega

Enrutamiento

Expresa los requisitos de ejecución en las preferencias de proveedor y conserva el resultado real para fines de observabilidad.

Referencia de integración: elige los parámetros y las capacidades disponibles en la configuración de la API de tu cuenta y en el catálogo de modelos de tu entorno.

Establece preferencias

El campo provider establece reglas de selección de ejecución para una solicitud. Trátalo como política, no como promesa de una ruta interna concreta.

Para tareas con propiedades obligatorias, exige explícitamente los parámetros pertinentes en lugar de reducir la calidad en silencio.

Preferencias de enrutamiento en una solicitud
json
{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "Classify this support ticket."}],
  "provider": {
    "order": ["provider-a", "provider-b"],
    "allow_fallbacks": true,
    "require_parameters": true
  }
}

Restricciones útiles

  • order establece la prioridad de las opciones permitidas.
  • allow_fallbacks define si una solicitud puede pasar a una alternativa.
  • require_parameters ayuda a rechazar una ruta que no puede cumplir el contrato declarado.

Observabilidad

Guarda el modelo seleccionado, los tiempos, el estado y el gasto en tu propio registro. No presentes al usuario como hechos detalles internos de enrutamiento que no figuren en la respuesta.

Cuando se agoten las opciones, responde de forma predecible: devuelve la causa original y ofrece un nuevo intento con una configuración compatible.