Skip to content

Embeddings 文本嵌入 ​

将文本转换为向量嵌入。

参考文档: https://platform.openai.com/docs/api-reference/embeddings

请求 ​

POST /v1/embeddings

认证 ​

使用 Bearer Token 认证,格式: Authorization: Bearer sk-xxxxxx

请求体 (application/json) ​

参数类型必填说明
modelstring是模型 ID(如 text-embedding-ada-002)
inputstring/array是要嵌入的文本
encoding_formatstring否float、base64,默认 float
dimensionsinteger否输出嵌入维度

请求示例 ​

bash
curl -X POST "https://your-api-base/v1/embeddings" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-ada-002",
    "input": "The food was delicious and the waiter..."
  }'
python
from openai import OpenAI

client = OpenAI(
    api_key="sk-xxxxxx",
    base_url="https://your-api-base/v1"
)

response = client.embeddings.create(
    model="text-embedding-ada-002",
    input="The food was delicious and the waiter..."
)

print(response.data[0].embedding[:5])

响应 ​

200 成功响应 ​

json
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023064255, -0.009327292, 0.015797777, ...]
    }
  ],
  "model": "text-embedding-ada-002",
  "usage": {
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}