Gemini batchEmbedContents

POST

/v1/models/{model}:batchEmbedContents

由 /v1/models/*path 通配路由处理。generateContent / streamGenerateContent 为内容生成，embedContent / batchEmbedContents 为嵌入。/v1beta 的 :countTokens 在鉴权和选路前返回 404，当前未支持。

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Query 参数

Header 参数

Body 参数application/json必填

示例

返回响应

🟢200

application/json

成功响应

Bodyapplication/json

⚪default

请求示例

Shell

JavaScript

Java

Swift

curl --location '/v1/models/:batchEmbedContents?key=&alt=' \
--header 'x-goog-api-key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "requests": [
        {
            "model": "string",
            "content": {
                "role": "string",
                "parts": [
                    {
                        "text": "string",
                        "thought": true,
                        "inlineData": {
                            "mimeType": "string",
                            "data": "string",
                            "property1": "string",
                            "property2": "string"
                        },
                        "functionCall": {
                            "id": "string",
                            "name": "string",
                            "args": null,
                            "partialArgs": [
                                {
                                    "jsonPath": "string",
                                    "numberValue": 0,
                                    "stringValue": "string",
                                    "boolValue": true,
                                    "nullValue": null,
                                    "willContinue": true,
                                    "property1": "string",
                                    "property2": "string"
                                }
                            ],
                            "willContinue": true,
                            "property1": "string",
                            "property2": "string"
                        },
                        "thoughtSignature": null,
                        "functionResponse": {
                            "name": "string",
                            "response": {
                                "property1": "string",
                                "property2": "string"
                            },
                            "willContinue": null,
                            "scheduling": null,
                            "parts": null,
                            "id": null,
                            "property1": "string",
                            "property2": "string"
                        },
                        "mediaResolution": null,
                        "videoMetadata": null,
                        "fileData": {
                            "mimeType": "string",
                            "fileUri": "string",
                            "property1": "string",
                            "property2": "string"
                        },
                        "executableCode": {
                            "language": "string",
                            "code": "string",
                            "property1": "string",
                            "property2": "string"
                        },
                        "codeExecutionResult": {
                            "outcome": "string",
                            "output": "string",
                            "property1": "string",
                            "property2": "string"
                        },
                        "property1": "string",
                        "property2": "string"
                    }
                ],
                "property1": "string",
                "property2": "string"
            },
            "taskType": "string",
            "title": "string",
            "outputDimensionality": 0,
            "property1": "string",
            "property2": "string"
        }
    ],
    "property1": "string",
    "property2": "string"
}'

响应示例

200 - 示例 1

{
    "embeddings": [
        {
            "values": [
                0
            ],
            "property1": "string",
            "property2": "string"
        }
    ],
    "property1": "string",
    "property2": "string"
}

修改于 2026-10-17 04:30:31

Gemini embedContent

未实现 · /v1/files