Skip to main content

Quickstart icon Quickstart

Goal: from zero to first valid response in minutes.

1) Configure your API key and endpoint

Set these variables in bot .env:
AI_PROVIDER=openai
OPENAI_BASE_URL=https://api.aicord.cloud/v1
OPENAI_API_KEY=<customer_or_tenant_api_key>
OPENAI_MODEL=aicord/fast
AI_FALLBACK_PROVIDERS=

2) Configure Discord channels

Use slash commands:
  1. /chat user channel
  2. /chat admin channel
  3. Optional: /chat prompt edit

3) Validate API connectivity

curl https://api.aicord.cloud/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "aicord/fast",
    "messages": [{"role":"user","content":"Say OK"}],
    "temperature": 0.2
  }'
Expected result: 200 OK and text in choices[0].message.content.

4) Go-live checklist

  • Bot replies in configured channels
  • /doctor live_probe:true passes
  • /panel opens and settings persist
  • API key is not exposed in public repos
  • Fallback path is documented