nexusflow
Online
Loading...
POST/v1/embeddings

文本向量 API

将文本转换为高维向量表示,用于语义搜索、文本分类、聚类分析等场景。

支持的模型

模型 ID供应商向量维度最大输入价格
text-embedding-v3阿里云1024/20488192 tokens¥0.5/百万
text-embedding-3-smallOpenAI512/15368191 tokens¥0.14/百万
text-embedding-3-largeOpenAI256-30728191 tokens¥0.91/百万

请求参数

参数名类型必填默认值说明
modelstring*-嵌入模型 ID。例如 text-embedding-v3、text-embedding-3-small 等。
inputstring | array*-要嵌入的文本。可以是单个字符串或字符串数组(批量处理)。
encoding_formatstring-"float"返回向量的格式。支持 float 或 base64。
dimensionsinteger-模型默认输出向量的维度。仅部分模型支持自定义维度。
userstring--终端用户的唯一标识符,用于监控和滥用检测。

代码示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-air-your-key",
    base_url="https://nexusflow.hk/v1",
)

response = client.embeddings.create(
    model="text-embedding-v3",
    input="nexusflow 是一个统一的大模型 API 平台",
)

embedding = response.data[0].embedding
print(f"向量维度: {len(embedding)}")
print(f"前 5 个值: {embedding[:5]}")

响应结构

字段类型说明
objectstring固定值 "list"
dataarray嵌入向量数组
data[].objectstring固定值 "embedding"
data[].indexinteger对应输入文本的索引
data[].embeddingarray浮点数向量,维度取决于模型
modelstring使用的模型 ID
usageobjectToken 使用统计
usage.prompt_tokensinteger输入文本消耗的 Token 数
usage.total_tokensinteger总 Token 数

响应示例

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023064255, -0.009327292, 0.015797347, ...]
    }
  ],
  "model": "text-embedding-v3",
  "usage": {
    "prompt_tokens": 12,
    "total_tokens": 12
  }
}

应用场景

语义搜索

将查询和文档转换为向量,通过向量相似度实现语义级别的搜索。

文本分类

利用向量表示进行文本分类,无需大量标注数据。

聚类分析

对大量文本进行聚类,发现隐含的主题和模式。

推荐系统

基于内容相似度为用户推荐相关文章或产品。

相关文档