API 参考
Embeddings 向量接口
将文本转换为向量,管理模型、维度与索引的一致性。
生成向量
选择支持 Embeddings 的模型,按 API 概览设置密钥。不要使用普通对话模型 ID 替代向量模型。
curl --fail-with-body 'https://gateway.irouter.io/v1/embeddings' \
-H "Authorization: Bearer $IROUTER_API_KEY" \
-H 'Content-Type: application/json' \
--data '{"model":"<model-id>","input":["Account access","Payment receipt"]}'input 可按模型支持填写文本或文本数组。数组批量大小和文本长度应遵守目标模型限制。
保存和检索
响应的 data 中包含 embedding 向量,使用 index 对齐输入顺序。将文本标识、模型 ID 和向量维度一起保存。检索查询与被检索文本使用一致的模型和参数;更换模型后通常需要重新构建索引。
不要把向量维度写成所有模型通用的常量。只有模型明确支持时才传 dimensions,并确保向量数据库采用同一维度。
用量和失败处理
向量生成也可能产生费用,按目录中该模型的计价方式核对。请求过长时按语义分块;模型不支持时回到模型选择。对批处理保存已完成项目,避免网络重试导致重复入库。