首页/AI/AI 应用速查/Embeddings 接口(/v1/embeddings)

Embeddings 接口(/v1/embeddings)

文本转向量:POST /v1/embeddings,body {model, input}(input 支持字符串数组),响应 data[].embedding 与输入顺序一致,是检索与聚类流水线的入口。

AI 应用速查AI更新于 2026-10-12
路径/v1/embeddings
模型text-embedding-3-small/large;本地 bge 系等
批量input 传数组,注意单批 token 上限
降维部分模型支持 dimensions 参数降维存储

批量向量化(curl)

批量向量化(curl)
curl -s https://api.openai.com/v1/embeddings -H "Authorization: Bearer $OPENAI_API_KEY" -H "Content-Type: application/json" -d '{"model":"text-embedding-3-small","input":["第一段文本","第二段文本"]}'
向量入库前注意归一化处理:使用 cosine 相似度时通常先归一化,避免重复归一造成误差。

易错点

  • 单次批大小或总 token 超限被拒
  • 索引与查询端使用不同的归一化/预处理口径

数据来源与参考

  • OpenAI Embeddings API 参考

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌