From 75072514aa3e3c0f9ed417c497d38fe26e466f2e Mon Sep 17 00:00:00 2001 From: mahjongmen Date: Mon, 9 Dec 2024 09:04:43 -0500 Subject: [PATCH 1/2] added notes on deprecation policy --- .../going-to-production/deprecations.mdx | 40 ++++++++++++++++++- 1 file changed, 38 insertions(+), 2 deletions(-) diff --git a/fern/pages/going-to-production/deprecations.mdx b/fern/pages/going-to-production/deprecations.mdx index c3583486..006fbdf1 100644 --- a/fern/pages/going-to-production/deprecations.mdx +++ b/fern/pages/going-to-production/deprecations.mdx @@ -9,7 +9,7 @@ keywords: 'Cohere API, large language models, generative AI' createdAt: 'Wed Nov 27 2024 00:00:00 GMT+0000 (Coordinated Universal Time)' updatedAt: 'Wed Nov 27 2024 00:00:00 GMT+0000 (Coordinated Universal Time)' --- -Find information around deprecated endpoints and models with their recommended replacements. +Find information around deprecated endpoints and models with their recommended replacements. All deprecation announcements applies to models being accessed through our API. It does not apply to models served/hosted/deployed outside our API, where ad-hoc deprecation policies apply. ## Overview As Cohere launches safer and more capable models, we will regularly retire old models. Applications relying on Cohere's models may need occasional updates to keep working. Impacted customers will always be notified via email and in our documentation along with blog posts. @@ -21,10 +21,46 @@ Cohere uses the following terms to describe the lifecycle of our models: - **Deprecated:** The model and endpoints are no longer available to new customers but remain available to existing users until retirement. (An existing user is defined as anyone who has used the model or endpoint within 90 days of the deprecation announcement.) A shutdown date will be assigned at that time. - **Shutdown:** The model and endpoint are no longer available for users. Requests to shutdown models and endpoints will fail. -## Migrating to replacements +## Migrating to Replacements Once a model is deprecated, it is imperative to migrate all usage to a suitable replacement before the shutdown date. Requests to models and endpoints past the shutdown date will fail. To ensure a smooth transition, we recommend thorough testing of your applications with the new models well before the shutdown date. If your team requires assistance, do not hesitate to reach out to support@cohere.ai. +## Notifications +Cohere notifies customer with active usage of models for upcoming shutdown dates. We notify customers of upcoming shutdown dates as follows: + +1. At model launch, we designate a “Guaranteed Available Until” date (at least one year out) +2. We provide at least 6 months(1) notice before model retirement for publicly release models + +## Model Status +All publicly released models are listed below with their status: + +| Model Name | Type of Model | Guaranteed Available Until | Current Status | Deprecated | Shutdown | +| ------------------------------------------- | ------------- | -------------------------- | -------------- |----------- | -------- | +| `command-r-plus-08-2024` | Generative | 06/30/2025 | Active | N/A | N/A | +| `command-r-plus-04-2024` | Generative | 06/30/2025 | Legacy | N/A | N/A | +| `command-r-plus` | Generative | 06/30/2025 | Legacy | N/A | N/A | +| `command-r-08-2024` | Generative | 06/30/2025 | Active | N/A | N/A | +| `command-r-03-2024` | Generative | 06/30/2025 | Legacy | N/A | N/A | +| `command-r` | Generative | 06/30/2025 | Legacy | N/A | N/A | +| `command` | Generative | 12/31/2024 | Legacy | N/A | N/A | +| `command-nightly` | Generative | 12/31/2024 | Legacy | N/A | N/A | +| `command-light` | Generative | 12/31/2024 | Legacy | N/A | N/A | +| `command-light-nightly` | Generative | 12/31/2024 | Legacy | N/A | N/A | +| `c4ai-aya-expanse-8b` | Generative | 06/30/2025 | Active | N/A | N/A | +| `c4ai-aya-expanse-32b` | Generative | 06/30/2025 | Active | N/A | N/A | +| `embed-english-v3.0` | Embeddings | 06/30/2025 | Active | N/A | N/A | +| `embed-english-light-v3.0` | Embeddings | 06/30/2025 | Active | N/A | N/A | +| `embed-multilingual-v3.0` | Embeddings | 06/30/2025 | Active | N/A | N/A | +| `embed-multilingual-light-v3.0` | Embeddings | N/A | Legacy | N/A | N/A | +| `embed-english-v2.0` | Embeddings | N/A | Legacy | N/A | N/A | +| `embed-english-light-v2.0` | Embeddings | N/A | Legacy | N/A | N/A | +| `embed-multilingual-v2.0` | Embeddings | N/A | Legacy | N/A | N/A | +| `rerank-v3.5` | Rerankers | 12/31/2025 | Active | N/A | N/A | +| `rerank-english-v3.0 | Rerankers | 06/30/2025 | Active | N/A | N/A | +| `rerank-multilingual-v3.0` | Rerankers | 06/30/2025 | Active | N/A | N/A | +| `rerank-english-v2.0` | Rerankers | N/A | Deprecated | 12/03/24 | 03/31/25 | +| `rerank-multilingual-v2.0` | Rerankers | N/A | Deprecated | 12/03/24 | 03/31/25 | + ## Deprecation History All deprecations are listed below with the most recent announcements at the top. From 22c1c25221f113dafc8de09a823c2365eb260e45 Mon Sep 17 00:00:00 2001 From: mahjongmen Date: Tue, 17 Dec 2024 09:58:20 -0500 Subject: [PATCH 2/2] reflect comments --- .../going-to-production/deprecations.mdx | 59 +++++++++---------- 1 file changed, 29 insertions(+), 30 deletions(-) diff --git a/fern/pages/going-to-production/deprecations.mdx b/fern/pages/going-to-production/deprecations.mdx index 006fbdf1..0aaffc14 100644 --- a/fern/pages/going-to-production/deprecations.mdx +++ b/fern/pages/going-to-production/deprecations.mdx @@ -9,7 +9,7 @@ keywords: 'Cohere API, large language models, generative AI' createdAt: 'Wed Nov 27 2024 00:00:00 GMT+0000 (Coordinated Universal Time)' updatedAt: 'Wed Nov 27 2024 00:00:00 GMT+0000 (Coordinated Universal Time)' --- -Find information around deprecated endpoints and models with their recommended replacements. All deprecation announcements applies to models being accessed through our API. It does not apply to models served/hosted/deployed outside our API, where ad-hoc deprecation policies apply. +Find information around deprecated endpoints and models with their recommended replacements. All deprecation announcements applies to models being accessed through our API. Please refer to partner documentation for deprecation policy on specific partner platforms. ## Overview As Cohere launches safer and more capable models, we will regularly retire old models. Applications relying on Cohere's models may need occasional updates to keep working. Impacted customers will always be notified via email and in our documentation along with blog posts. @@ -26,40 +26,39 @@ Once a model is deprecated, it is imperative to migrate all usage to a suitable To ensure a smooth transition, we recommend thorough testing of your applications with the new models well before the shutdown date. If your team requires assistance, do not hesitate to reach out to support@cohere.ai. ## Notifications -Cohere notifies customer with active usage of models for upcoming shutdown dates. We notify customers of upcoming shutdown dates as follows: +Cohere notifies customer with active usage on deprecated models for upcoming shutdown dates. We notify customers of upcoming shutdown dates as follows: -1. At model launch, we designate a “Guaranteed Available Until” date (at least one year out) -2. We provide at least 6 months(1) notice before model retirement for publicly release models +1. We provide at least 6 months(1) notice before model retirement for publicly release models ## Model Status All publicly released models are listed below with their status: -| Model Name | Type of Model | Guaranteed Available Until | Current Status | Deprecated | Shutdown | -| ------------------------------------------- | ------------- | -------------------------- | -------------- |----------- | -------- | -| `command-r-plus-08-2024` | Generative | 06/30/2025 | Active | N/A | N/A | -| `command-r-plus-04-2024` | Generative | 06/30/2025 | Legacy | N/A | N/A | -| `command-r-plus` | Generative | 06/30/2025 | Legacy | N/A | N/A | -| `command-r-08-2024` | Generative | 06/30/2025 | Active | N/A | N/A | -| `command-r-03-2024` | Generative | 06/30/2025 | Legacy | N/A | N/A | -| `command-r` | Generative | 06/30/2025 | Legacy | N/A | N/A | -| `command` | Generative | 12/31/2024 | Legacy | N/A | N/A | -| `command-nightly` | Generative | 12/31/2024 | Legacy | N/A | N/A | -| `command-light` | Generative | 12/31/2024 | Legacy | N/A | N/A | -| `command-light-nightly` | Generative | 12/31/2024 | Legacy | N/A | N/A | -| `c4ai-aya-expanse-8b` | Generative | 06/30/2025 | Active | N/A | N/A | -| `c4ai-aya-expanse-32b` | Generative | 06/30/2025 | Active | N/A | N/A | -| `embed-english-v3.0` | Embeddings | 06/30/2025 | Active | N/A | N/A | -| `embed-english-light-v3.0` | Embeddings | 06/30/2025 | Active | N/A | N/A | -| `embed-multilingual-v3.0` | Embeddings | 06/30/2025 | Active | N/A | N/A | -| `embed-multilingual-light-v3.0` | Embeddings | N/A | Legacy | N/A | N/A | -| `embed-english-v2.0` | Embeddings | N/A | Legacy | N/A | N/A | -| `embed-english-light-v2.0` | Embeddings | N/A | Legacy | N/A | N/A | -| `embed-multilingual-v2.0` | Embeddings | N/A | Legacy | N/A | N/A | -| `rerank-v3.5` | Rerankers | 12/31/2025 | Active | N/A | N/A | -| `rerank-english-v3.0 | Rerankers | 06/30/2025 | Active | N/A | N/A | -| `rerank-multilingual-v3.0` | Rerankers | 06/30/2025 | Active | N/A | N/A | -| `rerank-english-v2.0` | Rerankers | N/A | Deprecated | 12/03/24 | 03/31/25 | -| `rerank-multilingual-v2.0` | Rerankers | N/A | Deprecated | 12/03/24 | 03/31/25 | +| Model Name | Type of Model | Current Status | Deprecated | Shutdown | +| ------------------------------------------- | ------------- | -------------- |----------- | -------- | +| `command-r-plus-08-2024` | Generative | Active | N/A | N/A | +| `command-r-plus-04-2024` | Generative | Legacy | N/A | N/A | +| `command-r-plus` | Generative | Legacy | N/A | N/A | +| `command-r-08-2024` | Generative | Active | N/A | N/A | +| `command-r-03-2024` | Generative | Legacy | N/A | N/A | +| `command-r` | Generative | Legacy | N/A | N/A | +| `command` | Generative | Legacy | N/A | N/A | +| `command-nightly` | Generative | Legacy | N/A | N/A | +| `command-light` | Generative | Legacy | N/A | N/A | +| `command-light-nightly` | Generative | Legacy | N/A | N/A | +| `c4ai-aya-expanse-8b` | Generative | Active | N/A | N/A | +| `c4ai-aya-expanse-32b` | Generative | Active | N/A | N/A | +| `embed-english-v3.0` | Embeddings | Active | N/A | N/A | +| `embed-english-light-v3.0` | Embeddings | Active | N/A | N/A | +| `embed-multilingual-v3.0` | Embeddings | Active | N/A | N/A | +| `embed-multilingual-light-v3.0` | Embeddings | Legacy | N/A | N/A | +| `embed-english-v2.0` | Embeddings | Legacy | N/A | N/A | +| `embed-english-light-v2.0` | Embeddings | Legacy | N/A | N/A | +| `embed-multilingual-v2.0` | Embeddings | Legacy | N/A | N/A | +| `rerank-v3.5` | Rerankers | Active | N/A | N/A | +| `rerank-english-v3.0 | Rerankers | Active | N/A | N/A | +| `rerank-multilingual-v3.0` | Rerankers | Active | N/A | N/A | +| `rerank-english-v2.0` | Rerankers | Deprecated | 12/03/24 | 03/31/25 | +| `rerank-multilingual-v2.0` | Rerankers | Deprecated | 12/03/24 | 03/31/25 | ## Deprecation History All deprecations are listed below with the most recent announcements at the top.