Skip to main content
Aquila supports bring-your-own-key for the AI providers it talks to. Your key stays yours: Aquila stores it encrypted and never returns the secret through the API.

​
Store a key

PUT /api/provider-keys stores or replaces a key:
  • GET /api/provider-keys — list your keys. The response names the providers, never the secrets.
  • DELETE /api/provider-keys/{provider} — delete a stored key.

​
Models

  • GET /api/provider-keys/{provider}/models — the models your key can see.
  • PUT /api/provider-keys/{provider}/model — select the model that provider uses. Send null to clear the selection.

​
Platform model

The platform default model is an owner-level setting:
  • GET /api/models?provider=zai — list models for a provider.
  • GET /api/models/selected — the current default.
  • PUT /api/models/selected — set the default. Owner or admin only.