Documentation Index
Fetch the complete documentation index at: https://docs.costrace.dev/llms.txt
Use this file to discover all available pages before exploring further.
API Keys
All API requests require authentication using your Costrace API key. You can find your API key in the dashboard.
Include your API key in the Authorization header:
Authorization: Bearer ct_your_api_key_here
Example Request
curl -X POST https://api.costrace.dev/v1/traces \
-H "Authorization: Bearer ct_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"provider": "openai",
"model": "gpt-4o",
"tokens_in": 100,
"tokens_out": 50,
"latency_ms": 1234,
"cost_usd": 0.005,
"api_key": "ct_your_api_key",
"status": "success"
}'
Key Management
Getting Your Key
- Sign up at costrace.dev/auth
- Navigate to your dashboard
- Copy your API key from the settings or API keys section
Security Best Practices
Never commit API keys to version control. Use environment variables instead.
export COSTRACE_API_KEY=ct_your_api_key
import os
costrace.init(api_key=os.environ["COSTRACE_API_KEY"])
# DON'T DO THIS
costrace.init(api_key="ct_abc123...") # Hardcoded key
Rotating Keys
If your API key is compromised:
- Generate a new key in the dashboard
- Update your application environment variables
- Revoke the old key
Rate Limits
API keys are subject to rate limits based on your plan:
| Plan | Traces/Month | Rate Limit |
|---|
| Free | 50,000 | 100/min |
| Pro | 500,000 | 1,000/min |
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1709136000
Error Responses
401 Unauthorized
Invalid or missing API key:
{
"error": "Unauthorized",
"message": "Invalid API key"
}
429 Too Many Requests
Rate limit exceeded:
{
"error": "Rate limit exceeded",
"retry_after": 60
}