跳转到主要内容
POST
创建文本的数值向量表示。同一模型产生的向量可用于语义相似度比较与检索。

端点

请求头

Authorization
string
必填
格式为 Bearer $YELU_API_KEY
Content-Type
string
必填
必须为 application/json

请求体

model
string
必填
账号可用的 Embedding 模型 ID。
input
string | string[]
必填
单段文本或文本数组。空输入和超过模型上下文限制的输入会被拒绝。
encoding_format
string
默认值:"float"
float 返回数字数组;兼容模型可用 base64
dimensions
integer
支持缩短向量的模型可指定输出维度。
user
string
稳定且不敏感的用户标识。

响应

object
string
必填
固定为 list
data
array
必填
与输入顺序一致的向量数组,每项包含 objectindexembedding
model
string
必填
生成向量的模型。
usage
object
Token 用量。

错误码

不要比较不同模型或不同维度产生的向量。切换配置时应重新生成整个语料库的向量,并在索引元数据中记录版本。
最后修改于 2026年7月13日