API 參考
Embeddings
將文本轉換為向量表示。
Embeddings 接口用於把文本轉換為向量，可用於檢索、聚類、相似度計算和 RAG。
端點
| 方法 | 路徑 | 說明 |
|---|---|---|
POST | /v1/embeddings | 創建文本向量 |
請求參數
| 字段 | 類型 | 必填 | 說明 |
|---|---|---|---|
model | string | 是 | Embedding 模型 ID |
input | string 或 array | 是 | 待向量化文本，可傳單條或多條字符串 |
encoding_format | string | 否 | 返回編碼格式，例如 float 或 base64，取決於模型支持 |
dimensions | integer | 否 | 指定向量維度，取決於模型支持 |
user | string | 否 | 用戶標識 |
seed、temperature、top_p | number | 否 | 部分兼容渠道會接收的擴展參數 |
frequency_penalty、presence_penalty | number | 否 | 部分兼容渠道會接收的擴展參數 |
curl 示例
curl https://api.tensoraxis.ai/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.ai/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
}
}