Integrations
OpenAI
OpenAI Integration
Connect OpenAI models to your HIVE Protocol account.
Setup
Getting Your API Key
- Go to OpenAI Platform
- Sign in or create an account
- Navigate to API Keys
- Click Create new secret key
- Copy the key (it won't be shown again)
Adding to HIVE Protocol
- Go to Settings > Integrations
- Find the OpenAI card
- Click Configure
- Paste your API key
- Click Save
Available Models
| Model | Description | Context |
|---|---|---|
| gpt-4o | Most capable, multimodal | 128K |
| gpt-4o-mini | Fast and affordable | 128K |
| gpt-4-turbo | High performance | 128K |
| gpt-3.5-turbo | Quick and economical | 16K |
Configuration Options
Provider: OpenAI
API Key: sk-...
Default Model: gpt-4o
Temperature: 0.7
Max Tokens: 4096
Organization ID: org-... (optional)Usage Notes
Rate Limits
OpenAI enforces rate limits based on your usage tier:
| Tier | RPM | TPM |
|---|---|---|
| Free | 3 | 40,000 |
| Tier 1 | 500 | 200,000 |
| Tier 2 | 5,000 | 2,000,000 |
| Tier 3+ | Higher | Higher |
Error Handling
Common errors and solutions:
| Error | Cause | Solution |
|---|---|---|
| 401 | Invalid API key | Check key in Settings |
| 429 | Rate limit | Wait or upgrade tier |
| 503 | Service unavailable | Retry in a few minutes |
Best Practices
1. Use Organization ID
If you have multiple OpenAI organizations:
API Key: sk-...
Organization: org-abc1232. Monitor Usage
Check OpenAI dashboard for:
- Current usage
- Cost breakdown
- Rate limit status
3. Choose the Right Model
| Need | Model |
|---|---|
| Highest quality | gpt-4o |
| Balance of cost/quality | gpt-4o-mini |
| Budget-friendly | gpt-3.5-turbo |