Plan and billing
To use the API, your workspace must be on a Pro or Team plan. API usage draws only on your workspace’s prepaid balance. It does not use your daily credit allowance. To add funds, open Settings → Billing in Biomni Lab. If the prepaid balance is empty, the API refuses requests that start work and returns a400 error with the code
payment_required.
Create an API key
A key acts within the workspace it was created in, with your own permissions in that workspace.- In Biomni Lab, open Settings → API Keys.
- Click Create key, give it a name (e.g.
Batch analysis pipeline), and optionally an expiration.
Base URL
For the self-serve platform, use:Authenticate a request
Send the key as a bearer token in theAuthorization header:
Revoke a key
From Settings → API Keys, Revoke disables a key immediately and permanently. Keys can carry an expiration. An expired key stops working automatically.Next steps
Quickstart
Key → project → task → results, end to end.
Errors
Status codes, error handling, and retries.