Skip to main content
POST
/
v1
/
models
/
{model}
:embedContent
curl --request POST \
  --url https://api.mixroute.ai/v1/models/gemini-embedding-001:embedContent \
  --header 'Authorization: Bearer sk-xxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "content": {
      "parts": [{"text": "这是一段测试文本"}]
    }
  }'

{
  "embedding": {
    "values": [0.0023064255, -0.009327292, 0.015797347]
  },
  "metadata": {
    "usage": {
      "prompt_tokens": 6,
      "total_tokens": 6
    }
  }
}

​
简介

使用 Gemini 原生接口将文本转换为向量嵌入。模型由 URL 路径 指定（如 gemini-embedding-001），适用于需要 Google 嵌入模型或与 Gemini API 对齐的场景。 与 文本向量化（Embedding） 的 OpenAI 格式互为补充：本文档为 Gemini 原生路径；同一能力也可通过 POST /v1/embeddings 调用。

​
认证

Bearer Token，如 Bearer sk-xxxxxxxxxx

​
路径参数

​
model
string
required
嵌入模型名称，如 gemini-embedding-001。

​
请求参数

​
content
object
required
待嵌入内容。须包含 parts 数组，每项为 { "text": "文本内容" }。
​
outputDimensionality
integer
输出向量维度（仅部分模型支持，如 gemini-embedding-001、text-embedding-004）。
​
taskType
string
任务类型，如 RETRIEVAL_DOCUMENT、RETRIEVAL_QUERY（可选）。

​
代码示例

curl -X POST "https://api.mixroute.ai/v1/models/gemini-embedding-001:embedContent" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "content": {
      "parts": [
        { "text": "要嵌入的文本内容" }
      ]
    }
  }'

​
响应示例

{
  "embedding": {
    "values": [0.0023064255, -0.009327292, 0.015797347, ...]
  },
  "metadata": {
    "usage": {
      "prompt_tokens": 6,
      "total_tokens": 6
    }
  }
}

​
批量接口（batchEmbedContents）

批量嵌入请使用：POST /v1/models/{model}:batchEmbedContents，请求体为 requests 数组，每项结构同单条（含 content.parts），且 不要 在每项中带 model 字段。 
curl -X POST "https://api.mixroute.ai/v1/models/gemini-embedding-001:batchEmbedContents" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxx" \
  -d '{
    "requests": [
      { "content": { "parts": [{ "text": "第一段文本" }] } },
      { "content": { "parts": [{ "text": "第二段文本" }] } }
    ]
  }'

​
支持的模型

模型说明
gemini-embedding-001通用嵌入模型，支持 outputDimensionality
text-embedding-004高精度嵌入模型

​
注意事项

  • content.parts 必填，至少一个 text 非空
  • 模型由 URL 路径指定，请求体不要包含 model 字段
  • 用量信息在响应的 metadata.usage 中（prompt_tokens、total_tokens）
如果您的应用已使用 OpenAI SDK，建议使用 /v1/embeddings 兼容接口以减少代码改动。
curl --request POST \
  --url https://api.mixroute.ai/v1/models/gemini-embedding-001:embedContent \
  --header 'Authorization: Bearer sk-xxxxxxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "content": {
      "parts": [{"text": "这是一段测试文本"}]
    }
  }'

{
  "embedding": {
    "values": [0.0023064255, -0.009327292, 0.015797347]
  },
  "metadata": {
    "usage": {
      "prompt_tokens": 6,
      "total_tokens": 6
    }
  }
}