跳转到主要内容
POST
创建向量

授权

Authorization
string
header
必填

在 OmniRelay 控制台创建的 API Key。所有者确认身份后可在控制台再次查看。

请求头

X-Gateway-Tags
string

本次调用的标签,以逗号分隔的 key=value,例如 client=acme,env=prod。与 API Key 的默认标签合并;同名 key 以请求体 tags 字段为准。X-OmniRelay-Tags 是同一个请求头的旧名,继续接受。

X-Gateway-Metadata
enum<string>

传 enabled 时,响应会附带 gateway_metadata,说明网关为本次调用做出的决定。其他值或不传此头,响应保持不变。X-OmniRelay-Metadata 是同一个请求头的旧名,继续接受。

可用选项:
enabled

请求体

application/json
model
string
必填
input
必填
Required string length: 1 - 65536
encoding_format
enum<string>
默认值:float
可用选项:
float
dimensions
integer

要求所选向量模型已验证可调整维度。

必填范围: 1 <= x <= 16384
tags
object

本次调用的标签。与请求头和 Key 默认标签合并后最多 10 个。key 为 1 至 64 个字符,统一存为小写;value 为 1 至 128 个字符。两者只能包含字母、数字和 - _ . : /。以 gateway: 或 omnirelay: 开头的 key 为保留字。tags 不是对象时会被忽略。

示例:

响应

已验证结果,包含已结算用量和费用。

object
enum<string>
必填
可用选项:
list
model
string
必填
data
object[]
必填
usage
object
必填
cost_microusd
integer
必填

按冻结价格、Token 分项、阶梯和折扣计算的已结算费用,单位微美元。整次费用取整后应用折扣,再向上取整。这是最终费用,不是最高预留。