跳转到主要内容
POST
/
v1beta
/
models
/
{model}
:embedContent
curl --request POST \
  --url https://api.foxapi.cc/v1beta/models/{model}:embedContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": {
    "parts": [
      {
        "text": "什么是深度学习？"
      }
    ]
  }
}
'
{
  "embedding": {
    "values": [
      0.0123,
      -0.0456,
      0.0789,
      0.0234,
      -0.0567
    ]
  }
}

授权

​
Authorization
string
header
必填

所有接口均需要使用Bearer Token进行认证

使用时在请求头中添加：

Authorization: Bearer YOUR_API_KEY

路径参数

​
model
string
必填

嵌入模型名称，如 gemini-embedding-2-preview

示例:

"gemini-embedding-2-preview"

请求体

application/json
​
content
object
必填

要嵌入的内容

​
taskType
enum<string>

嵌入任务类型，影响嵌入向量的优化方向。注意：gemini-embedding-2-preview 不支持此字段，该模型改用 prompt prefix 方式指定任务类型（如 task: search result | query: {content}）

可用选项:
RETRIEVAL_QUERY,
RETRIEVAL_DOCUMENT,
SEMANTIC_SIMILARITY,
CLASSIFICATION,
CLUSTERING,
QUESTION_ANSWERING,
FACT_VERIFICATION,
CODE_RETRIEVAL_QUERY
​
title
string

文档标题，仅在 taskType 为 RETRIEVAL_DOCUMENT 时有效

​
outputDimensionality
integer

输出向量的维度，用于降维输出。默认 3072

响应

嵌入响应

​
embedding
object

嵌入结果