Building with an AI agent? See the Agents guide for how to do this programmatically from code.
1
Get Your Secret Key
Use your existing secret key (
aks_live_...). Secret keys are enabled on request: email support@lava.so to get API access for your account.2
Make Your First Request
Use your secret key in the
Authorization header. The request body stays unchanged from the provider’s API.- cURL
- SDK
- TypeScript
3
See Your Request
List your recent requests. Lava records the token counts, cost, model, and provider of each one automatically.Each gateway response also carries an
- cURL
- SDK
x-lava-request-id header, so you can match a response to its record.See the Forward Proxy guide for multi-provider examples, streaming, error handling, and advanced configuration.What’s Next?
Supported Providers
Browse every provider you can reach through the gateway
How Lava Works
Understand Lava’s architecture, gateway routing, and key concepts
Troubleshooting
Where is my secret key?
Where is my secret key?
Secret keys are enabled on request. Email support@lava.so to get API access for your account.
402 Insufficient Balance
402 Insufficient Balance
Your Lava wallet needs funds. Go to Wallet > Billing to add a payment method.
What about forward tokens?
What about forward tokens?
Using your secret key directly is the simplest way to get started, and costs are charged to your Lava wallet. To use your own provider API key instead of Lava’s managed keys, send a forward token: a base64-encoded JSON that bundles your secret key with a
provider_key. See the Forward Proxy guide and SDK reference for details.