在给定输入 Content
的情况下,从模型生成嵌入。
HTTP 请求
POST https://generativelanguage.googleapis.com/v1beta/{model=models/*}:embedContent
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
model |
必需。模型的资源名称。它作为要使用的模型的 ID。 此名称应与 格式: |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "content": { object ( |
字段 | |
---|---|
content |
必需。要嵌入的内容。系统只会统计 |
taskType |
可选。嵌入将用于的可选任务类型。只能为 |
title |
可选。文本的可选标题。仅在 TaskType 为 注意:为 |
outputDimensionality |
可选。输出嵌入的可选缩减维度。如果设置此参数,则将从末尾截断输出嵌入中的过多值。自 2024 年以来较新的模型支持此值,而较早的模型 ( |
响应正文
对 EmbedContentRequest
的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"embedding": {
object ( |
字段 | |
---|---|
embedding |
仅限输出。从输入内容生成的嵌入。 |
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/generative-language
https://www.googleapis.com/auth/generative-language.tuning
https://www.googleapis.com/auth/generative-language.tuning.readonly
https://www.googleapis.com/auth/generative-language.retriever
https://www.googleapis.com/auth/generative-language.retriever.readonly
如需了解详情,请参阅身份验证概览。