创建 Gemini 嵌入

使用指定引擎/模型创建嵌入

POST /v1/engines/{model}/embeddings

服务根地址: https://getrouter.ai

协议: Gemini-compatible

认证: x-goog-api-key: YOUR_API_KEY

请求参数

参数位置类型必填说明
modelpathstring模型/引擎 ID

请求体

请求体可选。 媒体类型: application/json

请求字段

字段类型必填说明
modelstring
inputstring or array<string>要嵌入的文本
encoding_formatstring可选值: float, base64; 默认值: "float"
dimensionsinteger输出向量维度

请求示例

curl --request POST \
  --url https://getrouter.ai/v1/engines/MODEL_ID/embeddings \
  --header "x-goog-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "MODEL_ID",
  "input": "你好,请介绍一下自己。"
}'

响应

状态码说明
200成功创建嵌入

成功响应字段

字段类型必填说明
objectstring
dataarray<object>
modelstring
usageobject

响应示例

{
  "object": "object",
  "data": [
    {
      "object": "object",
      "index": 1,
      "embedding": [
        1
      ]
    }
  ],
  "model": "MODEL_ID",
  "usage": {
    "prompt_tokens": 1,
    "total_tokens": 1
  }
}

相关指南

需要完整调用流程和场景示例时,请阅读 Gemini API 使用指南。


此页面由公开 Relay OpenAPI 自动生成。完整规范可在 API Explorer 中查看。