Skip to main content
Banan0 API Docs

Authentication

Learn how to authenticate with the Banan0 API.

Authentication

All API requests require authentication via Bearer token.

API Key Format

  • Live keys: bnn_live_... - Use in production, charges tokens
  • Test keys: bnn_test_... - Use in development, no charges

    • Usage

    Include your API key in the Authorization header:

    bash
    curl -H "Authorization: Bearer bnn_live_your_key" \
  "https://banan0.com/api/v1/models"

    Creating API Keys

    1. Go to [Settings](https://banan0.com/settings)

    2. Find "Public API Keys" section

    3. Click "Create Key"

    4. Configure:

    - Name - Descriptive name (e.g., "Production Server")

    - Scopes - Permissions the key has

    - Rate Limit - Requests per minute (default: 60)

    Available Scopes

    ScopeDescription
    models:readList and view model details
    models:runExecute model runs
    runs:readView run status and results
    runs:cancelCancel running jobs
    webhooks:manageCreate and manage webhooks

    Security Best Practices

  • Never expose keys in client-side code
  • Use environment variables to store keys
  • Rotate keys periodically
  • Use test keys during development
  • Set appropriate rate limits

    • Command Palette

    Search for a command to run...