向量嵌入

向量生成、索引与相似度检索。

仅生成

http

POST /v1/embeddings

json

{
  "input": ["Premier texte", "Deuxieme texte"],
  "model": null,
  "routing_strategy": "auto"
}

json

{
  "embeddings": [[0.0123, -0.0456, ...], [0.0789, ...]],
  "dimensions": 1536,
  "model": "text-embedding-3-small",
  "provider": "openai"
}

索引

生成向量并将其存储到您组织的向量索引（pgvector）中，可附带自定义元数据。

http

POST /v1/embeddings/index

json

{
  "content": "IleAI est une plateforme unifiee d'acces a des modeles d'IA.",
  "metadata": { "source": "faq", "id_interne": "42" }
}

json

{ "id": "3f7a1c2e-..." }

无论您在生成时使用了哪个 model，索引操作始终强制使用 text-embedding-3-small（routing_strategy 为 "manual"）：所有涉及索引的内容必须使用相同的向量维度。

相似度检索

http

POST /v1/embeddings/search

json

{
  "query": "Comment fonctionne le routage IA ?",
  "top_k": 5
}

json

{
  "results": [
    {
      "id": "3f7a1c2e-...",
      "content": "IleAI est une plateforme unifiee d'acces a des modeles d'IA.",
      "metadata": { "source": "faq", "id_interne": "42" },
      "model": "text-embedding-3-small",
      "distance": 0.1834
    }
  ]
}

distance 为余弦距离——数值越接近 0，结果的相关性越高。

供应商

OpenAI、Google。