cicora.ai
Especificación de la APICLI y aplicaciones

CLI e integraciones

Configura un cliente con clave, modelo y URL base que coincida con su protocolo; guarda el secreto en el entorno.

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.

Elige la URL compatible

Para un cliente de estilo OpenAI, establece CICORA_API_BASE_URL=https://cicora.ai/api/v1 y no añadas un segundo /v1.

Para un cliente de Messages o Claude Code, establece ANTHROPIC_BASE_URL=https://cicora.ai/api: ese cliente añade /v1/messages por sí mismo. Verifica la configuración mediante el catálogo de modelos antes de la inferencia.

Configuración de cliente compatible
bash
export CICORA_API_BASE_URL=https://cicora.ai/api/v1
export CICORA_API_KEY=replace_with_your_key

curl "$CICORA_API_BASE_URL/models" \
  --header "Authorization: Bearer $CICORA_API_KEY"

Lanzamiento seguro

  • Pasa variables de entorno mediante un gestor de secretos o perfil seguro.
  • Excluye archivos .env y configuraciones exportadas de los commits.
  • Asigna a cada aplicación su propia clave para poder revocar el acceso sin detener las demás.

Contrato portátil

Conserva registros de solicitudes y respuestas sin Authorization ni datos del usuario cuando tu régimen de retención lo permita.

Si un cliente compone su propia ruta, compara la URL final en su registro de depuración antes de la primera generación.