OpenAI Embeddings (ada-002 & text-embedding-3) EOL, Deprecatio…

Track confirmed UTC deprecation and shutdown dates for OpenAI Embeddings (ada-002 & text-embedding-3) (OpenAI) across OpenAI, Azure OpenAI. Preview text-embedding-ada-002 → text-embedding-3-small upgrades locally below, audit full configs in the Model Config Auditor, or benchmark token pricing in DevToken.

Tracked Variants 19

Earliest Upcoming EOL 2028-02-09

Recommended Upgrade text-embedding-3-small

Ecosystems Covered OpenAI, Azure OpenAI

1. Quick .env & SDK Snippet Replacement Matcher

Edit or paste your .env assignment, LiteLLM route, or SDK model identifier below to check live 3-state EOL status and copy a ready-to-apply replacement diff locally in your browser.

Full .env Auditor → Compare text-embedding-3-small Cost in DevToken →

Replacement Diff Preview (text-embedding-ada-002 → text-embedding-3-small)

# AZURE_OPENAI_DEPLOYMENT: text-embedding-ada-002 -> text-embedding-3-small [DEPRECATED · EOL 2028-02-09]
- AZURE_OPENAI_DEPLOYMENT="text-embedding-ada-002"
+ AZURE_OPENAI_DEPLOYMENT="text-embedding-3-small"

# OPENAI_MODEL: code-search-ada-code-001 -> text-embedding-3-small [RETIRED · EOL 2024-01-04]
- OPENAI_MODEL="code-search-ada-code-001"
+ OPENAI_MODEL="text-embedding-3-small"

2. Cross-Ecosystem OpenAI Embeddings (ada-002 & text-embedding-3) Lifecycle Matrix (19)

Direct vendor APIs and cloud platforms retire dated snapshots on independent schedules. Verify the exact model ID, vendor lifecycle stage, and UTC shutdown date matching your deployment.

OpenAI Embeddings (ada-002 & text-embedding-3) lifecycle status, UTC shutdown dates, and replacement models across OpenAI, Azure OpenAI
Model ID	Provider	Calculated Status	Confirmed Shutdown (UTC)	Vendor Lifecycle	Replacement & Migration	Source
`text-embedding-3-large`	Azure OpenAI	DEPRECATED (454d)	2028-02-09in 454d	GA	—Audit →	Docs ↗
`text-embedding-3-small`	Azure OpenAI	DEPRECATED (454d)	2028-02-09in 454d	GA	—Audit →	Docs ↗
`text-embedding-ada-002`	Azure OpenAI	DEPRECATED (454d)	2028-02-09in 454d	GA	—Audit →	Docs ↗
`code-search-ada-code-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`code-search-ada-text-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`code-search-babbage-code-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`code-search-babbage-text-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-search-ada-doc-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-search-ada-query-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-search-babbage-doc-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-search-babbage-query-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-search-curie-doc-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-search-curie-query-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-search-davinci-doc-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-search-davinci-query-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-similarity-ada-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-similarity-babbage-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-similarity-curie-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗
`text-similarity-davinci-001`	OpenAI	RETIRED	2024-01-041043d ago	Retired	`text-embedding-3-small` Cost → Audit →	Docs ↗

3. Production Migration Checklist (text-embedding-ada-002 → text-embedding-3-small)

Follow this deterministic engineering sequence before retiring pinned snapshots in production services and SDK clients:

Inventory pinned model IDs: Search repositories and deployment manifests for AZURE_OPENAI_DEPLOYMENT, azure/ LiteLLM routes, and dated snapshot strings in the OpenAI Embeddings (ada-002 & text-embedding-3) family (3 deprecated, 16 retired, 0 active variants tracked).
Benchmark successor quality & token pricing: Validate structured output schemas, tool-calling payloads, and latency against text-embedding-3-small, then compare input, output, and cached token rates in DevToken.
Enforce keyless CI guardrails: Wire RSS, Atom, iCal feeds & CI Guard into pull-request checks so retired or deprecated OpenAI Embeddings (ada-002 & text-embedding-3) identifiers cannot re-enter production.

Compare sibling model families or inspect full provider-level schedules across every ecosystem hosting this family:

GPT-4o mini

DEPRECATED (63d)

OpenAI · 3 tracked IDs · 2 ecosystems OpenAI, Azure OpenAI Upgrade: gpt-6-luna Earliest EOL: 2027-01-14

Migration Guide → Cost →

GPT-4o

DEPRECATED (63d)

OpenAI · 9 tracked IDs · 2 ecosystems OpenAI, Azure OpenAI Upgrade: gpt-6-luna Earliest EOL: 2027-01-14

Migration Guide → Cost →

GPT-4.1 & GPT-4.1 mini / nano

DEPRECATED (63d)

OpenAI · 8 tracked IDs · 2 ecosystems OpenAI, Azure OpenAI Upgrade: gpt-6-luna Earliest EOL: 2027-01-14

Migration Guide → Cost →

GPT-4 Turbo

RETIRED

OpenAI · 8 tracked IDs · 1 ecosystems OpenAI Upgrade: gpt-5.6-sol

Migration Guide → Cost →

GPT-4 (0613 / 32k / Vision)

RETIRED

OpenAI · 10 tracked IDs · 1 ecosystems OpenAI Upgrade: gpt-5.6-sol

Migration Guide → Cost →

GPT-3.5 Turbo

RETIRED

OpenAI · 8 tracked IDs · 1 ecosystems OpenAI Upgrade: gpt-5.6-terra

Migration Guide → Cost →

5. OpenAI Embeddings (ada-002 & text-embedding-3) Deprecation & Upgrade FAQ

Is OpenAI Embeddings (ada-002 & text-embedding-3) deprecated or retired across OpenAI, Azure OpenAI?

LLMEOL tracks 19 OpenAI Embeddings (ada-002 & text-embedding-3) variants across OpenAI, Azure OpenAI: 3 deprecated with scheduled shutdowns, 16 retired past their UTC EOL date, and 0 active with no announced shutdown date. Check the cross-ecosystem matrix above for exact snapshot dates.

What is the recommended replacement model when migrating off text-embedding-ada-002?

The primary recommended upgrade target for text-embedding-ada-002 is text-embedding-3-small. Always test prompt formatting, max output tokens, and tool schemas on text-embedding-3-small, and compare token pricing in DevToken before switching production traffic.

How can I replace text-embedding-ada-002 in .env and LiteLLM configs safely?

Paste your AZURE_OPENAI_DEPLOYMENT assignment or LiteLLM model block into the Quick Replacement Matcher on this page to generate an exact diff, or open the full Local Model Config Auditor to scan multi-service manifests with zero network upload.

OpenAI Embeddings (ada-002 & text-embedding-3) Deprecation, Shutdown Dates & Migration Guide

1. Quick .env & SDK Snippet Replacement Matcher

Replacement Diff Preview (text-embedding-ada-002 → text-embedding-3-small)

2. Cross-Ecosystem OpenAI Embeddings (ada-002 & text-embedding-3) Lifecycle Matrix (19)

3. Production Migration Checklist (text-embedding-ada-002 → text-embedding-3-small)

4. Related OpenAI & Ecosystem Migration Guides

GPT-4o mini

GPT-4o

GPT-4.1 & GPT-4.1 mini / nano

GPT-4 Turbo

GPT-4 (0613 / 32k / Vision)

GPT-3.5 Turbo

5. OpenAI Embeddings (ada-002 & text-embedding-3) Deprecation & Upgrade FAQ