向量嵌入

第 1 版 · 更新于 2026-11-12 · 阅读约 1 分钟

通过 Runtoken 生成文本向量。

准备工作#

开始前，请准备：

• 在控制台创建的平台 API Key。
• 模型目录中的向量模型 ID。
• 可提交文本的服务端 HTTP 运行环境。

接口与鉴权#

发送 JSON 请求，并通过 Authorization 请求头携带平台 Key。

完整地址为 https://api.runtoken.net/v1/embeddings。

提交文本#

先提交一段文本，确认模型 ID 和鉴权配置正确。

curl 'https://api.runtoken.net/v1/embeddings' \
  -H 'Authorization: Bearer YOUR_PLATFORM_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "YOUR_MODEL_ID",
    "input": "Hello!"
  }'

运行示例前，请替换以下占位值。

input 填写需要生成向量的文本。

保存和复用向量#

建议在应用中将模型 ID 与向量一同记录。已有检索索引更换模型之前，应检查新向量的维度，以及它与检索系统的兼容性。

按所选模型的响应字段读取向量，并在写入索引前核对维度和编码格式。

批量输入与限制#

各模型可接受的批量大小、输入长度和维度参数可能不同。构建批量入库任务前，需要确认具体限制。

用量#

平台会在每次调用时请求用量。核对费用时，应查看请求的实际用量与结算记录，不宜仅根据生成的向量数量估算。本页不列固定单价，请以所选模型的价格信息为准。

下一步#

通用的鉴权、路由和计费说明见接入指南；图像相关接口见图像。