嵌入（Embeddings）

将文本转换为向量表示，常用于语义检索、相似度计算、聚类与 RAG 场景。

创建嵌入

POST /v1/embeddings

请求参数

参数	类型	必填	说明
model	string	是	嵌入模型标识，如 text-embedding-3-small
input	string | array	是	待嵌入的文本，或文本数组（批量）
encoding_format	string	否	float（默认）或 base64
dimensions	integer	否	输出向量维度（部分模型支持）

请求示例

curl https://ai.youqi.tech/v1/embeddings \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "YouQi AI 是一站式 AI 模型接入平台。"
  }'

批量请求

input 传入数组即可一次嵌入多条文本：

{
  "model": "text-embedding-3-small",
  "input": ["第一段文本", "第二段文本", "第三段文本"]
}

响应示例

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023, -0.0091, 0.0157, "..."]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 18,
    "total_tokens": 18
  }
}

响应字段

字段	类型	说明
data[].embedding	array	向量，长度取决于模型维度
data[].index	integer	对应输入的顺序索引
usage.prompt_tokens	integer	消耗的输入 Token 数

提示

另有原生Gemini格式（/v1/engines/{model}/embeddings，旧版引擎路径风格）。