Embeddings--火山方舟大模型服务平台-火山引擎

文档中心

导航

Embeddings

最近更新时间：2024.08.26 20:46:48首次发布时间：2024.07.10 20:23:07

为输入的文本内容生成对应的向量表示。

请求消息样式

POST /api/v3/embeddings HTTP/1.1
Host: ark.cn-beijing.volces.com
Content-Type: application/json
Authorization: <authorization string>

body

地域和访问域名

本接口支持的地域及 API 访问域名参见地域和访问域名。

鉴权方式

本接口支持 API Key 鉴权方式，详见鉴权认证方式。

请求参数

请求体

参数名称类型是否必填描述示例值默认值

参数名称	类型	是否必填	描述	示例值	默认值
model	String	是	您创建的推理接入点 ID	ep-202406040***-***	-
input	String or Array of String	是	需要向量化的内容列表。输入字符需要满足：不得超过模型的最大输入 token 数（对于 doubao-embdding 模型为 4096）不能为空列表，列表的每个成员不能为空字符串单条文本以 utf-8 编码，长度不超过 100,000 字节文本数量不超过 256 条	["天很蓝", "海很深"]	-
encoding_format	String	否	embedding 返回的格式，当前仅支持 `float`。	float	float

model

String

是

您创建的推理接入点 ID

ep-202406040*****-*****

input

String or Array of String

是

需要向量化的内容列表。输入字符需要满足：

不得超过模型的最大输入 token 数（对于 doubao-embdding 模型为 4096）
不能为空列表，列表的每个成员不能为空字符串
单条文本以 utf-8 编码，长度不超过 100,000 字节
文本数量不超过 256 条

["天很蓝", "海很深"]

encoding_format String 否 embedding 返回的格式，当前仅支持 float。 float float

响应参数

请求响应

参数名称	类型	描述	示例值
id	String	本次请求的唯一标识	021718049470528d92fcbe0865fdffdde********************
model	String	本次请求实际使用的模型名称和版本	doubao-embedding-text-240515
created	Integer	本次请求创建时间的 Unix 时间戳（秒）	1718049470
object	String	固定为 `list`	list
data	Array of Embedding	本次请求的算法输出内容	-
usage	Usage	本次请求的 tokens 用量	-

数据结构

Embedding

参数名称	类型	描述	示例值
index	Integer	向量的序号，与请求参数 `input` 列表中的内容顺序对应	0
embedding	Array of Float	对应内容的向量化结果	[0.01131823007017374, 0.009313009679317474, -0.03317729011178017, 0.00028884236235171556, -0.022333964705467224]
object	String	固定为 `embedding`	embedding

Usage

参数名称	类型	描述	示例值
prompt_tokens	Integer	输入的 prompt token 数量	130
total_tokens	Integer	本次请求消耗的总 token 数量（输入 + 输出）	130

请求示例

curl https://ark.cn-beijing.volces.com/api/v3/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ea764f0f-3b60-45b3-****-************" \
  -d '{
    "model": "ep-202406040*****-*****",
    "input": ["天很蓝", "海很深"]
}'

响应示例

{
    "id": "021718067849899d92fcbe0865fdffdde********************",
    "created": 171806****,
    "model": "doubao-embedding-text-240515",
    "data": [
        {
            "index": 0,
            "object": "embedding",
            "embedding": [[2.372908353805542,1.897201418876648,...,1.3692127466201782]
        }
    ],
    "usage": {
        "prompt_tokens": 7,
        "total_tokens": 7
    }
}

错误处理

错误响应

本接口调用失败的返回结构和参数释义请参见返回结构文档。

错误码

本接口错误码请参见公共错误码文档。