Authentication

Authorization: Bearer ct_your_api_key_here

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"
  }'

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

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1709136000

{
  "error": "Unauthorized",
  "message": "Invalid API key"
}

{
  "error": "Rate limit exceeded",
  "retry_after": 60
}