Embeddings

将文本转换为向量表示。

Embeddings 接口用于把文本转换为向量,可用于检索、聚类、相似度计算和 RAG。

端点

方法路径说明
POST/v1/embeddings创建文本向量

请求参数

字段类型必填说明
modelstringEmbedding 模型 ID
inputstring 或 array待向量化文本,可传单条或多条字符串
encoding_formatstring返回编码格式,例如 floatbase64,取决于模型支持
dimensionsinteger指定向量维度,取决于模型支持
userstring用户标识
seedtemperaturetop_pnumber部分兼容渠道会接收的扩展参数
frequency_penaltypresence_penaltynumber部分兼容渠道会接收的扩展参数

curl 示例

curl https://api.tensoraxis.com/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -d '{
    "model": "text-embedding-3-small",
    "input": ["第一段文本", "第二段文本"]
  }'

Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="your-tensoraxis-api-key",
    base_url="https://api.tensoraxis.com/v1",
)

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="TENSORAXIS API",
)
print(response.data[0].embedding[:5])

响应结构

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0123, -0.0456]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 8,
    "total_tokens": 8
  }
}