Versioning
The document explains how to specify the API version using a URL in the header, defaulting to pre-2021-11-08 if no version is supplied. It also provides examples of how to specify the version in different programming languages and mentions the differences between stable and experimental versions.
You can specify the API version you want to use by supplying a URL in the header. For example, the URL for the stable version of Generate would be https://api.cohere.ai/v1/generate.
If no version is supplied in the header, then the API will default to no version, meaning pre-2021-11-08. Important note that the SDKs will default you to the most recent version, which is currently 2022-12-06.
Other Methods
Section titled “Other Methods”Previously, Cohere used very simple dated versioning in the format YYYY-MM-DD, not to be confused with our independent model-versioning. As of March 17, 2023, this versioning method is still available, but the URL method is preferred. All model versions are compatible with all API versions. The version must match absolutely to be applied, eg if 2022-12-06 is a version and you input 2022-12-07, the API will return an error.
The version is supplied via a Cohere-Version header and is used as following;