向量接口 · MossHub API 文档

POST /v1/embeddings
Authorization: Bearer $MOSSHUB_API_KEY
Content-Type: application/json

{
  "model": "YOUR_MODEL_ID",
  "input": ["第一段文本", "第二段文本"]
}

字段	要求
`model`	必填，向量模型的 ID，取自 `GET /v1/models`
`input`	必填，字符串或字符串数组；条数与长度上限由模型决定

dimensions、encoding_format 等其余字段原样转给上游，是否支持取决于模型。

网关只检查请求体是带 model 的 JSON 对象、顶层字段不重复，不合规时返回 400，error.type 为 invalid_request_error。字段取值由上游校验，上游的错误保留原状态码和错误体。鉴权、预算、模型范围等错误与文本对话相同。

响应由上游原样返回，按 OpenAI 格式读取 data[].embedding 与 data[].index，按 usage.prompt_tokens 计费。向量接口一次返回全部结果，没有流式模式。

{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "embedding": [0.0123, -0.0456, "…"] },
    { "object": "embedding", "index": 1, "embedding": [0.0789, 0.0012, "…"] }
  ],
  "usage": { "prompt_tokens": 14, "total_tokens": 14 }
}

完整调用示例

先替换密钥、授权模型 ID 与示例输入；不自动执行。

curl "$MOSSHUB_API_BASE/v1/embeddings" \
  -H "Authorization: Bearer $MOSSHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "YOUR_MODEL_ID", "input": ["第一段文本", "第二段文本"]}'