Appearance
Embeddings 文本嵌入
将文本转换为向量嵌入。
参考文档: https://platform.openai.com/docs/api-reference/embeddings
请求
POST /v1/embeddings
认证
使用 Bearer Token 认证,格式: Authorization: Bearer sk-xxxxxx
请求体 (application/json)
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型 ID(如 text-embedding-ada-002) |
| input | string/array | 是 | 要嵌入的文本 |
| encoding_format | string | 否 | float、base64,默认 float |
| dimensions | integer | 否 | 输出嵌入维度 |
请求示例
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
}
}