字段与用途
| 字段路径 | 位置 | 类型 | 必填 | 填写规则与说明 | 允许值 / 约束 | 示例 |
|---|---|---|---|---|---|---|
data | 响应 JSON | array | 否 | 数组，按 index 关联输入。embedding 为所选格式的向量；空结果要作为失败处理。 | - | - |
data[] | 响应 JSON | object | 否 | 数组元素。 | - | - |
data[].object | 响应 JSON | string | 否 | - | - | - |
data[].index | 响应 JSON | integer | 否 | - | - | - |
data[].embedding | 响应 JSON | array<number> | 否 | - | - | - |
data[].embedding[] | 响应 JSON | number | 否 | 数组元素。 | - | - |
结果校验
返回条数应与 input 数组长度一致；按 index 关联，检查向量长度与 dimensions。encoding_format=float 才是数字数组；base64 不是文本答案。
索引与查询
文档和查询使用同一模型及维度；分段、清洗规则一致。更换模型或维度后重新嵌入历史文档，不能只重算查询向量。usage 为本次文本用量，与检索数据库容量无关。
调用示例与参考
常见错误
401：检查本站 API Key 和 Bearer 格式；403：确认此 Key 可用该模型；429：遵循 Retry-After 退避。超时或 5xx 时保留请求标识和脱敏错误，避免盲目重发；其他通用排查见聊天接入总览。