文本转向量API
将文本转为向量数组,适合做语义检索召回、相似度计算与向量入库。单文本可直接传顶层 query,也可用 filters.text;批量可用 filters.texts。可选 filters.embedding_type:query(默认)或 db;可选 filters.model,默认 embo-01。本接口无分页,不支持 filters.offset。
已开放
调用入口:POST /v1/data/query。
请求体字段
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| domain | string | 数据域(必填) | cloud |
| type | string | 数据类型(必填) | text_vector |
| query | string | 自然语言检索词 | 劳动合同解除,用人单位是否需要支付赔偿金 |
| filters | object | 结构化过滤条件,见下方「常用 filters」 | — |
常用 filters
| 字段 | 类型 | 说明 | 示例 |
|---|---|---|---|
| text | string | 单条文本(也可直接用 query) | 劳动合同解除,用人单位是否需要支付赔偿金 |
| texts | list | 批量文本数组(与 text/query 三选一,优先使用 texts) | — |
| embedding_type | string | 向量用途:query(默认,检索查询)或 db(入库索引) | query |
| model | string | 模型名(默认 embo-01) | embo-01 |
返回字段(hits[])
| 字段 | 类型 | 说明 |
|---|---|---|
| vector | list | 向量数组 |
| source | string | 来源标识 |
| disclaimer | string | 数据口径说明 |
curl 请求示例
curl -sS -X POST https://data.devnors.com/v1/data/query \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain":"cloud", "type":"text_vector", "query":"劳动合同解除,用人单位是否需要支付赔偿金", "filters":{ "text":"劳动合同解除,用人单位是否需要支付赔偿金", "embedding_type":"query", "model":"embo-01" } }'将 YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。