Authentication
To use the NomadicML API, you need to authenticate your requests using an API key. This guide covers obtaining and using API keys with both the SDK and direct HTTP requests.Obtaining an API Key
Generate API keys from the NomadicML web platform:- Log in to your account at app.nomadicml.com
- Navigate to your profile by clicking your avatar in the top-right corner
- Select API Keys from the menu
- Click Generate New Key
- Enter a descriptive name for your key
- Select the expiration period (default is 90 days)
- Click Create Key
The full API key is only shown once when generated. Copy and store it securely. Lost keys cannot be recovered and must be regenerated.
Using the Python SDK
Initialize the NomadicML client with your API key:Configuration Parameters
Parameter | Type | Default | Description |
---|---|---|---|
api_key | str | None | Your NomadicML API key (required) |
base_url | str | "https://api-prod.nomadicml.com/" | API endpoint URL |
timeout | int | 900 | Request timeout in seconds |
Verifying Authentication
Test your API key validity: SDK Method:Troubleshooting
Invalid API Key - If you receive anAuthenticationError
:
- Verify you’re using the correct API key
- Check if the key has expired or been revoked
- Verify internet connectivity
- Check for firewall restrictions on outgoing connections