{"schemaVersion":1,"catalogVersion":"2026-09-16","description":"Source-backed model lifecycle transitions, provider equivalents, and cross-provider candidates. No UsageTap account is required.","resolveUrlTemplate":"https://api.usagetap.com/v1/model-alternatives/{provider}/{model}","lifecycleUrl":"https://usagetap.com/model-lifecycle","documentationUrl":"https://usagetap.com/docs/MODEL_ALTERNATIVES_API","openApiUrl":"https://usagetap.com/openapi/model-alternatives.yaml","purposes":["upgrade","fallback","retirement"],"defaultPolicy":{"purpose":"upgrade","inputTokens":8000,"outputTokens":2000,"cachedInputPercent":30,"maxPriceIncreasePercent":20,"requiredParameters":[],"allowedProviders":[],"allowedModelKeys":[],"allowPreview":false,"allowAutoApply":false},"queryParameters":["response","purpose","inputTokens","outputTokens","cachedInputPercent","maxPriceIncreasePercent","requiredParameters","minimumContext","minimumOutput","endpoint","allowedProviders","allowedModelKeys","allowPreview","allowAutoApply"],"listEncoding":"Comma-separated strings for requiredParameters, allowedProviders and allowedModelKeys.","responseParameter":{"name":"response","default":"full","values":["full","light"],"light":"Returns identity, source-backed lifecycle evidence, decision, recommendation, validity, degraded state and automatic-application eligibility without candidate detail.","lightFields":["schemaVersion","catalogVersion","response","requested.modelKey","lifecycle.status","lifecycle.announcedAt","lifecycle.shutdownAt","lifecycle.source","action","keyGuidance","recommendedModelKey","providerReplacementModelKey","recommendationSource","decisionId","generatedAt","validUntil","degraded","automation.autoApplyRecommended"]},"automation":"Fallback requires explicit opt-in, an evaluated allowedModelKeys list, endpoint and minimum context/output limits. Unknown compatibility never enables automatic substitution.","transitions":[{"modelKey":"anthropic/claude-3-haiku-20240307","provider":"anthropic","model":"claude-3-haiku-20240307","status":"RETIRED","capabilityClass":"economy","announcedAt":"2026-02-19","shutdownAt":"2026-04-20","equivalentModelKeys":["anthropic/claude-haiku-4-5"],"alternativeModelKeys":["openai/gpt-5.6-luna","google/gemini-3.5-flash-lite"],"source":{"label":"Anthropic model deprecations","url":"https://platform.claude.com/docs/en/about-claude/model-deprecations","checkedAt":"2026-09-16"}},{"modelKey":"google/gemini-2.0-flash","provider":"google","model":"gemini-2.0-flash","status":"RETIRED","capabilityClass":"balanced","announcedAt":"2025-12-09","shutdownAt":"2026-06-01","equivalentModelKeys":["google/gemini-3.6-flash"],"alternativeModelKeys":["openai/gpt-5.6-terra","anthropic/claude-haiku-4-5"],"source":{"label":"Gemini API deprecations","url":"https://ai.google.dev/gemini-api/docs/deprecations","checkedAt":"2026-09-16"}},{"modelKey":"google/gemini-2.0-flash-lite","provider":"google","model":"gemini-2.0-flash-lite","status":"RETIRED","capabilityClass":"economy","announcedAt":"2025-12-09","shutdownAt":"2026-06-01","equivalentModelKeys":["google/gemini-3.1-flash-lite"],"alternativeModelKeys":["openai/gpt-5.6-luna","anthropic/claude-haiku-4-5"],"source":{"label":"Gemini API deprecations","url":"https://ai.google.dev/gemini-api/docs/deprecations","checkedAt":"2026-09-16"}},{"modelKey":"anthropic/claude-sonnet-4-20250514","provider":"anthropic","model":"claude-sonnet-4-20250514","status":"RETIRED","capabilityClass":"premium","announcedAt":"2026-04-14","shutdownAt":"2026-06-15","equivalentModelKeys":["anthropic/claude-sonnet-4-6"],"alternativeModelKeys":["openai/gpt-5.6-sol","google/gemini-3.1-pro-preview"],"source":{"label":"Anthropic model deprecations","url":"https://platform.claude.com/docs/en/about-claude/model-deprecations","checkedAt":"2026-09-16"}},{"modelKey":"anthropic/claude-opus-4-1-20250805","provider":"anthropic","model":"claude-opus-4-1-20250805","status":"RETIRED","capabilityClass":"premium","announcedAt":"2026-06-05","shutdownAt":"2026-08-05","equivalentModelKeys":["anthropic/claude-opus-4-8"],"alternativeModelKeys":["openai/gpt-5.6-sol","google/gemini-3.1-pro-preview"],"source":{"label":"Anthropic model deprecations","url":"https://platform.claude.com/docs/en/about-claude/model-deprecations","checkedAt":"2026-09-16"}},{"modelKey":"openai/gpt-3.5-turbo-1106","provider":"openai","model":"gpt-3.5-turbo-1106","status":"DEPRECATED","capabilityClass":"economy","announcedAt":"2025-09-26","shutdownAt":"2026-09-28","equivalentModelKeys":["openai/gpt-5.6-terra"],"alternativeModelKeys":["anthropic/claude-haiku-4-5","google/gemini-3.5-flash-lite"],"source":{"label":"OpenAI API deprecations","url":"https://developers.openai.com/api/docs/deprecations","checkedAt":"2026-09-16"}},{"modelKey":"openai/gpt-3.5-turbo-instruct","provider":"openai","model":"gpt-3.5-turbo-instruct","status":"DEPRECATED","capabilityClass":"economy","announcedAt":"2025-09-26","shutdownAt":"2026-09-28","equivalentModelKeys":["openai/gpt-5.6-terra"],"alternativeModelKeys":["anthropic/claude-haiku-4-5","google/gemini-3.5-flash-lite"],"source":{"label":"OpenAI API deprecations","url":"https://developers.openai.com/api/docs/deprecations","checkedAt":"2026-09-16"}},{"modelKey":"google/gemini-omni-flash-preview","provider":"google","model":"gemini-omni-flash-preview","status":"DEPRECATED","capabilityClass":"specialized","announcedAt":"2026-08-27","shutdownAt":"2026-09-30","equivalentModelKeys":["google/gemini-omni-1.1-flash"],"alternativeModelKeys":[],"source":{"label":"Gemini API deprecations","url":"https://ai.google.dev/gemini-api/docs/deprecations","checkedAt":"2026-09-16"}},{"modelKey":"google/gemini-2.5-flash-image","provider":"google","model":"gemini-2.5-flash-image","status":"DEPRECATED","capabilityClass":"specialized","announcedAt":"2026-05-28","shutdownAt":"2026-10-02","equivalentModelKeys":["google/gemini-3.1-flash-image"],"alternativeModelKeys":[],"source":{"label":"Gemini API deprecations","url":"https://ai.google.dev/gemini-api/docs/deprecations","checkedAt":"2026-09-16"}},{"modelKey":"openai/gpt-3.5-turbo-0125","provider":"openai","model":"gpt-3.5-turbo-0125","status":"DEPRECATED","capabilityClass":"economy","announcedAt":"2026-04-22","shutdownAt":"2026-10-23","equivalentModelKeys":["openai/gpt-5.6-terra"],"alternativeModelKeys":["anthropic/claude-haiku-4-5","google/gemini-3.5-flash-lite"],"source":{"label":"OpenAI API deprecations","url":"https://developers.openai.com/api/docs/deprecations","checkedAt":"2026-09-16"}},{"modelKey":"openai/gpt-4-turbo","provider":"openai","model":"gpt-4-turbo","status":"DEPRECATED","capabilityClass":"premium","announcedAt":"2026-04-22","shutdownAt":"2026-10-23","equivalentModelKeys":["openai/gpt-5.6-sol"],"alternativeModelKeys":["anthropic/claude-sonnet-4-6","google/gemini-3.1-pro-preview"],"source":{"label":"OpenAI API deprecations","url":"https://developers.openai.com/api/docs/deprecations","checkedAt":"2026-09-16"}},{"modelKey":"openai/gpt-4o-2024-05-13","provider":"openai","model":"gpt-4o-2024-05-13","status":"DEPRECATED","capabilityClass":"premium","announcedAt":"2026-04-22","shutdownAt":"2026-10-23","equivalentModelKeys":["openai/gpt-5.6-sol"],"alternativeModelKeys":["anthropic/claude-sonnet-4-6","google/gemini-3.1-pro-preview"],"source":{"label":"OpenAI API deprecations","url":"https://developers.openai.com/api/docs/deprecations","checkedAt":"2026-09-16"}},{"modelKey":"openai/o4-mini-2025-04-16","provider":"openai","model":"o4-mini-2025-04-16","status":"DEPRECATED","capabilityClass":"balanced","announcedAt":"2026-04-22","shutdownAt":"2026-10-23","equivalentModelKeys":["openai/gpt-5.6-terra"],"alternativeModelKeys":["anthropic/claude-haiku-4-5","google/gemini-3.6-flash"],"source":{"label":"OpenAI API deprecations","url":"https://developers.openai.com/api/docs/deprecations","checkedAt":"2026-09-16"}}]}