Authentication

API Keys

The InferHood API uses API keys for authentication. You can create and manage API keys in the dashboard. A live API key will always start with ih_live_.

Authorizing Requests

Provide your API key in the Authorization header of your HTTP requests as a Bearer token.

curl https://api.inferhood.xyz/v1/models \
  -H "Authorization: Bearer ih_live_your_api_key_here"

Key Scopes

When creating an API key, you can assign it specific scopes to limit its access. Available scopes include:

• inference:read - Allow reading inference histories (if applicable)
• inference:write - Allow generating inferences (chat completions, images)
• models:read - Allow listing available models and pricing

Security Best Practices

• Never commit your API keys to version control (GitHub, GitLab, etc).
• Use environment variables (e.g., .env files) to load your keys securely in your application.
• If a key is compromised, immediately revoke it in the dashboard and generate a new one.