UsageTap
Menu
Sign inStart free

Free model lifecycle API · v1

Model lifecycle and replacement explorer

Keep applications resilient when model keys disappear. Look up lifecycle status, provider equivalents, and comparable alternatives with a free public API—our contribution to better model management in every application. No account or API key required.

Run a lookup
  • Catch removals before deploy
  • Recover from model-not-found
  • Compare vendor options
Public endpointFree · no authentication
GET /v1/model-alternatives/{provider}/{model}
Response
application/json
Resolution
Lifecycle, equivalents, candidates, provenance
Automation
Explicit opt-in; no silent substitution
Access
Free for any application

Model resolver

Provider prefixes are recommended. Common unqualified OpenAI, Anthropic, and Gemini keys are inferred.

Use the endpoint shown below from application startup, CI, or a model-not-found handler.

This URL includes your model and comparison settings. Copy it to share the result.

deprecatedopenai/gpt-4-turbo

Provider-designated replacement

openai/gpt-5.6-sol

The provider names this model as the replacement.

Cross-provider candidates

JSON responseLoading live catalog…

GET https://api.usagetap.com/v1/model-alternatives/openai/gpt-4-turbo?purpose=upgrade&inputTokens=8000&outputTokens=2000&cachedInputPercent=30&maxPriceIncreasePercent=20&requiredParameters=&allowedProviders=&allowedModelKeys=&allowPreview=false&allowAutoApply=false

Open raw JSON ↗
{
  "schemaVersion": 1,
  "catalogVersion": "2026-09-16",
  "requested": {
    "modelKey": "openai/gpt-4-turbo",
    "provider": "openai",
    "model": "gpt-4-turbo"
  },
  "lifecycle": {
    "status": "DEPRECATED",
    "announcedAt": "2026-04-22",
    "shutdownAt": "2026-10-23",
    "source": {
      "label": "OpenAI API deprecations",
      "url": "https://developers.openai.com/api/docs/deprecations",
      "checkedAt": "2026-09-16"
    }
  },
  "action": "REPLACE",
  "recommendationSource": "provider",
  "recommendedModelKey": "openai/gpt-5.6-sol",
  "equivalents": [
    {
      "modelKey": "openai/gpt-5.6-sol",
      "provider": "openai",
      "relation": "official_replacement",
      "confidence": "authoritative",
      "rationale": "The provider names this model as the replacement.",
      "requiresEvaluation": true
    }
  ],
  "alternatives": [
    {
      "modelKey": "anthropic/claude-sonnet-4-6",
      "provider": "anthropic",
      "relation": "similar_price_and_strength",
      "confidence": "candidate",
      "rationale": "UsageTap places this model in a similar capability and price class; evaluate it on your workload before switching.",
      "requiresEvaluation": true
    },
    {
      "modelKey": "google/gemini-3.1-pro-preview",
      "provider": "google",
      "relation": "similar_price_and_strength",
      "confidence": "candidate",
      "rationale": "UsageTap places this model in a similar capability and price class; evaluate it on your workload before switching.",
      "requiresEvaluation": true
    }
  ],
  "automation": {
    "canResolveWithoutUsageTapAccount": true,
    "autoApplyRecommended": false,
    "note": "The recommended key is provider-designated. Opt in to automatic substitution only after validating request parameters and output behavior."
  }
}