Skip to main content
OpenAI 词向量服务,用于生成表示输入文本的词向量结果。 本文档主要介绍 OpenAI Embeddings API 操作的使用流程,利用它我们可以创建表示输入文本的嵌入向量。。

申请流程

要使用 OpenAI Embeddings API,首先到 Ace Data Cloud 控制台 获取您的 API Token,留作备用。 如果你尚未登录或注册,会自动跳转到登录页面邀请你注册和登录,完成后会自动返回当前页面。 一个 API Token 即可调用平台所有服务,无需为每个服务单独申请。 首次申请会赠送免费额度,可免费体验;额度不足时可在 控制台 充值通用余额。
📘 完整文档:OpenAI Embeddings API →

基本使用

接下来就可以在界面上填写对应的内容,如图所示:

在第一次使用该接口时,我们至少需要填写三个内容,一个是 authorization,直接在下拉列表里面选择即可。另一个参数是 modelmodel 就是我们选择使用 OpenAI 官网模型类别,这里我们主要有 3 种模型,详情可以看我们提供的模型。最后一个参数是inputinput 是我们需要转换的词向量文本。 同时您可以注意到右侧有对应的调用代码生成,您可以复制代码直接运行,也可以直接点击「Try」按钮进行测试。 可选参数:
  • dimensions:裁剪向量维度,默认输出完整维度。
  • encoding_format:返回格式,可选 floatbase64

Python 样例调用代码:
调用之后,我们发现返回结果如下:
返回结果一共有多个字段,介绍如下:
  • model,此次文本转词向量所采用的模型。
  • usage,此次文本转词向量所使用的token信息。
  • data,文本转化后的词向量结果。
其中 data 是包含了文本对应的词向量的具体信息,它里面的 embedding 是生成的词向量具体结果。

错误处理

在调用 API 时,如果遇到错误,API 会返回相应的错误代码和信息。例如:
  • 400 token_mismatched:Bad request, possibly due to missing or invalid parameters.
  • 400 api_not_implemented:Bad request, possibly due to missing or invalid parameters.
  • 401 invalid_token:Unauthorized, invalid or missing authorization token.
  • 429 too_many_requests:Too many requests, you have exceeded the rate limit.
  • 500 api_error:Internal server error, something went wrong on the server.

错误响应示例

结论

通过本文档,您已经了解了如何使用 OpenAI Embeddings API 轻松使用官方 OpenAI 的词向量生成的功能。希望本文档能帮助您更好地对接和使用该 API。如有任何问题,请随时联系我们的技术支持团队。