Skip to main content
POST
GPT - 向量

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

将文本或 token ID 转换为向量表示。

model
string
必填

向量模型 ID。

Minimum string length: 1
示例:

"openai/text-embedding-3-small"

"openai/text-embedding-3-large"

"bailian/text-embedding-v4"

"google/gemini-embedding-2-preview"

input
必填

需要生成向量的输入。支持单个字符串、字符串数组、token ID 数组或 token ID 二维数组。Gemini embedding 模型当前只支持单个字符串。

Minimum string length: 1
示例:

"OfoxAI 是一个 LLM Gateway"

encoding_format
enum<string>
默认值:float

向量编码格式。float 返回浮点数数组;base64 返回 Base64 编码的 float32 数据。

可用选项:
float,
base64
dimensions
integer

输出向量维度,仅部分模型支持。Gemini embedding 模型在当前网关中限制为 128 至 3072。

必填范围: x >= 1
user
string

终端用户标识,用于上游滥用监控。

响应

200 - application/json

OpenAI Embeddings 兼容响应。

object
string
必填

固定为 list。

Allowed value: "list"
data
object[]
必填

输入对应的向量结果列表。

Minimum array length: 1
model
string
必填

实际使用的模型 ID。

usage
object
必填