Skip to main content
All requests to the Inference API must include a valid API key in the Authorization header.

​
API key format

Impulse Labs API keys start with imp_ followed by 64 hex characters: 
imp_a1b2c3d4e5f6...  (68 characters total)

​
Sending your key

Pass the key as a Bearer token in the Authorization header on every request: 
curl https://inference.impulselabs.ai/infer \
  -H "Authorization: Bearer imp_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ ... }'
Never include your API key in client-side code, URLs, or version control. Use environment variables or a secrets manager.

​
Creating an API key

1

Open the dashboard

Go to app.impulselabs.ai and sign in.
2

Navigate to API Keys

Click your avatar → Settings → API Keys.
3

Create a key

Click New API Key, enter a descriptive name (e.g. production, ci-pipeline), and click Create.
4

Copy and store the key

The raw key is shown only once. Copy it and store it in a secure location such as your hosting provider’s secret store or a .env file that is not committed to version control.
API keys require a Pro, Team, or Enterprise plan. If you see a 403 Upgrade required response, visit app.impulselabs.ai/billing.

​
Revoking a key

You can revoke a key at any time from the Settings → API Keys page in the dashboard, or via the Revoke API Key endpoint. Revoked keys are rejected immediately with a 401 response.

​
Key security best practices

  • Rotate keys regularly and revoke any you no longer use.
  • Create separate keys for each application or environment.
  • Never log the raw key — use the key_prefix (first 8 characters) for identifying which key was used in logs.
  • Set up monitoring on your usage metrics in the dashboard to detect unexpected spikes.