MoonApiX Docs

Appearance

文本向量 ​

文本向量接口用于把文本转换为向量，适合语义检索、相似度匹配、聚类、排序和知识库召回。

接口路径 ​

方法路径返回方式
POST/v1/embeddings同步返回向量结果。

请求示例 ​

bash
curl https://moonapix.com/v1/embeddings \
  -H "Authorization: Bearer <MOONAPIX_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "moonapix-embedding",
    "input": "MoonApiX developer documentation"
  }'

常用字段 ​

字段说明
model向量模型名。
input单条文本或文本数组。
encoding_format向量编码格式，以 API Reference 为准。

响应处理 ​

场景处理方式
单条文本保存向量、原文 ID、模型名和创建时间。
批量文本按输入顺序绑定向量和原文，避免错位。
检索查询查询侧和入库侧使用同一个向量模型。

接入建议 ​

  • 保存向量时同步保存原文 ID，便于召回后回查业务数据。
  • 批量写入前先做文本清洗和分段，保持每段语义完整。
  • 查询侧和入库侧使用同一个向量模型，避免相似度结果漂移。

相关页面 ​