synlake-ai Infrastructure API
Query and estimate cloud infrastructure
Query and estimate cloud infrastructure
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/synlake-ai:synlake-ai-infrastructure-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Synlake Ai Infrastructure API
version: 0.1.0
contact:
name: Synlake
url: https://synlake.ai
email: contactcharly00@gmail.com
license:
name: Proprietary
description: 'Operations tagged Infrastructure across 2 of this provider''s published API definitions: api-synlake-openapi.json, synlake-ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.synlake.ai/api/v1
description: Production
security:
- BearerAuth: []
tags:
- name: Infrastructure
description: Query and estimate cloud infrastructure
paths:
/infrastructure/query:
post:
operationId: queryInfrastructure
summary: Query infrastructure with execution kit
description: 'The primary endpoint. Describe what you need — Synlake responds with the optimal instance, cross-provider alternatives, Terraform HCL, CLI commands, and cost estimates. Cost: $0.05 (without kit) or $0.10 (with kit).'
tags:
- Infrastructure
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/QueryRequest'
example:
intent: compute
requirements:
vcpus: 4
memory_gb: 16
storage_gb: 100
gpu: false
region: us-east-1
constraints:
max_monthly_budget_usd: 200
providers:
- aws
- gcp
- azure
output:
include_terraform: true
include_cli: true
include_alternatives: true
pricing_model: on_demand
responses:
'200':
description: Infrastructure recommendation with execution kit
content:
application/json:
schema:
$ref: '#/components/schemas/QueryResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'422':
description: No matching instances found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
$ref: '#/components/responses/RateLimited'
servers:
- url: https://api.synlake.ai/api/v1
description: Production
/infrastructure/estimate:
post:
operationId: estimateCost
summary: Estimate costs without execution kit
description: 'Fast cost-only endpoint. Returns the cheapest instance per provider for your requirements. No Terraform or CLI — just pricing. Cost: $0.01/call.'
tags:
- Infrastructure
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EstimateRequest'
example:
intent: compute
requirements:
vcpus: 8
memory_gb: 32
providers:
- aws
- gcp
- azure
pricing_model: on_demand
responses:
'200':
description: Cost estimates by provider
content:
application/json:
schema:
$ref: '#/components/schemas/EstimateResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'429':
$ref: '#/components/responses/RateLimited'
servers:
- url: https://api.synlake.ai/api/v1
description: Production
components:
schemas:
PricingModel:
type: string
enum:
- on_demand
- spot
- reserved_1y
EstimateRequest:
type: object
additionalProperties: false
required:
- intent
- requirements
properties:
intent:
type: string
enum:
- compute
description: 'v0.1: only ''compute'''
requirements:
type: object
additionalProperties: false
properties:
vcpus:
type: integer
memory_gb:
type: number
gpu:
type: boolean
region:
type: string
architecture:
type: string
enum:
- x86_64
- arm64
providers:
type: array
items:
$ref: '#/components/schemas/Provider'
pricing_model:
$ref: '#/components/schemas/PricingModel'
constraints:
type: object
additionalProperties: false
description: Optional. /estimate annotates budget_met + within_budget; /query enforces with BUDGET_EXCEEDED. (SYN-53)
properties:
max_monthly_budget_usd:
type: number
minimum: 0
QueryRequest:
type: object
required:
- intent
- requirements
properties:
intent:
type: string
enum:
- compute
description: Only 'compute' in v0.1
requirements:
type: object
properties:
vcpus:
type: integer
description: Minimum vCPUs
memory_gb:
type: number
description: Minimum memory in GB
storage_gb:
type: integer
default: 30
gpu:
type: boolean
default: false
region:
type: string
description: e.g. us-east-1, us-central1
os:
type: string
enum:
- linux
architecture:
type: string
enum:
- x86_64
- arm64
constraints:
type: object
additionalProperties: false
description: Constraint object. Unknown keys → INVALID_REQUIREMENTS; variants of the budget key (max_monthly_budget, monthly_budget_usd, budget, budget_usd) → suggestions pointing at the canonical name. (SYN-53)
properties:
max_monthly_budget_usd:
type: number
minimum: 0
description: Maximum monthly spend in USD. /estimate annotates within_budget per estimate + budget_met top-level (returns 200). /query enforces with 400 BUDGET_EXCEEDED.
providers:
type: array
items:
$ref: '#/components/schemas/Provider'
compliance:
type: array
items:
type: string
availability:
type: string
enum:
- standard
- high
- critical
output:
type: object
properties:
include_terraform:
type: boolean
default: true
include_cli:
type: boolean
default: true
include_alternatives:
type: boolean
default: true
max_alternatives:
type: integer
default: 3
pricing_model:
$ref: '#/components/schemas/PricingModel'
Guardrails:
type: object
properties:
budget_check:
type: string
enum:
- PASS
- FAIL
- NOT_APPLICABLE
monthly_estimate_vs_budget:
type: string
compliance_check:
type: string
enum:
- PASS
- FAIL
region_available:
type: boolean
QueryResponse:
type: object
properties:
request_id:
type: string
timestamp:
type: string
format: date-time
recommendation:
$ref: '#/components/schemas/RecommendationItem'
alternatives:
type: array
items:
$ref: '#/components/schemas/RecommendationItem'
guardrails:
$ref: '#/components/schemas/Guardrails'
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
suggestions:
type: array
items:
type: string
Provider:
type: string
enum:
- aws
- gcp
- azure
RecommendationItem:
type: object
properties:
provider:
$ref: '#/components/schemas/Provider'
service:
type: string
instance_type:
type: string
region:
type: string
specs:
type: object
properties:
vcpus:
type: integer
memory_gb:
type: number
storage_gb:
type: integer
network_bandwidth:
type: string
pricing:
type: object
properties:
hourly:
type: number
monthly_estimate:
type: number
currency:
type: string
pricing_model:
$ref: '#/components/schemas/PricingModel'
last_updated:
type: string
execution_kit:
type: object
properties:
terraform:
type: string
description: Terraform HCL ready to apply
cli:
type: string
description: CLI command ready to execute
estimated_deploy_time:
type: string
confidence:
type: number
minimum: 0
maximum: 1
EstimateResponse:
type: object
properties:
request_id:
type: string
estimates:
type: array
items:
type: object
properties:
provider:
$ref: '#/components/schemas/Provider'
instance_type:
type: string
monthly_estimate:
type: number
within_budget:
type: boolean
description: Present only when constraints.max_monthly_budget_usd was sent. (SYN-53)
cheapest:
$ref: '#/components/schemas/Provider'
savings_vs_most_expensive:
type: string
budget_met:
type: boolean
description: Present only when constraints.max_monthly_budget_usd was sent. True iff at least one estimate fits. (SYN-53)
budget_requested:
type: number
description: Echo of the requested budget. Omitted when no budget was sent. (SYN-53)
execution_kit_available:
type: boolean
get_api_key:
type: string
format: uri
responses:
PaymentRequired:
description: Free tier exhausted or spending cap reached
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: CREDITS_EXHAUSTED
message: Free tier exhausted. Activate billing at /api/v1/billing/activate to continue.
BadRequest:
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
RateLimited:
description: Too many requests
headers:
Retry-After:
schema:
type: integer
description: Seconds to wait before retrying
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: UNAUTHORIZED
message: Missing Authorization Bearer token
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: 'API key in format: sk_synlake_...'
x-refined-from:
- api-synlake-openapi.json
- synlake-ai-openapi.json