Embeddings

POST /v1/embeddings — 将文本转换为高维向量表示,适用于语义搜索、文本分类、相似度计算、RAG 等场景。

请求示例

cURLBash
curl https://www.ulovegpt.com/v1/embeddings \
  -H "Authorization: Bearer <你的 API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": "今天的天气真好"
  }'
PythonPython
from openai import OpenAI

client = OpenAI(
    base_url="https://www.ulovegpt.com/v1",
    api_key="<你的 API_KEY>"
)

response = client.embeddings.create(
    model="openai/text-embedding-3-small",
    input=["今天的天气真好", "明天会下雨吗"]
)

for i, emb in enumerate(response.data):
    print(f"文本 {i+1}: {len(emb.embedding)} 维向量")

请求参数

参数类型必填说明
modelstringEmbedding 模型名称
inputstring/array需要编码的文本,支持单个字符串或数组
encoding_formatstring输出格式:float / base64(默认 float)
dimensionsinteger指定向量维度(部分模型支持)

响应格式

响应示例Json
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023064255, -0.009327292, 0.015435447, ...],
      "usage": {
        "prompt_tokens": 7,
        "total_tokens": 7
      }
    }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": {
    "prompt_tokens": 7,
    "total_tokens": 7
  }
}

可用 Embedding 模型

模型维度说明
text-embedding-3-small1536高性能,通用场景
text-embedding-3-large3072最高精度,复杂语义理解
text-embedding-ada-0021536上一代模型