Embeddings

POST/v1/embeddings

把文本或文本数组转换为向量表示。

向量维度、批量限制和可选字段由所选模型与 Provider 决定,请先从模型目录选择 embedding 能力模型。

核心请求字段

字段类型必填说明
modelstring是Embedding 模型 ID。
inputstring | array是需要向量化的文本或文本数组。
encoding_formatstring否输出编码格式,仅在模型路由支持时使用。
dimensionsinteger否目标维度,仅在模型路由支持时使用。

请求示例

curl
curl https://api.noxgate.net/v1/embeddings \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":["First document","Second document"]}'
Python · OpenAI SDK
from openai import OpenAI

client = OpenAI(api_key="sk-your-api-key", base_url="https://api.noxgate.net/v1")
response = client.embeddings.create(model="YOUR_MODEL_ID", input=["First document", "Second document"])
print(response.data[0].embedding)
Node.js · OpenAI SDK
import OpenAI from "openai";

const client = new OpenAI({ apiKey: "sk-your-api-key", baseURL: "https://api.noxgate.net/v1" });
const response = await client.embeddings.create({ model: "YOUR_MODEL_ID", input: ["First document", "Second document"] });
console.log(response.data[0].embedding);

成功响应

JSON
{"object":"list","data":[{"object":"embedding","index":0,"embedding":[0.012,-0.031,0.008]}],"model":"YOUR_MODEL_ID","usage":{"prompt_tokens":4,"total_tokens":4}}