版本控制

您可以通过在标头中提供 URL 来指定要使用的 API 版本。例如，Generate 稳定版本的 URL 为。https://api.cohere.ai/v1/generate

如果请求头中没有提供版本,则 API 默认使用无版本,也就是 2021-11-08 之前的版本。需要注意的是,SDK 默认使用的是最新版本,当前为 2022-12-06。

其他方法

以前,Cohere 在 API 调用格式中使用了非常简单的过时版本控制方法,不要与我们独立的模型版本控制相混淆。截至 2023 年 3 月 17 日,此版本控制方法仍可使用,但建议使用基于 URL 的方法。所有模型版本与所有 API 版本兼容。调用模型版本时必须完全匹配,例如,如果模型版本是 2022-12-06 而你输入的是 2022-12-07,API 将返回错误。

该版本通过标头提供，并按如下方式使用；Cohere-Version

Python

import cohere
co = cohere.Client('{apiKey}', '2022-12-06')
response = co.generate(
  prompt='Once upon a time in a magical land called',
  max_tokens=50)
print('Prediction: {}'.format(response.generations[0].text))

JavaScript

const cohere = require('cohere-ai');
cohere.init('{apiKey}', '2021-11-08');
(async () => {
  const response = await cohere.generate({
    prompt: 'Once upon a time in a magical land called',
    max_tokens: 50
  });
  console.log(`Prediction: ${response.body.generations[0].text}`);
})();

GO

const cohere = require('cohere-ai');
cohere.init('{apiKey}', '2021-11-08');
(async () => {
  const response = await cohere.generate({
    prompt: 'Once upon a time in a magical land called',
    max_tokens: 50
  });
  console.log(`Prediction: ${response.body.generations[0].text}`);
})();

cURL

curl --location --request POST 'https://api.cohere.ai/generate' \
  --header 'Authorization: BEARER {apiKey}' \
  --header 'Content-Type: application/json' \
  --header 'Cohere-Version: 2021-11-08' \
  --data-raw '{
      "prompt": "Once upon a time in a magical land called",
      "max_tokens": 50
    }'

版本

2022-12-06

在响应分类(Classify)时,删除了置信度数组(confidences array),改为使用标签映射(labels map)。

2021-11-08

这一版本引入了多次生成(multiple generations)的功能,即生成(generations)端点现在可以接受 num_generations 参数,并总是返回生成结果数组。具体请参阅生成(generate)参考文档。

无版本（已弃用）

关于无版本的具体行为,请参阅特定端点的文档。

此外,API版本分为两种:稳定版和实验版。稳定版已经过测试,可以正常工作。实验版包含新的可能会破坏旧版本功能的特性。为获得最好的体验,用户应使用稳定版。只有当用户想试用某个只在实验版中可用的特定功能时,才应使用实验版。

当前,我们只提供一个稳定版 v1,它具有 2022-12-06 和 2021-11-08 版本的所有功能。我们目前没有提供任何实验版。