cicora.ai
Especificación de la APIGeneración de texto

Chat Completions

Crea conversaciones de varios turnos con el formato messages habitual y selecciona un modelo en cada solicitud.

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.

Mensajes y roles

El array messages lleva el contexto como secuencia ordenada. System establece las reglas de la tarea, user añade una solicitud, y assistant y tool conservan el historial de ejecución.

No construyas el historial concatenando cadenas: conserva el rol y el orden original de cada mensaje.

Finalización de chat
bash
curl --request POST https://cicora.ai/api/v1/chat/completions \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/gpt-5.6-sol",
    "messages": [
      {"role": "system", "content": "Be concise and cite assumptions."},
      {"role": "user", "content": "Draft a release checklist."}
    ],
    "temperature": 0.2
  }'

Controla la salida

  • model identifica una familia y variante de modelo.
  • temperature, top_p y un límite de salida controlan la variación y el tamaño de la respuesta.
  • Envía solo parámetros que figuren como compatibles con el modelo elegido.

Bucle fiable

Separa un fallo de transporte de una respuesta del modelo con finish_reason. Un rechazo o límite de contexto es información de interfaz, no motivo para sustituir el resultado.

Cuando tus reglas de retención lo permitan, guarda el cuerpo de la solicitud fuente y la respuesta normalizada sin credenciales.