aiml docs
ReferenceAPI reference

Catalog

models, endpoints, prices

GET/v1/models
AuthorizationBearer <token>

In: header

Query Parameters

vendor?string
modality?unknown

Value in

  • "text"
  • "image"
  • "audio"
  • "video"
capability?array<>

repeatable; all must match

zdr?"1"

Value in

  • "1"
no_train?"1"

Value in

  • "1"
new?"1"

released this week

Value in

  • "1"
price_changed?"1"

a price change in the last 7 days

Value in

  • "1"
status?unknown

Value in

  • "active"
  • "deprecated"
q?string
sort?unknown
Default"name"

Value in

  • "name"
  • "price"
  • "latency"
  • "popularity"
  • "newest"

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/models"
{  "object": "list",  "data": [    {      "id": "openai/gpt-5-mini",      "vendor": "openai",      "name": "GPT-5 mini",      "modalities": {        "in": [          "text",          "image"        ],        "out": [          "text"        ]      },      "context_length": 400000,      "max_output": 128000,      "pricing_from": {        "input": 0.25,        "output": 2,        "cache_read": 0.025      },      "endpoints": 1,      "status": "active",      "markup_bps": 0,      "capabilities": {        "tools": true,        "json_schema": true,        "vision": true,        "audio": false,        "reasoning": true,        "cache": true,        "zdr": true,        "no_train": true      },      "uptime_30d": 0.9991,      "ttft_p50_ms": 180,      "requests_7d": 12000    }  ]}
GET/v1/models/{vendor}/{model}
AuthorizationBearer <token>

In: header

Path Parameters

vendor*string
Match^[a-z0-9-]+$
model*string
Match^[A-Za-z0-9._-]+$

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/models/string/string"
{  "id": "openai/gpt-5-mini",  "vendor": "openai",  "name": "GPT-5 mini",  "modalities": {    "in": [      "text",      "image"    ],    "out": [      "text"    ]  },  "context_length": 400000,  "max_output": 128000,  "pricing_from": {    "input": 0.25,    "output": 2,    "cache_read": 0.025  },  "endpoints": 1,  "status": "active",  "markup_bps": 0,  "capabilities": {    "tools": true,    "json_schema": true,    "vision": true,    "audio": false,    "reasoning": true,    "cache": true,    "zdr": true,    "no_train": true  },  "uptime_30d": 0.9991,  "ttft_p50_ms": 180,  "requests_7d": 12000}
GET/v1/models/{vendor}/{model}/stats
AuthorizationBearer <token>

In: header

Path Parameters

vendor*string
model*string

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/models/string/string/stats"
{  "model": "openai/gpt-5-mini",  "series": [    {      "endpoint_id": "ep_openai_gpt-5-mini_us",      "day": "2026-09-09",      "attempts": 1600,      "ok": 1598,      "ttft_p50_ms": 180,      "ttft_p95_ms": 420,      "tpot_p50_ms": 12    }  ],  "apps": [    {      "app_id": "chatbot",      "requests_7d": 4000,      "tokens_7d": 1200000    }  ],  "scheduled_prices": [],  "changelog": [    {      "id": 2,      "kind": "price_change",      "summary": "output price cut to $2/M",      "endpoint_id": "ep_openai_gpt-5-mini_us",      "effective_at": "2026-09-12T10:00:00Z",      "created_at": "2026-09-09T00:00:00Z"    }  ],  "analytics": true}
GET/v1/models/{vendor}/{model}/endpoints
AuthorizationBearer <token>

In: header

Path Parameters

vendor*string
Match^[a-z0-9-]+$
model*string
Match^[A-Za-z0-9._-]+$

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/models/string/string/endpoints"
{  "object": "list",  "model": "openai/gpt-5-mini",  "data": [    {      "id": "ep_openai_gpt-5-mini_us",      "provider": "openai",      "provider_name": "OpenAI",      "upstream_model": "gpt-5-mini",      "region": "us",      "status": "active",      "quantization": "",      "context_length": 400000,      "max_output": 128000,      "capabilities": {        "tools": {          "function": true,          "parallel": true        }      },      "price": {        "input": 0.25,        "output": 2,        "cache_read": 0.025      },      "markup_bps": 0,      "data_policy": {        "trains": false,        "retention_days": 30,        "zdr": true      },      "uptime_30d": 0.9991,      "latency": {        "ttft_p50_ms": 180,        "ttft_p95_ms": 420      },      "attempts_30d": 48000    }  ]}
GET/v1/pricing

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/pricing"
{  "currencies": [    "INR",    "USD"  ],  "rails": [    {      "rail": "razorpay",      "items": [        {          "method": "upi",          "bps": 0        },        {          "method": "netbanking",          "bps": 190        },        {          "method": "card_domestic",          "bps": 200        },        {          "method": "card_international",          "bps": 350        }      ]    },    {      "rail": "stripe",      "items": [        {          "method": "card",          "bps": 290,          "fixed_minor": 30,          "note": "+ 1.5% for international cards"        },        {          "method": "link",          "bps": 290,          "fixed_minor": 30        },        {          "method": "ach_debit",          "bps": 80,          "note": "capped at $5"        }      ]    }  ],  "gst": {    "rate_bps": 1800,    "supplier_state": "23",    "rule": "18% GST on supplies to Indian recipients: CGST 9% + SGST 9% intra-state, IGST 18% otherwise; exports zero-rated under LUT"  },  "fx": {    "day": "2026-09-10",    "usd_inr": "83.91750000",    "spread_bps": 50  },  "plans": [    {      "id": "payg",      "name": "Pay as you go",      "monthly_minor": 0,      "currency": "",      "included_micro": 0,      "limits": {        "rpm": 600,        "tpm": 2000000,        "concurrency": 32,        "keys": 50,        "projects": 10      },      "features": {},      "description": "Prepaid credits, no monthly fee.",      "public": true,      "sort": 10    },    {      "id": "team-small",      "name": "Team S",      "monthly_minor": 4900,      "currency": "USD",      "included_micro": 50000000,      "limits": {        "rpm": 3000,        "tpm": 10000000,        "concurrency": 128,        "keys": 200,        "projects": 50      },      "features": {        "priority_support": false,        "sso": false      },      "description": "USD 49 per month, USD 50 of credits included, higher limits.",      "public": true,      "sort": 20    }  ],  "minimums_minor": {    "INR": 50000,    "USD": 500  },  "markup": {    "frontier_bps": 0,    "open_weight_min_bps": 500,    "open_weight_max_bps": 1500,    "note": "frontier models pass through at list price; open-weight endpoints carry the markup shown per model"  },  "supplier": {    "legal_name": "ai.ml",    "state": "Madhya Pradesh",    "gstin": true  },  "generated_at": "2026-09-10T12:00:00Z"}
GET/v1/rankings

Query Parameters

days?integer
Range1 <= value <= 90
category?string

restrict the app list to a single registry category

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/rankings"
{  "days": 7,  "apps": [    {      "id": "chatbot",      "requests": 40000,      "tokens": 12000000,      "models": 3    }  ],  "models": [    {      "id": "openai/gpt-5-mini",      "requests": 30000,      "tokens": 9000000,      "apps": 2    }  ],  "analytics": true,  "generated_at": "2026-09-10T12:00:00Z"}
GET/v1/providers

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/providers"
{  "object": "list",  "data": [    {      "id": "openai",      "name": "OpenAI",      "trains": false,      "retention_days": 30,      "zdr": true,      "regions": [        "us"      ],      "status": "active",      "terms_url": "https://openai.com/policies/api-data-usage-policies",      "endpoints": 3,      "verified_at": "2026-09-09T00:00:00Z"    }  ],  "snapshot": "2026-09-10T06:00:00Z-a1b2c3"}
GET/v1/apps/{slug}/public

Path Parameters

slug*string

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/apps/string/public"
{  "slug": "my-chatbot",  "name": "My Chatbot",  "category": "chat",  "tokens_30d": 12000000,  "requests_30d": 40000,  "models": [],  "trend": [],  "analytics": true,  "generated_at": "2026-09-10T12:00:00Z"}
GET/v1/apps/{slug}/badge

Path Parameters

slug*string

Response Body

image/svg+xml

application/json

curl -X GET "https://example.com/v1/apps/string/badge"
"string"