Getting Started
The Synthos API lets you integrate AI training data validation directly into your ML pipeline. All API requests are made to https://api.synthos.dev and must include the appropriate headers.
Authentication Flow
- Create an account by calling
POST /api/v1/auth/registerwith your email and password. - Verify your email using the OTP code sent to your inbox via
POST /api/v1/auth/verify-email. - Get your token by calling
POST /api/v1/auth/login. This returns a JWT valid for 24 hours. - Include the token in all authenticated requests using the
Authorization: Bearer YOUR_TOKENheader.
Base URL
https://api.synthos.dev/api/v1/
Request Headers
Content-Type: application/json Authorization: Bearer YOUR_TOKEN
API Key Authentication
For server-to-server integrations, you can also authenticate using an API key. Generate one from your dashboard settings. Pass it as X-API-Key: sk_live_... header.
Authentication
Register, login, and manage user accounts. All authenticated endpoints require a Bearer token.
Datasets
Upload, manage, and inspect training datasets. Uploads use signed URLs for secure, direct-to-storage transfers.
Validations
Create and monitor validation jobs. Validations analyze datasets for model collapse risk, quality issues, and training outcome prediction.
Warranties
Request and manage performance warranties on validated datasets. Warranties provide financial backing for prediction accuracy.
Credits
Manage your credit balance, purchase credits, and view transaction history. Credits are consumed when running validations.
Support
Create and manage support tickets. Our team typically responds within 4 business hours.
Rate Limits
Rate limits are applied per API key / token. Exceeding the limit returns a 429 status with a Retry-After header.
| Tier | Requests | Burst | Notes |
|---|---|---|---|
| Free | 60 / min | 10 / sec | Default for new accounts |
| Pro | 300 / min | 30 / sec | Purchased credit package |
| Enterprise | 1,000 / min | 100 / sec | Custom agreement |
Credit Costs
Each operation consumes credits from your balance. Purchase credits from the dashboard or via the API.
| Operation | Credits | Description |
|---|---|---|
| Quick Scan | 10 | Basic quality check and row count verification |
| Standard Validation | 25 | Collapse detection + quality scoring |
| Comprehensive Validation | 50 | Full cascade validation with training prediction |
| Warranty Request | 100 | Performance warranty issuance |
Error Codes
All errors return a JSON body with a message field describing the issue.
Error Response Format
{
"error": {
"code": 422,
"message": "Validation failed: dataset_id is required.",
"request_id": "req_abc123"
}
}| Code | Name | Description |
|---|---|---|
| 400 | Bad Request | The request body is invalid or missing required fields. |
| 401 | Unauthorized | Missing or invalid authentication token. |
| 403 | Forbidden | You do not have permission to access this resource. |
| 404 | Not Found | The requested resource does not exist. |
| 409 | Conflict | A resource with the same identifier already exists. |
| 422 | Unprocessable Entity | The request was well-formed but contains semantic errors. |
| 429 | Too Many Requests | Rate limit exceeded. Retry after the Retry-After header value. |
| 500 | Internal Server Error | An unexpected error occurred on our end. |
Need help? Contact support ยท Create an account