cicora.ai
API specificationCLI and apps

CLI and integrations

Configure a client with a key, model, and base URL that matches its protocol; keep the secret in the environment.

Integration reference: choose parameters and available capabilities from your account API settings and the model catalogue for your environment.

Choose the compatible URL

For an OpenAI-style client, set CICORA_API_BASE_URL=https://cicora.ai/api/v1 and do not add a second /v1.

For a Messages client or Claude Code, set ANTHROPIC_BASE_URL=https://cicora.ai/api: that client appends /v1/messages itself. Verify configuration through the model catalogue before inference.

Compatible client configuration
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"

Safe launch

  • Pass environment variables through a secrets manager or safe profile.
  • Exclude .env files and exported configurations from commits.
  • Give each application its own key so access can be revoked without stopping others.

Portable contract

Keep request and response logs without Authorization or user data when your retention regime allows it.

If a client composes its own path, compare the final URL in its debug log before the first generation.