/v1beta/models/gemini-2.5-pro:generateContent使用专用 embedContent 动作生成向量，替换误写为文本生成的旧 Embeddings 示例。
Gemini Embedding 2 将支持的输入映射为向量。本页从单条文字开始，输出 embedding.values；不会生成聊天回复。
gemini-embedding-2，默认3072维，可指定较低维度；示例768。gemini-embedding-001 仍适用于文本嵌入。Embedding 2 不支持 taskType，应按业务需要在文本中给出任务指令。
使用青云TOP API 的 API Key：Authorization: Bearer YOUR_API_KEY。替换占位符，保留 Bearer 后的空格。无需厂商 API Key。
POST https://top.qingyuntop.ai/v1beta/models/gemini-embedding-2:embedContent
请求为 application/json。
/v1beta/models/gemini-2.5-pro:generateContentBodyobjectcontentsarray<object>必填必填，顶层 content 数组。role 使用 user / model，parts 保持原始顺序；下一轮重新发送历史。
元素object数组元素。
partsarray<object>每条 content 必填。文本 {text:...}；媒体 {inlineData:{mimeType,data}}；一张图片一个 part，顺序影响引用。
元素object数组元素。
textstringmodel（路径）string必填必填，在 /v1beta/models/{model}:动作 中填写；generateContent 请求体无需重复 model。
modelstring原生嵌入请求填写 models/ 加准确模型 ID，与路径一致；例如 models/gemini-embedding-001 或 models/gemini-embedding-2。批量请求中每条都携带该字段。
contentobjectembedContent 必填的单个 content 对象，parts 包含待嵌入文字；不是聊天接口的 contents 数组。
outputDimensionalityinteger选填，正整数。gemini-embedding-001 与 gemini-embedding-2 默认3072维，常用768 / 1536 / 3072；同一索引保持模型、维度与归一化规则一致。字段使用 camelCase。
generationConfigobject选填，顶层对象。输出长度、采样、结构化格式、思考和语音设置分别放在对象对应子字段。
temperaturenumbertopPnumbertopKintegermaxOutputTokensinteger选填，正整数，无统一默认。限制输出 token，思考也占用预算；示例 4096。
stopSequencesarray<string>元素string数组元素。
safetySettingsarray<object>选填字段；是否可用取决于当前模型和协议。
元素object数组元素。
categorystringthresholdstringtoolsarray<object>选填，顶层工具数组。按本页选择 functionDeclarations、googleSearch、urlContext 或 codeExecution；名称区分大小写。
元素object数组元素。
systemInstructionobject选填，顶层。parts 中填写文本指令，不放入 generationConfig。
partsarray<object>元素object数组元素。
| 参数 | 位置 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|---|
key | Query | string | 是 | - | YOUR_API_KEY |
Content-Type | Header | string | 是 | - | application/json |
x-goog-api-key | Header | string | 否 | - | YOUR_API_KEY |
200响应 200object本站 Chat 兼容嵌入目前推荐001；不要假定 /v1/embeddings 对 Embedding 2 的 dimensions 等扩展与原生完全一致。
401：检查本站 API Key 和 Bearer 格式；403：确认此 Key 可用该模型；429：遵循 Retry-After 退避。超时或 5xx 时保留请求标识和脱敏错误，避免盲目重发；其他通用排查见聊天接入总览。