Skip to main content

Getting Your First API Key

1

Visit TaamCloud

2

Access Developer Portal

After logging in, go to Settings > Developer Portal
3

Generate API Key

  1. Navigate to API Keys section
  2. Click “Generate New Key” button
  3. Save your key securely - it won’t be shown again!
4

Test Your Key

Try a simple API request:
curl https://api.gately.ai/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
Save your API key securely - it won’t be shown again!

Using Your API Key

Include your API key in the Authorization header:
curl https://api.gately.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Authentication Requirements

The following endpoints require authentication:
  • Chat Completions (/v1/chat/completions)
  • Embeddings (/v1/embeddings)
  • Image Generation (/v1/images/generations)
  • Model List (/v1/models)
  • Music Generation (/suno/submit/music)
  • Reranking (/v1/rerank)
These endpoints don’t require authentication:
  • File Upload (/upload)
  • Web Crawling (/v1/crawl)
  • Web Scraping (/v1/scrape)
  • Site Mapping (/v1/map)

Best Practices

  1. Key Security
    • Never share your API keys
    • Don’t commit keys to version control
    • Use environment variables
    • Rotate keys periodically
  2. Rate Limiting
    • Monitor your usage
    • Implement backoff strategies
    • Contact support for limit increases
  3. Error Handling
    • Handle authentication errors (401)
    • Check for expired keys
    • Implement key rotation logic

Managing Multiple Keys

You can generate multiple API keys for different purposes:
  • Development vs. Production
  • Different applications
  • Service isolation

Revoking Keys

If a key is compromised:
  1. Log into the Developer Portal
  2. Find the compromised key
  3. Click “Revoke Key”
  4. Generate a new key
  5. Update your applications
Revoked keys cannot be restored. Make sure to update your applications before revoking a key.