Skip to content
EN

创建嵌入

方法: POST路径: /v1/embeddings

获取给定输入的矢量表示,机器学习模型和算法可以轻松使用该表示。

相关指南:嵌入

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

请求参数

Header 参数

text
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

text
model
string
必需
要使用的模型的 ID。您可以使用
List models
API 来查看所有可用模型,或查看我们的
模型概述
以了解它们的描述。
input
string
必需
输入文本以获取嵌入,编码为字符串或标记数组。要在单个请求中获取多个输入的嵌入,请传递一个字符串数组或令牌数组数组。每个输入的长度不得超过 8192 个标记。
示例
{
"model"
:
"string"
,
"input"
:
"string"
}

请求示例代码

Shell

bash
curl --location --request POST '/v1/embeddings' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "string",
    "input": "string"
}'

返回响应

🟢 200 Create embeddings

内容类型: application/json

响应结构

text
object
string
必需
data
array
[object]
必需
object
string
可选
embedding
array
[number]
可选
index
integer
可选
model
string
必需
usage
object
必需
prompt_tokens
integer
必需
total_tokens
integer
必需

示例

json
{
  "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
  }
}