API文档(api-reference)
嵌入(Embeddings)

嵌入 Embeddings

获取给定输入的向量表示,可以轻松地被机器学习模型和算法所消耗。

相关指南:嵌入

创建嵌入向量 Create embeddings

post https://api.openai.com/v1/embeddings (opens in a new tab)

创建表示输入文本的嵌入向量。

请求体

model 是字符串类型的必填项,表示要使用的模型的ID。您可以使用 列出模型 API 查看所有可用的模型,或查看我们的 模型概述 以获取其描述。

input 是字符串或者数组类型的必填项,表示输入的文本,编码为字符串或令牌数组。要在单个请求中为多个输入获取嵌入,请传递字符串数组或令牌数组的数组。每个输入的长度不得超过 8192 个令牌。

user 是字符串类型的可选项,表示您最终用户的唯一标识符,有助于 OpenAI 监测和检测滥用行为。了解更多

请求示例(Python方式)

curl https://api.openai.com/v1/embeddings 
  -H "Authorization: Bearer $OPENAI_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "input": "The food was delicious and the waiter...",
    "model": "text-embedding-ada-002"
  }'

请求参数(Parameters)

{
 "model": "text-embedding-ada-002",
 "input": "The food was delicious and the waiter..."
}

响应体 (Response)

{
 "object": "list",
 "data": [
    {
 "object": "embedding",
 "embedding": [
 0.0023064255,
 -0.009327292,
 .... (1536 floats total for ada-002)
 -0.0028842222,
      ],
 "index": 0
    }
  ],
 "model": "text-embedding-ada-002",
 "usage": {
 "prompt_tokens": 8,
 "total_tokens": 8
  }
}