模型选择
| 模型 ID | 动作与使用建议 |
|---|---|
| gemini-4-argon | 当前最新高能力 Gemini；复杂推理、长文分析与多模态任务，按账号权限使用 |
| gemini-3.1-pro | 复杂推理与长文分析；使用 thinkingLevel，不沿用 2.5 预算配置 |
| gemini-3-flash / gemini-3.8-flash | 通用文本与多模态理解；优先选择延迟和吞吐更合适的型号 |
| gemini-3.1-flash-lite | 吞吐和延迟优先的轻量任务；按账号权限选择 |
| gemini-2.5-pro / gemini-2.5-flash | 存量预算思考模式；用 thinkingBudget，关注型号生命周期 |
| gemini-embedding-2 | 最新多模态嵌入；原生 embedContent，不使用 taskType |
| gemini-embedding-001 | 文本嵌入，支持 taskType；可用原生或 /v1/embeddings |
| gemini-3.1-flash-tts-preview | 专用语音生成，预览型号，使用 AUDIO 与 speechConfig |
下面是 2026-10-30 读取的公开 pricing 目录代表性型号，不是完整清单，也不替代你的 API Key 的GET /v1/models结果。带日期、preview、渠道或-c后缀的名称按独立本站模型 ID 使用。模型名后的high、medium、low、ultra是青云/New API 的路由或能力后缀，不等同于 Google 官方型号。
| 模型 ID | 目录协议提示 | 可用性说明 |
|---|---|---|
gemini-4-argon | gemini、openai | 当前公开目录快照；以 API Key 权限为准 |
gemini-3.1-pro | gemini、openai | 当前公开目录快照；以 API Key 权限为准 |
gemini-3-flash | gemini、openai | 当前公开目录快照；以 API Key 权限为准 |
gemini-3.8-flash | gemini、openai | 当前公开目录快照；以 API Key 权限为准 |
gemini-3.1-flash-lite | gemini、openai | 当前公开目录快照；以 API Key 权限为准 |
gemini-2.5-pro | gemini、openai | 当前公开目录快照；以 API Key 权限为准 |
gemini-2.5-flash | gemini、openai | 当前公开目录快照；以 API Key 权限为准 |
协议入口：/v1beta/models/{model}:generateContent 或 /v1/chat/completions。模型存在于目录不代表该 Key 已开通，具体工具、媒体和推理参数仍需按对应页面核对。
先用 当前 Key 模型列表 确认可用 ID。latest、preview、自定义后缀与稳定型号不能当成同一组固定参数。
选择协议
原生 generateContent 保留 candidates、parts、工具返回与 thoughtSignature；Chat 兼容返回 choices 与 delta，适合通用客户端。优先通过原生调用 PDF、音频、视频理解、搜索和代码执行。
使用青云TOP API 的 API Key：Authorization: Bearer YOUR_API_KEY。替换占位符，保留 Bearer 后的空格。无需厂商 API Key。
原生完整地址形式为 https://top.qingyuntop.ai/v1beta/models/{model}:generateContent。Chat 地址为 https://top.qingyuntop.ai/v1/chat/completions。正文统一使用 REST camelCase；Chat 的 extra_body.google 扩展另使用 snake_case。
不混用的入口
厂商 Interactions 的 input、previous_interaction_id、steps 与 generateContent 的 contents 不是同一协议。本目录提供 generateContent，不能照抄 Interactions 示例或猜测本站 /interactions。Live 实时音频与文件式理解也不同。
生图见 Gemini Image；视频生成见 Veo。视频理解只返回分析文字。