OpenAI 嵌入格式(Embeddings)
OpenAI 嵌入格式(Embeddings)
OpenAI Embeddings
📝 简介
💡 请求示例
创建文本嵌入 ✅
{
"object": "list",
"data": [
{
"object": "embedding",
"embedding": [
0.0023064255,
-0.009327292,
// ... (1536 个浮点数,用于 ada-002)
-0.0028842222
],
"index": 0
}
],
"model": "text-embedding-ada-002",
"usage": {
"prompt_tokens": 8,
"total_tokens": 8
}
}
批量创建嵌入 ✅
{
"object": "list",
"data": [
{
"object": "embedding",
"embedding": [
0.0023064255,
// ... (1536 个浮点数)
],
"index": 0
},
{
"object": "embedding",
"embedding": [
-0.008815289,
// ... (1536 个浮点数)
],
"index": 1
}
],
"model": "text-embedding-ada-002",
"usage": {
"prompt_tokens": 12,
"total_tokens": 12
}
}
📮 请求
端点
POST /v1/embeddings
鉴权方法
Authorization: Bearer $NEWAPI_API_KEY
$OPENAI_API_KEY
是您的 API 密钥。请求体参数
input
model
encoding_format
dimensions
user
📥 响应
成功响应
object
data
object
: 对象类型,值为 "embedding"embedding
: 嵌入向量,浮点数列表。向量长度取决于模型index
: 嵌入在列表中的索引model
usage
prompt_tokens
: 提示使用的 token 数total_tokens
: 总 token 数嵌入对象
{
"object": "embedding",
"embedding": [
0.0023064255,
-0.009327292,
// ... (ada-002 总共 1536 个浮点数)
-0.0028842222
],
"index": 0
}
index
embedding
object
错误响应
常见错误状态码
401 Unauthorized
: API 密钥无效或未提供400 Bad Request
: 请求参数无效,例如输入为空或超出 token 限制429 Too Many Requests
: 超出 API 调用限制500 Internal Server Error
: 服务器内部错误{
"error": {
"message": "The input exceeds the maximum length. Please reduce the length of your input.",
"type": "invalid_request_error",
"param": "input",
"code": "context_length_exceeded"
}
}
修改于 2025-05-30 01:49:38